feat: v0.7.3 成本收口 · 状态一致 · 死账清理 — Prompt Cache 根治 + SSRF DNS Pinning + 87 用例扩充全量回归

P1 修复面收口: Prompt Cache 根治(日期/记忆/附件三类易变内容出 system 入用户消息前置块 user-context.ts, system 跨 run 字节级稳定; Anthropic system 块数组化 + cache_control ephemeral 断言, DeepSeek 自动缓存前缀命中 — 多轮对话输入 token 成本降数量级); 编辑重发/重新生成幽灵 Trace 双侧根治(DB truncateMessagesAfter 同步过滤 metadata.traceSteps + 前端 trimTraceStepsByAnchor 镜像, 严格小于锚点时间戳, 同毫秒等值判废); sessions:deleteMessage 死通道全链路删除(渲染层零调用 + message_count 漂移面); Ollama vision 能力门控全链路(MetonaModelInfo .supportsVision 贯穿 adapter/IPC/store/UI, model-capabilities.ts 三道判定纯函数, 未知保守放行); 记忆固化节流(consolidation-policy 纯函数: 总开关 + 内容门控 [回答>=200字符或存在成功工具调用] + 会话级 10 分钟频率窗口, 三 memory.* 配置键) P2 安全纵深: SSRF DNS Pinning 关闭 rebinding 窗口(ssrf-guard 重构 resolvePublicAddresses 单源; ssrf-dispatcher 以 undici Agent.connect.lookup 钉死校验 IP, TLS SNI 保持原域名, 一次性 dispatcher 用后即毁; 代理激活显式退化为仅入口校验); web_fetch 重写手动逐跳重定向循环(每跳先校验后连接, 替代 redirect:follow 内核跟跳的中间跳裸奔, 上限 5 跳); http_request 换用 pinned fetch; web_search 可达性预检加固(私有 URL 零请求 + 不跟跳, 3xx 视为可达); Agent 浏览器 CORS 通配收紧为 Origin 回显 + Vary: Origin; ConfirmationHook.forgetSession 会话终态清理(会话删除/abort 联动/SubAgent 终结三处接线, 根治 rememberedDecisions 泄漏) P3 架构还债: agent.enableReflection 死配置全链路接线(main→shared→引擎→ Orchestrator→设置开关, REFLECTING 状态真实可达); AgentLoopConfig.timeoutMs 死字段删除; MemoryManager.cleanupExpired 挂入健康检查周期(expires_at 回收管道真实化); buildSafeEnv 收敛 utils/safe-env.ts 单源(run_command 与 MCP stdio 共用, 终结双实现漂移); Trace 生命周期治理(metadata 只保留最近 20 个 run — keepRecentRuns 纯函数; JSONL 录制启动自动清理保留 200 个 + 设置页手动清理); SLO/健康快照可视化(app:healthSnapshot IPC + 设置页只读卡片 + 审计链一键校验) P4 能力演进: 会话标题 LLM 自动生成(TitleGenerator — 每会话幂等/并发重入复用同一 Promise/自定义标题不覆盖/失败静默回退, Sidebar 经 config:changed 实时刷新); MCP 自动重连(5s/15s/60s 退避最多 3 次, reconnecting 状态机, teardownConnection 内部拆除保留簿记 — 用户断开/开关关闭即时取消, 设置页显示第 N/3 次); 死循环检测 ABAB 乒乓模式(最近4轮 A→B→A→B 交替判定, 补齐 docs 第五章"两状态反复切换"检测契约); i18n 第三阶段(ChatInput/LLMSettings/ OnboardingWizard/MemoryViewer 主链路文案出层, zh-CN + en-US 双字典补齐) 测试: 737 → 824 用例(+87, 新增 8 个测试文件 + 扩展 3 个)。新覆盖: user-context 分组/空值收缩/拼接契约、context-builder 字节级稳定性、Anthropic cache_control 四态、consolidation-policy 九路判定矩阵、ssrf-dispatcher(pinned lookup/重定向解析/IP 校验)、forget-session 会话隔离、trace-lifecycle run 淘汰、 trace-trim 严格小于边界、safe-env 净化矩阵、mcp-reconnect 退避状态机 (fake timers)、title-generator 并发重入、SQLite 侧 truncate×TRACE 联动 (Electron ABI)。测试驱动修复: GIT_*/ 注释终止块注释、重连计数被自身重试前置断开重置(拆 teardownConnection 保留簿记)、TitleGenerator 幂等占位与并发去重的检查顺序竞态(去重先于幂等) 版本: 0.7.3; README 同步(配置表新增 agent.enableReflection/memory.*/mcp.autoReconnect) 回归: typecheck 双端 0 错误; ESLint 0/0; 系统 Node 771 通过 53 跳过 (better-sqlite3 ABI); Electron ABI 全量 824/824 零跳过
2026-08-30 09:44:43 +08:00
parent 26169b7be4
commit ebe45482b0
68 changed files with 4568 additions and 664 deletions
@@ -18,7 +18,15 @@
 */

 import { join } from 'path';
