feat: v0.7.4 时序语义修正 · 防线实效补漏 · 全量测试翻倍 — 2406 用例 + jsdom 组件测试全量回归

P1 修复面收口: - 超时三态区分（aborted→USER_INTERRUPT / ETIMEDOUT→TIMEOUT / 其余→ERROR），根治"真实网络超时被误报为用户中断" - 流空闲超时统一（SSE/Ollama/Anthropic 读循环 60s 无数据抛 504 进重试通道） - 同会话并发 sendMessage 防重入（isRunning 守卫）+ 会话存在性预检 + 前置调用移入 try（ERROR+DONE 双事件保证，根治 isStreaming 假死） - 清空审计后 resetChainCache（根治 verifyChain 误报 TAMPERED） - DONE 不再提前清理 TRACE（TERMINATED 统一收尾，补全最终迭代录制） - IME 合成回车不发送（普通 Enter + Cmd/Ctrl+Enter 双分支）+ handleSend 闭包修复 P2 安全纵深: - preload 移除原始 electronAPI 暴露（渲染层零使用，关掉 XSS invoke 任意通道单点风险） - CORS 同源回显根治（仅当前浏览页面 Origin，did-navigate 同步） - MEMORY.md 命令保护正则扩展（括号/$/反引号/< 重定向边界 + 前导路径） - write_file append TOCTOU 统一（open 后 realpath 校验，新文件分支补漏） - 敏感键归一化（authKey 驼峰/连字符命中）+ MCP headers 鉴权值加密落库 - ReDoS 检测共享化（search_files/file_editor 统一拦截） - run_tests/lint_code 升风险 + 需确认 + npx --no-install（执行边界对齐 run_command） - MCP/SearXNG/llm.baseURL/updateFeedUrl 配置类 URL 高危目标校验（IPv6 去括号 + 十六进制映射解析 + 尾点剥离） P3 架构还债: - temperature/maxTokens 热生效（引擎/编排器/SubAgent 三处接线）+ setBatch 单事务落盘 - SessionRecorder flush 竞态根治（flushPromise 等待 + 超限内联落盘 + stopRecording async） - 内存收口（lastConsolidationBySession LRU / subTraces 清理 / 会话删除 disposeEngine） - i18n 全量收口（28 组件 + 353 key 双字典，状态标签改渲染时函数） - 死代码清理（updateTraceStep/HEADER_HEIGHT/void preA/失实注释） - 斜杠菜单 MUI 化 + 删除逻辑收敛 resetSessionState + Blob URL 统一释放 + 用户消息"仅保存"落库（saveMessage 透传前端 id 修复 id 错位） P4 能力演进: - 死循环检测拆分（驻留前置 + 乒乓后置带进度信号，合法交替不误报） - run-lock 30s 超时强制 abort（旧 run 卡死不无限排队） - RETRY 双通道 stream_reset（前端按 run 归属精确清空，根治重试文本重复） - FTS5 trigram 中文子串搜索（迁移 9 版本化 SCHEMA_VERSION=2，≤2 字符 LIKE 回退） - getContextWindow 兜底 1M→128K（未知模型防 413）测试: - 855 → 2406 用例（+1551，2.8 倍）：服务层 +325（含 MemoryManager 51 新用例）、工具实体 +483、IPC/适配器 +390（含 OpenAI/Anthropic/Ollama 独立套件）、纯函数表格化 +330；引入 jsdom + @testing-library（14 组件测试文件 249 用例） - 修复 R1（saveMessage id 透传）/ R2（stream_reset 精确归属）两个回归缺陷 - 遗留低危项清零：git-tools 顺序耦合 / web-fetch 真实时间退避 / slo 内存断言 / mcp-security 多余 skipIf / deepseek-balance 命名误导 / 组件 mock 注入脆弱性版本: 0.7.4; README 同步（工具风险表/版本徽章）; 依赖: 移除 @electron-toolkit/preload，新增 jsdom/@testing-library（devDependencies 不打包）回归: typecheck 双端 0 错误; ESLint 0/0; Electron ABI 全量 2406/2406 零跳过; 系统 Node 2110 通过 296 跳过（better-sqlite3 ABI）
2026-08-30 19:19:07 +08:00
parent ebe45482b0
commit 99d0c54129
137 changed files with 25190 additions and 1792 deletions
@@ -14,7 +14,12 @@
 import { ipcMain } from 'electron';
 import type { IPCContext } from './context';
 import { broadcast } from './context';
