feat: v0.8.0 流语义补全 · 会话可靠 · 恢复力 — finish_reason 全链路贯通根治"思考中停止" · 2445 用例全量回归

P0 会话可靠性收口（根治"模型思考着会话就停止"）： - P0-1 finish_reason 全链路贯通：DONE 事件与 IterationStep 新增 finishReason，OpenAI 共享 SSE / Anthropic message_delta.stop_reason / Ollama done_reason 三路采集，TRACE 层弃用硬编码 'stop' 记录真值 - P0-2 空响应守卫 + 降级重试：零产出流→可重试错误走退避；思考耗尽输出预算（reasoning-only + length）→自动关闭思考降级重试一次；仍失败→OUTPUT_LENGTH_EXCEEDED 结构化错误 + 故障转移；附带根治 abort 恰逢零工具调用轮被 COMPLETED 抢占的真实缺陷 - P0-3 思考×能力×预算三对齐：DeepSeek/MiMo/Agnes/Ollama 四家 supportsThinking=false 强制不发思考参数；小输出预算告警；设置页联动提示 - P0-4 渲染层可见性：截断/空完成/友好错误三类提示，i18n 全部出层 - P0-5 回归四件套：reasoning-only 终止判定、集成级空闲超时、504 引擎重试归类、思考中 abort→USER_INTERRUPT、P4-2 强制收尾路径 FEAT-1：LLM 设置新增「最大输出上限」——Provider 支持矩阵显隐 + 模型上限钳制提示 + 超限保存警告 + llm.maxTokens 热生效 P1 修复面收口： - 渲染层三缺陷根治：后台会话回放缓冲（2000 条/4MB 有界 + agent:getReplayState + 事件总线）+ abort 双层自愈 + sendMessage 收尾兜底 + 中断卡片清扫 - 工具 abort 信号全覆盖：web_search/web_fetch/http_request/code_search/git 系列/delegate_task 全部接入引擎中断；web_search 时间预算收敛（720s→≤240s）；移除伪造 ToolExecutionContext 与死代码 - 安全：本地 Pinned CONNECT 代理根治浏览器通道 DNS rebinding（校验期 IP pinning，可注入 resolver 表测）；配置 URL 域名解析深校验（DeepCheckSoftFailure 软失败）；SSE 空 error 帧防御修复；Ollama generate/embed AbortSignal.any 合并 - 缺陷清单：UTF-16 BOM 读取、tmp 同毫秒碰撞（nanoid 后缀）、code_search JS 回退参数对称（case_sensitive/前后文独立）、list_directory include_node_modules、崩溃自愈退避（60s 窗 ≥3 次停 reload）、MemoryViewer/Sidebar i18n 收口 P2 能力演进： - 会话回收站：SCHEMA_VERSION 3 + 迁移 10（deleted_at，存在性守卫），软删除/恢复/彻底删除/30 天自动清理（启动+24h），searchMessages 聚合剔除，Sidebar 回收站面板 - 会话回放播放器：sessions:listRecordings/readRecording（白名单+目录边界+20MB 上限），SessionReplayPlayer 时间轴/步进/变速，Trace 面板入口 - electron-updater 自动更新：双轨（手动 feed 比对保留），生产环境启动静默检查 + update:status 广播 + app:updateInstall + LogsSettings UpdatePanel + builder publish 配置 - @ 文件提及：workspace.listFiles/readFileClip（边界/512KB/NUL 拒绝/MEMORY.md 保护），ChatInput Fuse 联想+键盘导航+附件管线注入 - MCP Resources/Prompts 发现：可选能力 try/catch 降级，mcp:listServerContents，MCPSettings 展开视图 - 文档对齐：内部 API 标准 HTML（Adapter 清单补 MiMo/已实现注记/STREAM_RESET/DONE.finishReason/ repetition_truncation 映射）；README v0.8.0 亮点表 P3 测试基建： - 新增 4 个测试文件：engine-stream-contract（6）、engine-stream-reliability（4：集成空闲超时/504 重试/思考中 abort/P4-2 强制收尾）、thinking-capability-gate（7）、pinned-proxy（9，含深校验 5）、session-trash（5，DB 域）、use-agent-stream hook 级（5）、agent.test 回放缓冲（2） - 契约更新：orchestrator 被中断 SubAgent success=false（abort 优先级修复语义）、SSE 空 error 帧、UTF-16 正常读取、DeepSeek 未配置思考显式 disabled、迁移矩阵 v2→3 - 弱断言根治：registry WEBP 单向断言、hooks-contracts 自比恒真、memory 空 token 补强全量验证：typecheck 0 错误 / lint 0 问题 / 系统 Node 2144 通过（301 DB 用例按 ABI 跳过）/ Electron ABI 2445/2445 全量通过 0 跳过
2026-09-05 20:06:26 +08:00
parent 99d0c54129
commit 5b9d4d19b3
78 changed files with 5128 additions and 411 deletions
@@ -11,6 +11,9 @@ import { BrowserWindow, session } from 'electron';
 import log from 'electron-log';
 // v0.7.3 P2-2: CORS Origin 回显（纯函数在 network-utils，可表测）
 import { corsAllowOrigin, extractOriginHeader } from './network-utils';