-import { appendFileSync, existsSync, mkdirSync, promises } from 'fs';
+import {
+  appendFileSync,
+  existsSync,
+  mkdirSync,
+  promises,
+  readdirSync,
+  statSync,
+  unlinkSync,
+} from 'fs';
 import log from 'electron-log';

 // ===== 事件类型 =====
@@ -265,6 +273,82 @@ export class SessionRecorder {
    return first?.filePath ?? null;
  }

+  // ===== v0.7.3 P3-3: JSONL 录制文件生命周期治理 =====
+
+  /** JSONL 录制文件名模式（仅治理本服务产出的文件） */
+  private static readonly RECORDING_NAME = /^session_.+\.jsonl$/;
+
+  /**
+   * 统计录制目录中的 JSONL 文件（设置页展示 + 清理前置确认用）。
+   * 目录不存在 / 统计失败返回零值（不抛错）。
+   */
+  getRecordingStats(): { count: number; totalBytes: number } {
+    try {
+      const logsDir = join(this.workspacePath, 'logs');
+      if (!existsSync(logsDir)) return { count: 0, totalBytes: 0 };
+      const names = readdirSync(logsDir).filter((n) => SessionRecorder.RECORDING_NAME.test(n));
+      let totalBytes = 0;
+      for (const name of names) {
+        try {
+          totalBytes += statSync(join(logsDir, name)).size;
+        } catch {
+          /* 单文件统计失败跳过 */
+        }
+      }
+      return { count: names.length, totalBytes };
+    } catch {
+      return { count: 0, totalBytes: 0 };
+    }
+  }
+
+  /**
+   * 清理旧录制文件（按修改时间保留最近 maxFiles 个，默认 200）。
+   *
+   * 背景：workspace/logs/session_*.jsonl 随使用无限累积无任何清理路径。
+   * 清理策略：mtime 降序保留前 maxFiles 个，其余删除；仅匹配本服务的
+   * session_*.jsonl 命名（用户自放文件不受影响）。启动时（main.ts）与
+   * 设置页手动清理共用本方法。
+   *
+   * @returns 实际删除的文件数
+   */
+  pruneOldRecordings(maxFiles = 200): number {
+    try {
+      const logsDir = join(this.workspacePath, 'logs');
+      if (!existsSync(logsDir)) return 0;
+      const entries = readdirSync(logsDir)
+        .filter((n) => SessionRecorder.RECORDING_NAME.test(n))
+        .map((name) => {
+          try {
+            return { name, mtime: statSync(join(logsDir, name)).mtimeMs };
+          } catch {
+            return { name, mtime: 0 };
+          }
+        })
+        .sort((a, b) => b.mtime - a.mtime);
+
+      if (entries.length <= maxFiles) return 0;
+      const toDelete = entries.slice(maxFiles);
+      let deleted = 0;
+      for (const entry of toDelete) {
+        try {
+          unlinkSync(join(logsDir, entry.name));
+          deleted++;
+        } catch {
+          /* 单文件删除失败（占用中）跳过 */
+        }
+      }
+      if (deleted > 0) {
+        log.info(
+          `[SessionRecorder] Pruned ${deleted} old recording file(s) (kept ${Math.min(maxFiles, entries.length)})`,
+        );
+      }
+      return deleted;
+    } catch (err) {
+      log.warn('[SessionRecorder] pruneOldRecordings failed:', err);
+      return 0;
+    }
+  }
+
  // ===== 私有方法 =====

  /**