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
@@ -37,7 +37,8 @@ import type { MetonaMessage } from '../../harness/types';
 function makeEngineMock(overrides: Record<string, unknown> = {}) {
  return {
    runStream: vi.fn().mockResolvedValue({
-      finalAnswer: '这是最终回答',
+      // v0.7.3 P1-5: 固化门控要求回答 >= minChars（默认 200）—— mock 回答扩到阈值之上
+      finalAnswer: '这是最终回答' + '补充细节。'.repeat(60),
      terminationReason: 'completed',
      iterations: [
        {
@@ -140,6 +141,8 @@ function makeCtx(overrides: Record<string, unknown> = {}) {
    // v0.5.1: abortByParent 返回 taskId[]（abortSession 据此清理 SubAgent pending 确认）
    orchestrator: Object.assign(new EventEmitter(), { abortByParent: vi.fn(() => []) }),
    confirmationHook: { clearPending: vi.fn() },
+    // v0.7.3 P4-1: 会话标题生成器接线（sendMessage 完成路径消费）
+    titleGenerator: { maybeGenerateTitle: vi.fn().mockResolvedValue(null) },
    reloadAdapter: vi.fn(() => true),
    ...overrides,
  };
@@ -266,10 +269,13 @@ describe('agent:sendMessage — 成功路径', () => {
        sessionId: 'sess_1',
      }),
    );
-    // 2. 引擎启动（每会话引擎）
+    // 2. 引擎启动（每会话引擎）—— v0.7.3 P1-1: 引擎收到带上下文前置块的消息副本
    expect(ctxRaw.agentEngineManager.getEngine).toHaveBeenCalledWith('sess_1');
    expect(engine.runStream).toHaveBeenCalledWith(
-      VALID_MESSAGE,
+      expect.objectContaining({
+        role: 'user',
+        content: expect.stringContaining(String(VALID_MESSAGE.content)),
+      }),
      'sess_1',
      [],
      expect.objectContaining({ roleDefinition: 'role' }),
@@ -292,7 +298,10 @@ describe('agent:sendMessage — 成功路径', () => {
    );
    expect(ctxRaw.sessionRecorder.stopRecording).toHaveBeenCalled();
    // 7. 输出验证执行
-    expect(ctxRaw.outputValidator.validate).toHaveBeenCalledWith('这是最终回答', expect.anything());
+    expect(ctxRaw.outputValidator.validate).toHaveBeenCalledWith(
+      expect.stringContaining('这是最终回答'),
+      expect.anything(),
+    );
    // 8. 摘要评估（异步触发）
    await vi.waitFor(() =>
      expect(ctxRaw.sessionSummaryService.maybeSummarize).toHaveBeenCalledWith('sess_1'),
@@ -301,7 +310,7 @@ describe('agent:sendMessage — 成功路径', () => {
    await vi.waitFor(() => expect(ctxRaw.memoryConsolidator.consolidate).toHaveBeenCalled());
  });

-  it('注入相关记忆到 System Prompt 动态区', async () => {
+  it('注入相关记忆到用户消息上下文前置块（P1-1：system 保持缓存稳定）', async () => {
    const { ctx, ctxRaw } = makeCtx({
      memoryManager: {
        search: vi.fn(() => [
@@ -321,9 +330,16 @@ describe('agent:sendMessage — 成功路径', () => {

    await handler(null, VALID_MESSAGE, 'sess_1');
    expect(ctxRaw.memoryManager.search).toHaveBeenCalled();
-    // 引擎收到的 systemPrompt 应包含记忆块
+    // P1-1: 记忆注入迁移到首条 user 消息前置块（system 跨 run 字节稳定 → 缓存命中）
    const prompt = engine_runStreamPrompt(ctxRaw);
-    expect(prompt.dynamicReminders).toContain('用户偏好深色主题');
+    expect(prompt.dynamicReminders).not.toContain('用户偏好深色主题');
+    const userMessage = engine_runStreamUserMessage(ctxRaw);
+    expect(userMessage.content).toContain('[Contextual information for this message');
+    expect(userMessage.content).toContain('用户偏好深色主题');
+    // DB 持久化仍使用原始干净内容（前置块只存在于引擎副本）
+    expect(ctxRaw.sessionService.saveMessage).toHaveBeenCalledWith(
+      expect.objectContaining({ content: VALID_MESSAGE.content }),
+    );
  });

  it('验证发现 warning 级问题时广播 VALIDATION 流事件', async () => {
@@ -406,6 +422,14 @@ describe('agent:abortSession — 中断编排', () => {
  });
 });

+/** 从 runStream 调用参数中提取首条用户消息（P1-1 前置块断言用） */
+function engine_runStreamUserMessage(ctxRaw: Record<string, unknown>): { content: string } {
+  const engine = (ctxRaw.agentEngineManager as unknown as { getEngine: Mock }).getEngine() as {
+    runStream: Mock;
+  };
+  return engine.runStream.mock.calls[0][0];
+}
+
 /** 从 runStream 调用参数中提取 systemPrompt */
 function engine_runStreamPrompt(ctxRaw: Record<string, unknown>): {
  roleDefinition: string;