+// v0.8.0 P1-4: 浏览器通道 SSRF 根治 —— 分区流量走本地 Pinned CONNECT 代理
+import { ensurePinnedProxy } from '../../../utils/pinned-proxy';
+import { isProxyActive } from '../../../utils/network-proxy';

 /** Agent 浏览器专用 session partition — 与主应用 default session 完全隔离 */
 const AGENT_PARTITION = 'persist:metona-agent-browser';
@@ -146,6 +149,28 @@ export class BrowserWindowManager {
      // 跨域 Origin / 无 Origin 一律不加 ACAO 头 —— 保持默认同源策略阻止读取，
      // 彻底堵死"第三方页面借该分区凭据读取跨域资源"的通道。
      const agentSession = session.fromPartition(AGENT_PARTITION);
+
+      // v0.8.0 P1-4 根治: 浏览器通道 SSRF —— 分区全部流量经本地 Pinned CONNECT
+      // 代理（入口同源校验 + 校验期 IP pinning，Chromium 端 TLS/SNI 端到端不变），
+      // 关闭"入口校验通过 → Chromium 独立 DNS 解析"之间的 rebinding 残余窗口。
+      // 用户已显式配置 network.proxyUrl 时不启用（代理模式下 DNS 在代理端解析、
+      // pinning 不可实现，保持 M7 已知限制口径）；代理启动失败降级可用性优先。
+      if (!isProxyActive()) {
+        const proxyPort = await ensurePinnedProxy();
+        if (proxyPort) {
+          try {
+            await agentSession.setProxy({
+              proxyRules: `http=127.0.0.1:${proxyPort};https=127.0.0.1:${proxyPort}`,
+            });
+            log.info(
+              `[BrowserWindowManager] agent partition routed via pinned proxy :${proxyPort}`,
+            );
+          } catch (err) {
+            log.warn('[BrowserWindowManager] pinned proxy setProxy failed:', err);
+          }
+        }
+      }
+
      agentSession.webRequest.onHeadersReceived((details, callback) => {
        // Electron 类型在此版本的 OnHeadersReceivedListenerDetails 上不暴露
        // requestHeaders —— 显式声明读取面（Origin 大小写不敏感提取）
@@ -308,21 +333,48 @@ export class BrowserWindowManager {
   * 各自直接 open/evaluate 共享单例，后到者销毁前者的窗口（崩溃根因，
   * 见 openChain 注释）。排队后同一时刻只有一个抓取在使用窗口。
   *
+   * v0.8.0 P1-2: 新增可选 abort signal —— 中断时停止页面加载（webContents.stop）
+   * 并在序列各步骤间检查，终止整个 open→等待→evaluate 链。
+   *
   * @returns 提取的页面正文；失败/内容过短返回 null（调用方走失败路径）
   */
-  async fetchPageText(url: string): Promise<string | null> {
+  async fetchPageText(url: string, signal?: AbortSignal): Promise<string | null> {
    const run = async (): Promise<string | null> => {
-      await this.openInternal({ url });
-      await this.sleep(2_500);
-      const text = (await this.evaluate(`
-        (function() {
-          var clone = document.body.cloneNode(true);
-          var noise = clone.querySelectorAll('script, style, noscript, nav, header, footer, aside, iframe, svg');
-          noise.forEach(function(el) { el.remove(); });
-          return clone.innerText || '';
-        })();
-      `)) as string;
-      return text && text.trim() ? text : null;
+      const throwIfAborted = (): void => {
+        if (signal?.aborted) throw new Error('Browser fetch aborted');
+      };
+      // abort 时停止页面加载 —— loadURL/evaluate 会以 ERR_ABORTED 拒绝，
+      // 序列随之终止（窗口由单例管理，不在此销毁）
+      let onAbort: (() => void) | null = null;
+      if (signal && !signal.aborted) {
+        onAbort = () => {
+          try {
+            this.win?.webContents.stop();
+          } catch {
+            /* 窗口可能已销毁 */
+          }
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+      }
+      try {
+        throwIfAborted();
+        await this.openInternal({ url });
+        throwIfAborted();
+        await this.sleep(2_500);
+        throwIfAborted();
+        const text = (await this.evaluate(`
+          (function() {
+            var clone = document.body.cloneNode(true);
+            var noise = clone.querySelectorAll('script, style, noscript, nav, header, footer, aside, iframe, svg');
+            noise.forEach(function(el) { el.remove(); });
+            return clone.innerText || '';
+          })();
+        `)) as string;
+        throwIfAborted();
+        return text && text.trim() ? text : null;
+      } finally {
+        if (signal && onAbort) signal.removeEventListener('abort', onAbort);
+      }
    };
    this.openChain = this.openChain.then(run, run);
    return this.openChain as Promise<string | null>;