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/harness/adapters/shared/sse-stream.ts

@@ -139,17 +139,17 @@ function extractUpstreamErrorFrame(
         ? e.status_code
         : undefined;
   const rawCode = typeof e.code === 'string' ? e.code : typeof e.type === 'string' ? e.type : '';
-  const message =
-    typeof e.message === 'string'
-      ? e.message
-      : typeof e.msg === 'string'
-        ? e.msg
-        : JSON.stringify(errObj);
-
   // 无消息且无状态码的无害空对象不算错误（防御性）
-  if (!message && rawStatus === undefined && !rawCode) return null;
+  // v0.8.0 P1-3.1 根治: 旧实现 message 兜底取 JSON.stringify(errObj) —— '{}' 恒为
+  // 真值，使本防御分支永不可达，`{"error":{}}` 被误判为错误帧抛 SseUpstreamError
+  // （原行为被 sse-stream.test.ts 锁定留档，本次随修复同步改约）。
+  // 现契约：仅当存在显式 message/msg 或 status/code 标识之一才构成错误帧；
+  // 描述文本只在有标识但无显式文本时由序列化/占位生成。
+  const explicitMessage =
+    typeof e.message === 'string' ? e.message : typeof e.msg === 'string' ? e.msg : '';
+  if (!explicitMessage && rawStatus === undefined && !rawCode) return null;
   return {
-    message: message || `upstream error (${rawCode || rawStatus})`,
+    message: explicitMessage || `upstream error (${rawCode || rawStatus})`,
     status: rawStatus,
     code: rawCode || undefined,
   };
@@ -326,6 +326,10 @@ export async function* parseSSEStream(
   let buffer = '';
   // v0.6.3: 是否收到过 [DONE]（流断开兜底用）
   let sawDone = false;
+  // v0.8.0 P0-1: 跟踪 Provider 原生 finish_reason，随 DONE 事件携带给引擎
+  // （'stop' | 'length' | 'tool_calls' | 'content_filter' 等；引擎据此区分
+  // 自然完成与输出上限截断，此前 length 仅落日志、引擎不可见）
+  let lastFinishReason: string | undefined;
 
   // v0.7.4 P1-2: 流空闲超时 — 服务器保活但不再推送数据（连接挂死）时，
   // reader.read() 会无限挂起，totalTimeoutMs 只在迭代之间检查，无法兜底。
@@ -369,6 +373,8 @@ export async function* parseSSEStream(
             iteration,
             seq: seqRef.seq++,
             timestamp: Date.now(),
+            // v0.8.0 P0-1: 携带 Provider 原生 finish_reason（未见任何帧时 undefined）
+            ...(lastFinishReason ? { finishReason: lastFinishReason } : {}),
           };
           return;
         }
@@ -480,6 +486,11 @@ export async function* parseSSEStream(
 
         // 非 [DONE] 但 finish_reason 为 tool_calls 时提前 flush 缓冲区
         const finishReason = chunk.choices?.[0]?.finish_reason as string | undefined;
+        // v0.8.0 P0-1: 记录最近一次 finish_reason（最终帧通常携带于最后一个
+        // 含 choices 的 chunk），随 DONE 事件上交通知引擎与前端
+        if (finishReason) {
+          lastFinishReason = finishReason;
+        }
         if (finishReason === 'tool_calls') {
           // L-4 修复: 使用 flushToolCallBuffer 替代重复的遍历代码
           yield* flushToolCallBuffer(toolCallsBuffer, requestId, sessionId, iteration, seqRef);
@@ -528,6 +539,10 @@ export async function* parseSSEStream(
       iteration,
       seq: seqRef.seq++,
       timestamp: Date.now(),
+      // v0.8.0 P0-1: 断流合成路径同样携带已观察到的 finish_reason
+      //（注意：断流时 finishReason 多为 undefined —— 引擎据此走空响应守卫/重试，
+      // 而不是误判为模型自然说完了）
+      ...(lastFinishReason ? { finishReason: lastFinishReason } : {}),
     };
   }
 }