-import type { MetonaMessage, MetonaStreamEvent, MetonaError } from '../harness/types';
+import type {
+  MetonaMessage,
+  MetonaStreamEvent,
+  MetonaError,
+  MetonaSystemPrompt,
+} from '../harness/types';
 import { MetonaErrorCode, MetonaStreamEventType } from '../harness/types';
 import { estimateMessagesTokens } from '../harness/utils/token-estimator';
 import { DeepSeekAdapter } from '../harness/adapters/deepseek.adapter';
@@ -80,7 +85,20 @@ export function registerAgentHandlers(ctx: IPCContext): void {
  const iterationTraces = new Map<string, IterationTrace>();

  // v0.7.3 P1-5: 会话级记忆固化时间戳（consolidation-policy 频率门控的状态持有方）
+  // v0.7.4 P3-5: LRU 化 —— 旧实现每会话一条永不清除，长期运行后无界增长。
+  // 容量 200：超过后淘汰最旧的（固化频率窗口 10 分钟，200 个会话远超实际并发上限）。
  const lastConsolidationBySession = new Map<string, number>();
+  const MAX_CONSOLIDATION_TRACKED = 200;
+  const touchConsolidation = (sessionId: string): number => {
+    const now = Date.now();
+    lastConsolidationBySession.set(sessionId, now);
+    if (lastConsolidationBySession.size > MAX_CONSOLIDATION_TRACKED) {
+      // 淘汰最旧（Map 迭代顺序 = 插入顺序）
+      const oldestKey = lastConsolidationBySession.keys().next().value as string | undefined;
+      if (oldestKey !== undefined) lastConsolidationBySession.delete(oldestKey);
+    }
+    return now;
+  };

  const flushThrottle = (sessionId: string): void => {
    const st = throttleStates.get(sessionId);
@@ -200,7 +218,12 @@ export function registerAgentHandlers(ctx: IPCContext): void {
        }
        break;
      case MetonaStreamEventType.DONE:
-        cleanupSessionState(sessionId);
+        // v0.7.4 P1-6: DONE 不再执行 cleanupSessionState —— 引擎的 finish() 顺序是
+        // 先发 DONE 再发 TERMINATED stateChange，而 TERMINATED 分支（stateChange 监听）
+        // 需要读取 iterationTraces 补记最终迭代的 iteration_end/llm_response。
+        // 旧实现在 DONE 时删除 iterationTraces → 最终迭代的 TRACE 完整性缺失。
+        // 现仅在 TERMINATED 分支统一收尾（flush throttle buffer + 删 iterationTraces）。
+        // 注意：此处仍需转发 DONE 事件到前端（下方 broadcast 统一执行）。
        break;
      default:
        break;
@@ -385,13 +408,42 @@ export function registerAgentHandlers(ctx: IPCContext): void {
      }
      log.info('[AGENT] sendMessage:', sessionId, (userMessage.content ?? '').slice(0, 80));

+      // v0.7.4 P1-3: 同会话并发防重入 —— 同一 sessionId 的第二个 invoke 在第一个 run
+      // 未结束时到达，会让同一引擎被并行 runStream（工具副作用并发执行 / 内部 run-lock
+      // 排队 30s 后强制 abort 旧 run，用户看到"上一次操作未完成"）。此处直接拒绝并
+      // 广播明确错误事件，前端 isStreaming 正常收尾。
+      if (agentEngineManager.isRunning(sessionId)) {
+        const busyMsg = '该会话正在执行任务，请等待完成或先中断后再发送';
+        log.warn(`[AGENT] sendMessage rejected: session ${sessionId} is already running`);
+        sendErrorEvent(busyMsg, sessionId);
+        return { success: false, error: busyMsg };
+      }
+
+      // v0.7.4 P1-4: 会话存在性预检 —— sessionId 指向已删除会话时，后续 saveMessage
+      // 会因 FK 约束（foreign_keys=ON）抛错，而旧实现该调用在 try 块之外，invoke 直接
+      // reject：不发 ERROR/DONE 事件、不 stopRecording，前端 isStreaming 永久卡死。
+      // 此处提前校验并走统一的 sendErrorEvent + stopRecording 收尾路径。
+      const sessionExists = sessionService.getSession(sessionId) != null;
+      if (!sessionExists) {
+        const missingMsg = '会话不存在或已被删除，请刷新后重试';
+        log.warn(`[AGENT] sendMessage rejected: session ${sessionId} not found`);
+        sendErrorEvent(missingMsg, sessionId);
+        await sessionRecorder.stopRecording(sessionId, {
+          totalIterations: 0,
+          totalTokens: 0,
+          durationMs: 0,
+          terminationReason: 'error',
+        });
+        return { success: false, error: missingMsg };
+      }
+
      // 发送消息前确保 Adapter 使用最新配置（失败则中止，防止用旧 Provider 的 adapter 发送）
      if (!ctx.reloadAdapter()) {
        const errorMsg =
          'Adapter 加载失败，请检查 LLM 配置（Provider、API Key、Base URL、Model 是否完整）';
        log.error('[AGENT]', errorMsg);
        sendErrorEvent(errorMsg, sessionId);
-        sessionRecorder.stopRecording(sessionId, {
+        await sessionRecorder.stopRecording(sessionId, {
          totalIterations: 0,
          totalTokens: 0,
          durationMs: 0,
@@ -404,73 +456,108 @@ export function registerAgentHandlers(ctx: IPCContext): void {
      sessionRecorder.startRecording(sessionId);
      auditService.logSessionStart(sessionId);

-      // 保存用户消息到数据库
-      sessionService.saveMessage({
-        sessionId,
-        role: 'user',
-        content: userMessage.content,
-        attachments: (userMessage as MetonaMessage & { attachments?: unknown[] }).attachments,
-      });
-
-      // P2-11: 分层加载历史——存在滚动摘要时只加载 [摘要 + 近期原文]
-      const history = sessionSummaryService.buildHistoryMessages(sessionId).slice(0, -1);
-
-      // 从工作空间文件构建 System Prompt
-      const workspaceFiles = workspaceService.getFiles();
-      const systemPrompt = contextBuilder.buildSystemPrompt(
-        workspaceFiles,
-        workspaceService.getPath(),
-      );
-
-      // v0.3.18 修复: SOUL.md 为空或不存在时降级到默认身份，向前端发 toast 提示用户
-      if (contextBuilder.isUsingFallbackRole()) {
-        broadcast('toast:show', {
-          type: 'info',
-          message:
-            '未找到 SOUL.md 或内容为空，已使用默认 Metona 身份。可在工作空间根目录创建 SOUL.md 自定义 Agent 人格',
-        });
-      }
-
-      // 检索与用户消息相关的记忆 + 附件元信息 → 构建用户消息上下文前置块。
-      // v0.7.3 P1-1 根治: 记忆注入与附件提示此前追加进 systemPrompt.dynamicReminders，
-      // 每条消息都改变 system 字节 → 跨 run 缓存全 miss。现随首条 user 消息注入
-      // （LLM 语义等价），system prompt 保持跨 run 字节级稳定。
+      // v0.7.4 P1-4: 以下数据准备（保存用户消息/加载历史/构建 System Prompt/记忆检索）
+      // 全部移入 try 块 —— 旧实现这些调用在 try 之外，DB 或文件系统抛错时 invoke 直接
+      // reject（不发 ERROR/DONE 事件、不 stopRecording，前端 isStreaming 永久卡死）。
+      // 统一由下方 catch 收尾：ERROR + DONE 双事件 + 审计 + 录制终止。
+      let history: MetonaMessage[] = [];
+      let systemPrompt: MetonaSystemPrompt | null = null;
      let userContextPrefix = '';
+      let engineUserMessage: MetonaMessage;
+
      try {
-        const memories = memoryManager.search(userMessage.content, { topK: 5, minImportance: 0.3 });
-        const attachments = (
-          userMessage as MetonaMessage & {
-            attachments?: Array<{ name: string; type: string; truncated?: boolean }>;
-          }
-        ).attachments;
-        userContextPrefix = buildUserContextPrefix({
-          now: Date.now(),
-          memories,
-          attachments: Array.isArray(attachments) ? attachments : [],
-          timezoneLabel: buildTimezoneLabel(),
+        // 保存用户消息到数据库
+        // v0.7.4 回归修复: 透传前端消息 id（ChatMessage.id 由 genMsgId 生成）——
+        // 否则 DB 用 msg_<nanoid> 生成不同 id，用户对刚发送消息"仅保存"
+        // （updateMessageContent 按 id 匹配）会 0 行更新失败。
+        sessionService.saveMessage({
+          sessionId,
+          role: 'user',
+          content: userMessage.content,
+          attachments: (userMessage as MetonaMessage & { attachments?: unknown[] }).attachments,
+          id: (userMessage as MetonaMessage & { id?: string }).id,
        });
-        if (memories.length > 0) {
-          log.debug(`[AGENT] Injected ${memories.length} memories into user context prefix`);
+
+        // P2-11: 分层加载历史——存在滚动摘要时只加载 [摘要 + 近期原文]
+        history = sessionSummaryService.buildHistoryMessages(sessionId).slice(0, -1);
+
+        // 从工作空间文件构建 System Prompt
+        const workspaceFiles = workspaceService.getFiles();
+        systemPrompt = contextBuilder.buildSystemPrompt(workspaceFiles, workspaceService.getPath());
+
+        // v0.3.18 修复: SOUL.md 为空或不存在时降级到默认身份，向前端发 toast 提示用户
+        if (contextBuilder.isUsingFallbackRole()) {
+          broadcast('toast:show', {
+            type: 'info',
+            message:
+              '未找到 SOUL.md 或内容为空，已使用默认 Metona 身份。可在工作空间根目录创建 SOUL.md 自定义 Agent 人格',
+          });
        }
+
+        // 检索与用户消息相关的记忆 + 附件元信息 → 构建用户消息上下文前置块。
+        // v0.7.3 P1-1 根治: 记忆注入与附件提示此前追加进 systemPrompt.dynamicReminders，
+        // 每条消息都改变 system 字节 → 跨 run 缓存全 miss。现随首条 user 消息注入
+        // （LLM 语义等价），system prompt 保持跨 run 字节级稳定。
+        try {
+          const memories = memoryManager.search(userMessage.content, {
+            topK: 5,
+            minImportance: 0.3,
+          });
+          const attachments = (
+            userMessage as MetonaMessage & {
+              attachments?: Array<{ name: string; type: string; truncated?: boolean }>;
+            }
+          ).attachments;
+          userContextPrefix = buildUserContextPrefix({
+            now: Date.now(),
+            memories,
+            attachments: Array.isArray(attachments) ? attachments : [],
+            timezoneLabel: buildTimezoneLabel(),
+          });
+          if (memories.length > 0) {
+            log.debug(`[AGENT] Injected ${memories.length} memories into user context prefix`);
+          }
+        } catch (err) {
+          log.warn('[AGENT] Memory retrieval failed, proceeding without memories:', err);
+          // 记忆检索失败时前置块退化为仅含日期时间（附件提示随之丢失可接受——
+          // 主进程附件提示是辅助语义，附件内容本体仍在消息中）
+          userContextPrefix = buildUserContextPrefix({
+            now: Date.now(),
+            memories: [],
+            attachments: [],
+            timezoneLabel: buildTimezoneLabel(),
+          });
+        }
+
+        // 构建发送给引擎的用户消息副本 —— 前置块只存在于该副本：
+        // DB 持久化（上方 saveMessage 已用原始内容）、前端展示、记忆固化、
+        // 注入检测均使用原始干净内容，互不污染。
+        engineUserMessage = {
+          ...userMessage,
+          content: withUserContextPrefix(userContextPrefix, userMessage.content),
+        };
      } catch (err) {
-        log.warn('[AGENT] Memory retrieval failed, proceeding without memories:', err);
-        // 记忆检索失败时前置块退化为仅含日期时间（附件提示随之丢失可接受——
-        // 主进程附件提示是辅助语义，附件内容本体仍在消息中）
-        userContextPrefix = buildUserContextPrefix({
-          now: Date.now(),
-          memories: [],
-          attachments: [],
-          timezoneLabel: buildTimezoneLabel(),
+        log.error('[AGENT] Failed to prepare message context:', err);
+        const prepErr = (err as Error).message;
+        broadcast('agent:streamEvent', {
+          type: MetonaStreamEventType.ERROR,
+          requestId: '',
+          sessionId,
+          iteration: 0,
+          seq: 0,
+          timestamp: Date.now(),
+          error: { code: MetonaErrorCode.UNKNOWN, message: prepErr, retryable: false },
+        } satisfies MetonaStreamEvent);
+        await sessionRecorder.stopRecording(sessionId, {
+          totalIterations: 0,
+          totalTokens: 0,
+          durationMs: 0,
+          terminationReason: 'error',
        });
+        return { success: false, error: prepErr };
      }

-      // 构建发送给引擎的用户消息副本 —— 前置块只存在于该副本：
-      // DB 持久化（上方 saveMessage 已用原始内容）、前端展示、记忆固化、
-      // 注入检测均使用原始干净内容，互不污染。
-      const engineUserMessage: MetonaMessage = {
-        ...userMessage,
-        content: withUserContextPrefix(userContextPrefix, userMessage.content),
-      };
+      // 提示注入检测在 try 内执行（需 systemPrompt 已构建，与引擎运行同域）

      try {
        // 提示注入检测（安全模块）
@@ -487,7 +574,7 @@ export function registerAgentHandlers(ctx: IPCContext): void {
              `Message blocked by prompt injection defense: ${injectionResult.recommendation}`,
              sessionId,
            );
-            sessionRecorder.stopRecording(sessionId, {
+            await sessionRecorder.stopRecording(sessionId, {
              totalIterations: 0,
              totalTokens: 0,
              durationMs: 0,
@@ -653,7 +740,7 @@ export function registerAgentHandlers(ctx: IPCContext): void {
            .consolidate(userMessage.content, output.finalAnswer, output.iterations)
            .then((result) => {
              if (result.appended > 0) {
-                lastConsolidationBySession.set(sessionId, Date.now());
+                touchConsolidation(sessionId);
                log.info(
                  `[AGENT] Memory consolidated: ${result.appended} entries appended to MEMORY.md`,
                );
@@ -693,7 +780,7 @@ export function registerAgentHandlers(ctx: IPCContext): void {
          durationMs: output.durationMs,
          terminationReason: output.terminationReason,
        });
-        sessionRecorder.stopRecording(sessionId, {
+        await sessionRecorder.stopRecording(sessionId, {
          totalIterations: output.iterations.length,
          totalTokens: output.totalTokenUsage.totalTokens,
          durationMs: output.durationMs,
@@ -724,7 +811,7 @@ export function registerAgentHandlers(ctx: IPCContext): void {
        });

        // TRACE 层：停止录制
-        sessionRecorder.stopRecording(sessionId, {
+        await sessionRecorder.stopRecording(sessionId, {
          totalIterations: 0,
          totalTokens: 0,
          durationMs: 0,
@@ -876,8 +963,19 @@ export function registerAgentHandlers(ctx: IPCContext): void {
    confirmationHook.clearPending(sessionId);
    // v0.5.1: 被中止 SubAgent 的 pending 确认一并拒绝（含 SubAgent 递归派生的孙任务）
    // v0.7.3 P2-3: 被中止的 SubAgent 是会话终态 —— 用 forgetSession 连决策记忆一并清理
+    // v0.7.4 P3-5: 被中止 SubAgent 的 TRACE 状态（subTraces/subMeta）一并清理 ——
+    // 旧实现只覆盖 taskCompleted/taskError 路径，被 abort 的 SubAgent 残留 Map 条目
    for (const taskId of abortedTaskIds) {
      confirmationHook.forgetSession(taskId);
+      subTraces.delete(taskId);
+      subMeta.delete(taskId);
+      // 中止的 SubAgent 录制文件也收尾（TRACE 完整性：标记为中断终止）
+      await sessionRecorder.stopRecording(taskId, {
+        totalIterations: 0,
+        totalTokens: 0,
+        durationMs: 0,
+        terminationReason: 'user_interrupt',
+      });
    }

    // TOOL 层：记录中断
@@ -910,13 +1008,13 @@ export function registerAgentHandlers(ctx: IPCContext): void {
  }
  const subTraces = new Map<string, SubTraceState>();

-  const finishSubTrace = (
+  const finishSubTrace = async (
    taskId: string,
    reason: string,
    durationMs: number,
    iterations: number,
-  ): void => {
-    sessionRecorder.stopRecording(taskId, {
+  ): Promise<void> => {
+    await sessionRecorder.stopRecording(taskId, {
      totalIterations: iterations,
      totalTokens: 0,
      durationMs,
@@ -975,7 +1073,7 @@ export function registerAgentHandlers(ctx: IPCContext): void {
        durationMs: r.durationMs,
        iterations: r.iterations,
      });
-      finishSubTrace(r.taskId, r.success ? 'completed' : 'error', r.durationMs, r.iterations);
+      void finishSubTrace(r.taskId, r.success ? 'completed' : 'error', r.durationMs, r.iterations);
    },
  );

@@ -991,7 +1089,7 @@ export function registerAgentHandlers(ctx: IPCContext): void {
        depth: meta?.depth ?? 1,
        error: d.error,
      });
-      finishSubTrace(d.taskId, 'error', 0, 0);
+      void finishSubTrace(d.taskId, 'error', 0, 0);
    },
  );