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
@@ -12,10 +12,12 @@
 * @see standard/开发规范.md — 使用 fs/path 内置模块（非第三方库）
 */

-import { join } from 'path';
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join, resolve, sep } from 'path';
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, statSync } from 'fs';
 import { app } from 'electron';
 import log from 'electron-log';
+// v0.8.0 P2-4: @ 提及文本片段的编码检测（与 read_file 同源）
+import { decodeBufferWithDetection } from '../harness/tools/built-in/file-guard';

 // ===== 类型定义 =====

@@ -138,6 +140,112 @@ export class WorkspaceService {
    return { ...this.files };
  }

+  // ===== v0.8.0 P2-4: @ 文件提及数据源 =====
+
+  /** 列出目录树时的噪声目录（依赖产物/版本库/运行时数据，永不进入提及索引） */
+  private static readonly MENTION_SKIP_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'logs',
+    '.metona',
+    'dist',
+    'dist-electron',
+    'out',
+    'build',
+    'release',
+  ]);
+
+  /**
+   * 工作空间文件名索引（@ 文件提及联想数据源）。
+   *
+   * 同步递归收集相对路径；跳过 MENTION_SKIP_DIRS 与隐藏目录；深度上限 8；
+   * 数量上限 maxFiles（防超大工作空间拖慢主进程）。FileGuard 的 MEMORY.md
+   * 保护不适用于"文件名索引"（只列名字不读内容）。
+   */
+  listFiles(maxFiles = 2000): string[] {
+    const out: string[] = [];
+    const walk = (dir: string, rel: string, depth: number): void => {
+      if (out.length >= maxFiles || depth > 8) return;
+      let entries: import('fs').Dirent[];
+      try {
+        entries = readdirSync(dir, { withFileTypes: true });
+      } catch {
+        return;
+      }
+      for (const entry of entries) {
+        if (out.length >= maxFiles) return;
+        if (entry.name.startsWith('.')) continue;
+        if (entry.isDirectory() && WorkspaceService.MENTION_SKIP_DIRS.has(entry.name)) continue;
+        const relName = rel ? `${rel}/${entry.name}` : entry.name;
+        if (entry.isFile()) {
+          out.push(relName);
+        } else if (entry.isDirectory()) {
+          walk(join(dir, entry.name), relName, depth + 1);
+        }
+      }
+    };
+    walk(this.workspacePath, '', 0);
+    return out;
+  }
+
+  /**
+   * 读取 @ 提及文件的文本片段（≤ maxBytes，默认 512KB，二进制拒绝）。
+   *
+   * 安全：路径 resolve 后必须位于工作空间内；根目录 MEMORY.md 与工具读取
+   * 同口径保护（isProtectedWorkspaceFile）；文本判定复用 file-guard 的
+   * decodeBufferWithDetection（NUL 启发式在 BOM 之后仍命中则拒绝）。
+   */
+  readFileClip(
+    relPath: string,
+    maxBytes = 512 * 1024,
+  ): {
+    success: boolean;
+    error?: string;
+    name?: string;
+    content?: string;
+    truncated?: boolean;
+    size?: number;
+  } {
+    try {
+      const resolved = resolve(this.workspacePath, relPath);
+      if (resolved !== this.workspacePath && !resolved.startsWith(this.workspacePath + sep)) {
+        return { success: false, error: 'Path escapes workspace' };
+      }
+      if (!existsSync(resolved) || !statSync(resolved).isFile()) {
+        return { success: false, error: 'File not found' };
+      }
+      // 根目录 MEMORY.md 保护（与 read_file 工具同口径）
+      if (
+        resolve(resolved).toLowerCase() === resolve(this.workspacePath, 'MEMORY.md').toLowerCase()
+      ) {
+        return { success: false, error: 'Access to workspace root MEMORY.md is protected' };
+      }
+      const size = statSync(resolved).size;
+      const buf = readFileSync(resolved);
+      const head = buf.subarray(0, Math.min(buf.length, 8192));
+      // 二进制判定：非 UTF-16 BOM 前缀下含 NUL 字节 → 拒绝（文本附件语义）
+      const isUtf16Bom =
+        (head[0] === 0xff && head[1] === 0xfe) || (head[0] === 0xfe && head[1] === 0xff);
+      if (!isUtf16Bom) {
+        for (const b of head) {
+          if (b === 0)
+            return { success: false, error: 'Binary file is not supported for @ mention' };
+        }
+      }
+      const clipped = buf.length > maxBytes ? buf.subarray(0, maxBytes) : buf;
+      const { content } = decodeBufferWithDetection(clipped);
+      return {
+        success: true,
+        name: relPath,
+        content,
+        truncated: buf.length > maxBytes,
+        size,
+      };
+    } catch (err) {
+      return { success: false, error: (err as Error).message };
+    }
+  }
+
  /**
   * 更新 MEMORY.md 的最后更新时间戳
   */