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 跳过

electron/ipc/agent.ts

@@ -59,8 +59,43 @@ interface IterationTrace {
   text: string;
   usage?: { input: number; output: number; total: number };
   responded: boolean; // 本轮 llm_response 是否已记录（PARSING 与下一轮 THINKING 去重）
+  /**
+   * v0.8.0 P0-1: 本轮 Provider 原生停止原因（DONE 事件携带的 finishReason）。
+   * v0.7.4 及之前 recordLLMResponse 硬编码 'stop'，length 截断在 TRACE 文件中
+   * 不可归因；现记录真值，缺省回退 'stop'。
+   */
+  finishReason?: string;
 }
 
+/**
+ * v0.8.0 P1-1a: 单会话的流式回放缓冲 —— 渲染层切走会话期间，事件管道仍照常
+ * 投递（按会话隔离被渲染层准入拒绝），此缓冲按序保存 streamEvent + stateChange
+ * 双通道事件；用户切回会话时经 agent:getReplayState 拉取并灌入渲染层事件总线，
+ * 实现"后台会话运行内容不丢失"。
+ *
+ * 有界设计：单会话上限 MAX_REPLAY_EVENTS 条 / MAX_REPLAY_BYTES 字节，溢出丢弃
+ * 最旧并置 truncated 标记；TERMINATED 后保留（供"完成后切回"看到最终内容），
+ * 下一次 run 启动（INIT stateChange）时清空重建。
+ */
+interface ReplayEntry {
+  channel: 'streamEvent' | 'stateChange';
+  payload: unknown;
+  ts: number;
+}
+
+interface ReplayBuffer {
+  events: ReplayEntry[];
+  bytes: number;
+  truncated: boolean;
+  /** 最近一次观察到的 runId（供渲染层回放后对齐 run 守卫） */
+  runId?: string;
+  terminated: boolean;
+}
+
+const MAX_REPLAY_EVENTS = 2000;
+const MAX_REPLAY_BYTES = 4 * 1024 * 1024;
+const MAX_REPLAY_SESSIONS = 50;
+
 export function registerAgentHandlers(ctx: IPCContext): void {
   const {
     agentEngineManager,
@@ -83,6 +118,54 @@ export function registerAgentHandlers(ctx: IPCContext): void {
   // ===== 常驻事件管道：text_delta 按会话节流（F8） =====
   const throttleStates = new Map<string, ThrottleState>();
   const iterationTraces = new Map<string, IterationTrace>();
+  // v0.8.0 P1-1a: 每会话流式回放缓冲（后台会话内容恢复）
+  const replayBuffers = new Map<string, ReplayBuffer>();
+
+  /** 追加一条事件到会话回放缓冲（有界：条数/字节双上限，溢出丢最旧） */
+  const appendReplay = (sessionId: string, entry: ReplayEntry): void => {
+    let buf = replayBuffers.get(sessionId);
+    if (!buf) {
+      // 会话数上限保护：超出后淘汰最早的缓冲（Map 迭代序 = 插入序）
+      if (replayBuffers.size >= MAX_REPLAY_SESSIONS) {
+        const oldest = replayBuffers.keys().next().value as string | undefined;
+        if (oldest !== undefined) replayBuffers.delete(oldest);
+      }
+      buf = { events: [], bytes: 0, truncated: false, terminated: false };
+      replayBuffers.set(sessionId, buf);
+    }
+    // run 启动（INIT）后旧 run 缓冲作废 —— 由 stateChange 监听器在 INIT 时清空，
+    // 此处仅在 terminated 缓冲上遇到新内容时兜底重置（正常路径 INIT 先行）
+    if (buf.terminated) {
+      replayBuffers.delete(sessionId);
+      buf = { events: [], bytes: 0, truncated: false, terminated: false };
+      replayBuffers.set(sessionId, buf);
+    }
+    let size = 0;
+    try {
+      size = JSON.stringify(entry.payload).length;
+    } catch {
+      size = 256; // 序列化失败按保守值计入
+    }
+    buf.events.push(entry);
+    buf.bytes += size;
+    while (
+      buf.events.length > MAX_REPLAY_EVENTS ||
+      (buf.bytes > MAX_REPLAY_BYTES && buf.events.length > 1)
+    ) {
+      const dropped = buf.events.shift();
+      buf.truncated = true;
+      if (dropped) {
+        try {
+          buf.bytes -= JSON.stringify(dropped.payload).length;
+        } catch {
+          buf.bytes -= 256;
+        }
+      }
+    }
+    // 记录 runId（首个携带者）
+    const payload = entry.payload as { runId?: string } | null;
+    if (!buf.runId && payload?.runId) buf.runId = payload.runId;
+  };
 
   // v0.7.3 P1-5: 会话级记忆固化时间戳（consolidation-policy 频率门控的状态持有方）
   // v0.7.4 P3-5: LRU 化 —— 旧实现每会话一条永不清除，长期运行后无界增长。
@@ -136,6 +219,9 @@ export function registerAgentHandlers(ctx: IPCContext): void {
   agentEngineManager.on('streamEvent', (event: MetonaStreamEvent) => {
     if (!event.sessionId) return;
     const sessionId = event.sessionId;
+    // v0.8.0 P1-1a: 全量事件进入回放缓冲（含 text_delta —— 必须在节流分支
+    // return 之前入队，否则切回会话时已缓冲的正文增量缺失）
+    appendReplay(sessionId, { channel: 'streamEvent', payload: event, ts: Date.now() });
     const trace = iterationTraces.get(sessionId);
 
     // F8: text_delta 聚合，其他事件立即转发（先 flush 保证顺序）
@@ -224,6 +310,8 @@ export function registerAgentHandlers(ctx: IPCContext): void {
         // 旧实现在 DONE 时删除 iterationTraces → 最终迭代的 TRACE 完整性缺失。
         // 现仅在 TERMINATED 分支统一收尾（flush throttle buffer + 删 iterationTraces）。
         // 注意：此处仍需转发 DONE 事件到前端（下方 broadcast 统一执行）。
+        // v0.8.0 P0-1: 捕获 Provider 原生停止原因（recordLLMResponse 记录真值）
+        if (trace && event.finishReason) trace.finishReason = event.finishReason;
         break;
       default:
         break;
@@ -247,6 +335,20 @@ export function registerAgentHandlers(ctx: IPCContext): void {
       broadcast('agent:stateChange', data);
 
       const sessionId = data.sessionId;
+      // v0.8.0 P1-1a: stateChange 事件进入回放缓冲。INIT（run 启动）清空上一 run
+      // 的缓冲；TERMINATED 置终态标记（保留缓冲供"完成后切回"回放最终内容）。
+      if (sessionId) {
+        const stateRaw = data.state ?? data.current ?? '';
+        if (stateRaw === 'INIT') {
+          replayBuffers.delete(sessionId);
+        } else {
+          appendReplay(sessionId, { channel: 'stateChange', payload: data, ts: Date.now() });
+          if (stateRaw === 'TERMINATED') {
+            const buf = replayBuffers.get(sessionId);
+            if (buf) buf.terminated = true;
+          }
+        }
+      }
       if (!sessionId || data.iteration == null) return;
       const stateValue = data.state ?? data.current ?? '';
       const trace = iterationTraces.get(sessionId);
@@ -258,7 +360,8 @@ export function registerAgentHandlers(ctx: IPCContext): void {
             sessionId,
             iteration: trace.iteration,
             content: trace.text,
-            finishReason: 'stop',
+            // v0.8.0 P0-1: 记录真实停止原因（旧实现硬编码 'stop'，length 截断不可归因）
+            finishReason: trace.finishReason ?? 'stop',
             tokenUsage: trace.usage ?? { input: 0, output: 0, total: 0 },
           });
         }
@@ -298,7 +401,8 @@ export function registerAgentHandlers(ctx: IPCContext): void {
           sessionId,
           iteration: trace.iteration,
           content: trace.text,
-          finishReason: 'stop',
+          // v0.8.0 P0-1: 记录真实停止原因（旧实现硬编码 'stop'，length 截断不可归因）
+          finishReason: trace.finishReason ?? 'stop',
           tokenUsage: trace.usage ?? { input: 0, output: 0, total: 0 },
         });
       }
@@ -991,6 +1095,27 @@ export function registerAgentHandlers(ctx: IPCContext): void {
     return { success: true };
   });
 
+  // ===== v0.8.0 P1-1a: 后台会话流回放（切回会话时恢复运行内容） =====
+  // 渲染层 setCurrentSession 检测到目标会话在 sessionRunStates 中运行（或刚结束）
+  // 时调用本通道：返回回放缓冲中按序保存的 streamEvent + stateChange 事件，
+  // 渲染层经事件总线灌入 useAgentStream 管线重建消息/Trace 状态，实时事件随后
+  // 无缝衔接（runId 对齐由缓冲记录的 runId 提供）。
+  ipcMain.handle('agent:getReplayState', (_event, sessionId: unknown) => {
+    if (typeof sessionId !== 'string' || !sessionId) {
+      return { success: false, error: 'Invalid sessionId' };
+    }
+    const buf = replayBuffers.get(sessionId);
+    return {
+      success: true,
+      data: {
+        isRunning: agentEngineManager.isRunning(sessionId),
+        runId: buf?.runId ?? null,
+        truncated: buf?.truncated ?? false,
+        events: buf?.events ?? [],
+      },
+    };
+  });
+
   // ===== v0.5.0: SubAgent 可观测性 =====
   // 1) 生命周期事件广播给前端（AgentMonitor 的 SubAgent 状态区）
   // 2) SubEngine 流事件录制到独立 TRACE 文件（sessionId = taskId），不污染父会话的流
@@ -1005,6 +1130,8 @@ export function registerAgentHandlers(ctx: IPCContext): void {
     text: string;
     usage: { input: number; output: number; total: number };
     responded: boolean;
+    /** v0.8.0 P0-1: 本轮 Provider 原生停止原因（DONE 事件携带） */
+    finishReason?: string;
   }
   const subTraces = new Map<string, SubTraceState>();
 
@@ -1117,7 +1244,8 @@ export function registerAgentHandlers(ctx: IPCContext): void {
             sessionId: taskId,
             iteration: st.iteration,
             content: st.text,
-            finishReason: 'stop',
+            // v0.8.0 P0-1: 记录真实停止原因（与主管道同口径）
+            finishReason: st.finishReason ?? 'stop',
             tokenUsage: st.usage,
           });
           sessionRecorder.recordIterationEnd(taskId, {
@@ -1152,7 +1280,8 @@ export function registerAgentHandlers(ctx: IPCContext): void {
             sessionId: taskId,
             iteration: st.iteration,
             content: st.text,
-            finishReason: 'stop',
+            // v0.8.0 P0-1: 记录真实停止原因（与主管道同口径）
+            finishReason: st.finishReason ?? 'stop',
             tokenUsage: st.usage,
           });
         }
@@ -1184,6 +1313,10 @@ export function registerAgentHandlers(ctx: IPCContext): void {
             };
           }
           break;
+        case MetonaStreamEventType.DONE:
+          // v0.8.0 P0-1: 捕获 Provider 原生停止原因（SubAgent TRACE 真值）
+          if (event.finishReason) st.finishReason = event.finishReason;
+          break;
         case MetonaStreamEventType.TOOL_CALL_COMPLETE:
           if (event.toolCall) {
             sessionRecorder.recordToolCall({