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/services/__tests__/database-migration.test.ts

@@ -281,15 +281,21 @@ describe.skipIf(!dbAvailable)('DatabaseService — 多版本迁移矩阵（user_
     rmSync(dir, { recursive: true, force: true });
   });
 
-  it('user_version=2 的库：快速路径跳过迁移，版本号保持不变', async () => {
+  it('user_version=2 的库：增量迁移至 SCHEMA_VERSION（v0.8.0 补 sessions.deleted_at）', async () => {
     const { DatabaseService } = await import('../database.service');
     const dir = mkdtempSync(join(tmpdir(), 'metona-migv2-'));
     const legacy = openLegacyDb(dir);
+    // v0.8.0 注: 真实 v2 库必含 sessions 表 —— fixture 补齐以覆盖迁移 10
     legacy.exec(`
       CREATE TABLE messages (
         id TEXT PRIMARY KEY, session_id TEXT NOT NULL, role TEXT NOT NULL,
         content TEXT, created_at INTEGER NOT NULL
       );
+      CREATE TABLE sessions (
+        id TEXT PRIMARY KEY, title TEXT DEFAULT '新会话', created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL, message_count INTEGER DEFAULT 0,
+        pinned INTEGER DEFAULT 0, archived INTEGER DEFAULT 0, metadata TEXT DEFAULT '{}'
+      );
       CREATE VIRTUAL TABLE messages_fts USING fts5(content, content=messages, content_rowid=rowid, tokenize='trigram');
     `);
     legacy.pragma('user_version = 2');
@@ -298,7 +304,14 @@ describe.skipIf(!dbAvailable)('DatabaseService — 多版本迁移矩阵（user_
     const svc = new DatabaseService(dir);
     svc.initialize();
     const db = svc.getDB();
-    expect(db.pragma('user_version', { simple: true })).toBe(2);
+    // v0.8.0 P2-1 契约更新: SCHEMA_VERSION 升至 3（迁移 10 sessions.deleted_at），
+    // user_version=2 的库不再是最新版 —— 会执行增量迁移并盖章到 3；
+    // FTS 已是 trigram（迁移 9 幂等跳过），增量迁移只补 sessions.deleted_at 列。
+    expect(db.pragma('user_version', { simple: true })).toBe(DatabaseService.SCHEMA_VERSION);
+    const delCol = db
+      .prepare("SELECT COUNT(*) AS c FROM pragma_table_info('sessions') WHERE name='deleted_at'")
+      .get() as { c: number };
+    expect(delCol.c).toBe(1);
     // 快速路径不重建 FTS（保持原有 trigram 表）
     const ftsSql = db
       .prepare(`SELECT sql FROM sqlite_master WHERE type='table' AND name='messages_fts'`)

electron/services/__tests__/session-search.test.ts

@@ -50,6 +50,7 @@ describe.skipIf(!dbAvailable)('FTS5 会话内容搜索', () => {
         message_count INTEGER DEFAULT 0,
         pinned INTEGER DEFAULT 0,
         archived INTEGER DEFAULT 0,
+        deleted_at INTEGER,
         metadata TEXT DEFAULT '{}'
       );
       CREATE TABLE messages (
@@ -281,6 +282,7 @@ describe.skipIf(!dbAvailable)('SessionService — 会话 CRUD 与消息边界',
         total_tokens INTEGER DEFAULT 0,
         pinned INTEGER DEFAULT 0,
         archived INTEGER DEFAULT 0,
+        deleted_at INTEGER,
         metadata TEXT DEFAULT '{}'
       );
       CREATE TABLE messages (
@@ -618,6 +620,7 @@ describe.skipIf(!dbAvailable)('searchMessages — 更多查询形态与边界',
         message_count INTEGER DEFAULT 0,
         pinned INTEGER DEFAULT 0,
         archived INTEGER DEFAULT 0,
+        deleted_at INTEGER,
         metadata TEXT DEFAULT '{}'
       );
       CREATE TABLE messages (
@@ -787,11 +790,26 @@ describe.skipIf(!dbAvailable)('searchMessages — 更多查询形态与边界',
     expect(hits.some((r: any) => r.sessionId === 'q8')).toBe(true);
   });
 
-  it('已删除会话的标题回退为占位文案（（已删除会话））', () => {
-    // 消息引用已不存在的会话 id（真实库 FK 会阻止，此处验证 title 补全兜底）
+  it('回收站会话（deleted_at 非空）从搜索结果整体剔除（v0.8.0 P2-1 契约）', () => {
+    // v0.8.0 P2-1 契约变更: 旧实现把缺标题的会话显示为"（已删除会话）"占位；
+    // 软删除引入后，回收站会话的搜索命中整体剔除（恢复后重新可见），
+    // 硬删除会话的消息已级联清除，占位分支不再可达。
     insertMessage('q9_m1', 'q9_ghost', 'user', 'ghostkeyword 消息', 1);
-    const hits = sessionService.searchMessages('ghostkeyword');
-    expect(hits.some((r: any) => r.sessionTitle === '（已删除会话）')).toBe(true);
+    db.prepare(
+      `INSERT INTO sessions (id, title, created_at, updated_at) VALUES ('q9_ghost', 'ghost', 1, 1)`,
+    ).run();
+    const before = sessionService.searchMessages('ghostkeyword');
+    expect(before.some((r: any) => r.sessionId === 'q9_ghost')).toBe(true);
+
+    // 软删除后 → 搜索不再命中
+    db.prepare(`UPDATE sessions SET deleted_at = ? WHERE id = 'q9_ghost'`).run(Date.now());
+    const after = sessionService.searchMessages('ghostkeyword');
+    expect(after.some((r: any) => r.sessionId === 'q9_ghost')).toBe(false);
+
+    // 恢复后 → 重新命中
+    db.prepare(`UPDATE sessions SET deleted_at = NULL WHERE id = 'q9_ghost'`).run();
+    const restored = sessionService.searchMessages('ghostkeyword');
+    expect(restored.some((r: any) => r.sessionId === 'q9_ghost')).toBe(true);
   });
 
   it('单字符 CJK 查询走 LIKE 回退命中子串', () => {
@@ -945,6 +963,7 @@ describe.skipIf(!dbAvailable)('saveMessage id 透传与 updateMessageContent（R
         message_count INTEGER DEFAULT 0,
         pinned INTEGER DEFAULT 0,
         archived INTEGER DEFAULT 0,
+        deleted_at INTEGER,
         metadata TEXT DEFAULT '{}'
       );
       CREATE TABLE messages (

electron/services/__tests__/session-summary.test.ts

@@ -56,6 +56,7 @@ describe.skipIf(!dbAvailable)('SessionSummary 分层上下文 × 截断交互',
         message_count INTEGER DEFAULT 0,
         pinned INTEGER DEFAULT 0,
         archived INTEGER DEFAULT 0,
+        deleted_at INTEGER,
         metadata TEXT DEFAULT '{}'
       );
       CREATE TABLE messages (
@@ -284,6 +285,7 @@ describe.skipIf(!dbAvailable)('clearMessages × 摘要游标交互（B-2）', ()
         message_count INTEGER DEFAULT 0,
         pinned INTEGER DEFAULT 0,
         archived INTEGER DEFAULT 0,
+        deleted_at INTEGER,
         metadata TEXT DEFAULT '{}'
       );
       CREATE TABLE messages (
@@ -392,6 +394,7 @@ describe.skipIf(!dbAvailable)('session_summaries 级联删除（F-3）', () => {
         message_count INTEGER DEFAULT 0,
         pinned INTEGER DEFAULT 0,
         archived INTEGER DEFAULT 0,
+        deleted_at INTEGER,
         metadata TEXT DEFAULT '{}'
       );
       CREATE TABLE session_summaries (
@@ -472,6 +475,7 @@ describe.skipIf(!dbAvailable)('maybeSummarize — 触发阈值与增量', () =>
         message_count INTEGER DEFAULT 0,
         pinned INTEGER DEFAULT 0,
         archived INTEGER DEFAULT 0,
+        deleted_at INTEGER,
         metadata TEXT DEFAULT '{}'
       );
       CREATE TABLE messages (
@@ -652,6 +656,7 @@ describe.skipIf(!dbAvailable)('buildHistoryMessages — 无摘要与 role 过滤
         message_count INTEGER DEFAULT 0,
         pinned INTEGER DEFAULT 0,
         archived INTEGER DEFAULT 0,
+        deleted_at INTEGER,
         metadata TEXT DEFAULT '{}'
       );
       CREATE TABLE messages (
@@ -746,6 +751,7 @@ describe.skipIf(!dbAvailable)('restoreHistoryImages — 更多边界', () => {
         message_count INTEGER DEFAULT 0,
         pinned INTEGER DEFAULT 0,
         archived INTEGER DEFAULT 0,
+        deleted_at INTEGER,
         metadata TEXT DEFAULT '{}'
       );
       CREATE TABLE messages (

electron/services/__tests__/session-trash.test.ts

@@ -0,0 +1,157 @@
+/**
+ * v0.8.0 P2-1: 会话回收站（软删除 30 天保留）回归测试。
+ *
+ * 钉住契约：
+ * - delete → 软删除（deleted_at 时间戳），list/getSession 不再返回，listDeleted 返回；
+ * - restore → 恢复到主列表；
+ * - purge → 硬删除（不可恢复）；
+ * - purgeExpiredTrash(30d) → 仅清理超期条目；
+ * - searchMessages 聚合剔除回收站会话。
+ *
+ * 运行要求：better-sqlite3 为 Electron ABI 构建（test:electron），系统 Node 下自动跳过。
+ */
+
+import { describe, it, expect, beforeAll, afterAll, vi } from 'vitest';
+
+vi.mock('electron-log', () => ({
+  default: { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn() },
+}));
+
+let dbAvailable = true;
+let Database: typeof import('better-sqlite3');
+try {
+  // eslint-disable-next-line @typescript-eslint/no-require-imports
+  Database = require('better-sqlite3');
+  const probe = new Database(':memory:');
+  probe.close();
+} catch {
+  dbAvailable = false;
+}
+
+describe.skipIf(!dbAvailable)('会话回收站（v0.8.0 P2-1）', () => {
+  let sessionService: any;
+  let db: InstanceType<typeof Database>;
+
+  beforeAll(async () => {
+    const { SessionService } = await import('../session.service');
+    db = new Database(':memory:');
+    db.pragma('foreign_keys = ON');
+    // 最小 schema（与 DatabaseService.createTables 对齐的关键列：deleted_at + 级联删除）
+    db.exec(`
+      CREATE TABLE sessions (
+        id TEXT PRIMARY KEY,
+        title TEXT DEFAULT '新会话',
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        message_count INTEGER DEFAULT 0,
+        total_tokens INTEGER DEFAULT 0,
+        pinned INTEGER DEFAULT 0,
+        archived INTEGER DEFAULT 0,
+        deleted_at INTEGER,
+        metadata TEXT DEFAULT '{}'
+      );
+      CREATE TABLE messages (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        role TEXT NOT NULL,
+        content TEXT,
+        reasoning_content TEXT,
+        tool_calls TEXT,
+        tool_result TEXT,
+        attachments TEXT,
+        iteration INTEGER,
+        created_at INTEGER NOT NULL,
+        FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+      );
+      CREATE TABLE session_summaries (
+        session_id TEXT PRIMARY KEY,
+        summary TEXT NOT NULL,
+        summarized_until_rowid INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+      );
+    `);
+    sessionService = new SessionService(() => db);
+  });
+
+  afterAll(() => {
+    try {
+      db.close();
+    } catch {
+      /* ignore */
+    }
+  });
+
+  it('delete → 软删除：list 不返回、listDeleted 返回、getSession 排除', () => {
+    const a = sessionService.create('A');
+    const b = sessionService.create('B');
+    expect(sessionService.delete(a.id)).toBe(true);
+
+    const list = sessionService.list().map((s: { id: string }) => s.id);
+    expect(list).toContain(b.id);
+    expect(list).not.toContain(a.id);
+
+    const trash = sessionService.listDeleted().map((s: { id: string }) => s.id);
+    expect(trash).toEqual([a.id]);
+
+    expect(sessionService.getSession(a.id)).toBeNull();
+    expect(sessionService.getSession(b.id)).not.toBeNull();
+  });
+
+  it('restore → 恢复到主列表', () => {
+    const a = sessionService.listDeleted()[0];
+    expect(sessionService.restore(a.id)).toBe(true);
+    expect(sessionService.list().map((s: { id: string }) => s.id)).toContain(a.id);
+    expect(sessionService.listDeleted()).toHaveLength(0);
+  });
+
+  it('purge → 硬删除（仅对回收站条目生效）', () => {
+    const s = sessionService.create('temp');
+    sessionService.delete(s.id);
+    sessionService.saveMessage({ sessionId: s.id, role: 'user', content: 'x' });
+    expect(sessionService.purge(s.id)).toBe(true);
+
+    const count = db
+      .prepare('SELECT COUNT(*) AS c FROM messages WHERE session_id = ?')
+      .get(s.id) as {
+      c: number;
+    };
+    expect(count.c).toBe(0);
+    // 未删除的会话不可 purge（幂等保护）
+    const live = sessionService.create('live');
+    expect(sessionService.purge(live.id)).toBe(false);
+  });
+
+  it('purgeExpiredTrash(30d) → 仅清理超期条目', () => {
+    const old = sessionService.create('old');
+    sessionService.delete(old.id);
+    db.prepare('UPDATE sessions SET deleted_at = ? WHERE id = ?').run(
+      Date.now() - 31 * 24 * 60 * 60 * 1000,
+      old.id,
+    );
+
+    const fresh = sessionService.create('fresh');
+    sessionService.delete(fresh.id); // deleted_at = now
+
+    const purged = sessionService.purgeExpiredTrash(30);
+    expect(purged).toBe(1);
+    const remaining = db.prepare('SELECT COUNT(*) AS c FROM sessions WHERE id = ?').get(old.id) as {
+      c: number;
+    };
+    expect(remaining.c).toBe(0);
+    expect(sessionService.listDeleted().map((s: { id: string }) => s.id)).toContain(fresh.id);
+  });
+
+  it('searchMessages 聚合剔除回收站会话（≤2 字符 LIKE 回退路径）', () => {
+    const s1 = sessionService.create('搜索目标会话');
+    sessionService.saveMessage({ sessionId: s1.id, role: 'user', content: '量子计算机的独特内容' });
+    // '量子' ≤2 字符走 LIKE 回退（最小 schema 无 FTS 表，与生产 trigram 路径
+    // 共用同一个 aggregateSearchResults 聚合出口，剔除逻辑同源）
+    const r1 = sessionService.searchMessages('量子');
+    expect(r1.length).toBe(1);
+
+    sessionService.delete(s1.id);
+    const r2 = sessionService.searchMessages('量子');
+    expect(r2.length).toBe(0);
+  });
+});

electron/services/__tests__/session-truncate-trace.test.ts

@@ -45,6 +45,7 @@ describe.skipIf(!dbAvailable)('truncateMessagesAfter × TRACE metadata 过滤（
         message_count INTEGER DEFAULT 0,
         pinned INTEGER DEFAULT 0,
         archived INTEGER DEFAULT 0,
+        deleted_at INTEGER,
         metadata TEXT DEFAULT '{}'
       );
       CREATE TABLE messages (