feat: v0.8.1 记忆深化 · 观测闭环 · 体验收口 — 窗口/输出上限全局单一配置 · 2478 用例全量回归 + E2E 冒烟

硬性契约：删除代码中一切写死的上下文窗口与最大输出上限（含六家模型元信息
钳制与全部兜底值）——唯一合法来源是设置面板「上下文长度」（llm.contextWindow）
与「最大输出上限」（llm.maxTokens），跨 Provider/模型原样透传。

P0 正确性收口：
- 迁移 11/12（SCHEMA_VERSION 5）：记忆表 embedding 列 + 分 Provider 窗口键清理
- 记忆生命周期接线：会话终态清理 working memory / episodic 90 天 TTL / access_count 回写
- 回放缓冲模块化 + 会话终态清理（杜绝 4MB/会话内存滞留）
- i18n 收口：主进程 main-locale（zh/en，ui.locale 热切换）+ 渲染层 17 处出层

P1 能力演进：
- 本地向量混合检索：0.6×向量余弦 + 0.4×TF-IDF，Ollama embeddings 首次投产，
  存量记忆惰性回填，嵌入不可用自动回退 TF-IDF
- MEMORY.md 维护闭环：固化去重消除截断盲区；两阶段维护（AI 建议 → 用户确认 →
  原子改写 + 语义记忆双轨同步 + 审计）；>50KB 告警
- 可观测闭环：cacheTokens 引擎→前端透传（Token 面板命中率/成本行）+ 输入框
  上下文占用指示条
- MCP Prompts/Resources 对话可用：/mcp:{server}:{prompt} 与 @mcp:{server}:{uri}

P2 体验补全：
- 工具自定义策略（正则白/黑名单 + 频率 + 强制确认，热生效）
- 连续 ≥3 同类工具确认聚合为单弹框
- 会话消息游标分页（首屏 200 条向上翻页）
- 开机自启；Playwright + Electron E2E 冒烟（本地 mock LLM 零外联）

Review 回归修复：MCP 大小写失配 / 分页状态复位 / 清空=未配置语义（Number(null)=0
隐患）/ MEMORY.md 告警位置 / working_memories FK（迁移 13）/ 全局配置层废键清理；
附带根治权限加固启动时序、代理回环放行、safeStorage 降级、悬空 symlink 逃逸。

验证：typecheck/lint 0 问题；test:electron 2478/2478（0 跳过）；E2E 2/2；
docs/v0.8.1-迭代实施清单.md 全项留档。

electron/services/__tests__/config-layering.test.ts

@@ -285,9 +285,11 @@ describe.skipIf(!dbAvailable)('isUnconfiguredGlobalKey — 边界值矩阵', ()
     expect(isUnconfiguredGlobalKey(key, value)).toBe(expected);
   });
 
-  it('isGlobalKey 边界：完整前缀匹配而非子串（deepseek.contextWindow 是全局 key）', () => {
-    expect(isGlobalKey('deepseek.contextWindow')).toBe(true);
-    expect(isGlobalKey('deepseek.apiKey')).toBe(true);
+  it('isGlobalKey 边界：完整前缀匹配而非子串（v0.8.1: provider 前缀已废除）', () => {
+    // v0.8.1: deepseek/agnes/mimo/openai/anthropic/ollama 前缀从全局清单移除
+    //（其唯一键 contextWindow/numCtx 已废除，由全局 llm.contextWindow 取代）
+    expect(isGlobalKey('deepseek.contextWindow')).toBe(false);
+    expect(isGlobalKey('deepseek.apiKey')).toBe(false);
     expect(isGlobalKey('memory.consolidationEnabled')).toBe(true);
     expect(isGlobalKey('memory.custom')).toBe(true);
     // 非全局前缀
@@ -497,9 +499,9 @@ describe.skipIf(!dbAvailable)('migrateFromWorkspaceDB — 边界矩阵', () => {
   });
 
   it('数值边界：默认值 float 精确相等判定', () => {
-    // deepseek.contextWindow 默认 1000000
-    expect(globalConfig.migrateFromWorkspaceDB({ 'deepseek.contextWindow': 1000000 })).toBe(0);
-    expect(globalConfig.migrateFromWorkspaceDB({ 'deepseek.contextWindow': 64000 })).toBe(1);
+    // v0.8.1: deepseek.contextWindow 键已废除（迁移 12）——改用存续键 llm.maxTokens（默认 63488）
+    expect(globalConfig.migrateFromWorkspaceDB({ 'llm.maxTokens': 63488 })).toBe(0);
+    expect(globalConfig.migrateFromWorkspaceDB({ 'llm.maxTokens': 64000 })).toBe(1);
   });
 
   it('迁移后新 ConfigService 读取（跨空间共享生效）', () => {

electron/services/__tests__/mcp-contents.test.ts

@@ -0,0 +1,113 @@
+/**
+ * MCPManager getPrompt / readResource 测试（v0.8.1 P1-4）
+ *
+ * prompts/resources 对话内可用化的主进程侧契约：
+ * 1. getPrompt：messages 展平为文本（text 块拼接、多消息 \n\n 连接）、
+ *    未连接 server 显式抛错；
+ * 2. readResource：text 内容返回、二进制（blob）显式拒绝、
+ *    空 contents 返回 null。
+ *
+ * 通过反射注入受控 server 状态（绕开真实 SDK 连接），与 IPC 层解耦。
+ */
+
+import { describe, it, expect, vi } from 'vitest';
+
+vi.mock('electron-log', () => ({
+  default: { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn() },
+}));
+
+import { MCPManager } from '../mcp-manager.service';
+import type { ToolRegistry } from '../../harness/tools/registry';
+
+function makeManager(): MCPManager {
+  const fakeDB = {
+    prepare: () => ({ run: () => ({ changes: 0 }) }),
+  } as unknown as ConstructorParameters<typeof MCPManager>[0] extends () => infer D ? D : never;
+  const registry = {
+    registerMCP: vi.fn(() => true),
+    unregisterMCPTools: vi.fn(),
+  } as unknown as ToolRegistry;
+  return new MCPManager(() => fakeDB, registry);
+}
+
+/** 反射注入受控 server 状态（mock client） */
+function injectServer(manager: MCPManager, client: Record<string, ReturnType<typeof vi.fn>>): void {
+  const states = (
+    manager as unknown as {
+      servers: Map<
+        string,
+        {
+          config: { name: string };
+          status: string;
+          client: unknown;
+          tools: unknown[];
+          resources: unknown[];
+          prompts: unknown[];
+        }
+      >;
+    }
+  ).servers;
+  states.set('test-server', {
+    config: { name: 'test-server' } as never,
+    status: 'connected',
+    client: client as never,
+    tools: [],
+    resources: [],
+    prompts: [],
+  });
+}
+
+describe('MCPManager — getPrompt（v0.8.1 P1-4）', () => {
+  it('messages 展平为文本，多消息以空行连接', async () => {
+    const manager = makeManager();
+    injectServer(manager, {
+      getPrompt: vi.fn().mockResolvedValue({
+        description: 'demo prompt',
+        messages: [
+          { role: 'user', content: { type: 'text', text: 'Line A' } },
+          { role: 'user', content: { type: 'text', text: 'Line B' } },
+        ],
+      }),
+    });
+    const result = await manager.getPrompt('test-server', 'demo');
+    expect(result).not.toBeNull();
+    expect(result!.text).toBe('Line A\n\nLine B');
+    expect(result!.description).toBe('demo prompt');
+  });
+
+  it('server 未连接 → 显式抛错（调用方以 error 返回）', async () => {
+    const manager = makeManager();
+    await expect(manager.getPrompt('nope', 'demo')).rejects.toThrow(/not connected/);
+  });
+});
+
+describe('MCPManager — readResource（v0.8.1 P1-4）', () => {
+  it('text 内容正常返回', async () => {
+    const manager = makeManager();
+    injectServer(manager, {
+      readResource: vi.fn().mockResolvedValue({
+        contents: [{ uri: 'file:///a.txt', text: 'hello resource', mimeType: 'text/plain' }],
+      }),
+    });
+    const result = await manager.readResource('test-server', 'file:///a.txt');
+    expect(result).toEqual({ text: 'hello resource', mimeType: 'text/plain' });
+  });
+
+  it('二进制（blob）内容显式拒绝', async () => {
+    const manager = makeManager();
+    injectServer(manager, {
+      readResource: vi.fn().mockResolvedValue({
+        contents: [{ uri: 'file:///a.png', blob: 'aGVsbG8=' }],
+      }),
+    });
+    await expect(manager.readResource('test-server', 'file:///a.png')).rejects.toThrow(/binary/);
+  });
+
+  it('空 contents → null', async () => {
+    const manager = makeManager();
+    injectServer(manager, {
+      readResource: vi.fn().mockResolvedValue({ contents: [] }),
+    });
+    expect(await manager.readResource('test-server', 'file:///none')).toBeNull();
+  });
+});

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

@@ -0,0 +1,114 @@
+/**
+ * SessionService 游标分页测试（v0.8.1 P2-3）
+ *
+ * 契约：无 limit 全量；limit 无游标 = 尾部窗口（最后 N 条，升序返回）；
+ * limit + beforeRowid = 游标之前的更早 N 条（升序返回）；完整性判定
+ * （返回条数 < limit 即到会话开头）由调用方依据长度比较。
+ */
+
+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;
+}
+
+import { SessionService } from '../session.service';
+
+describe.skipIf(!dbAvailable)('SessionService — 游标分页（v0.8.1 P2-3）', () => {
+  let db: InstanceType<typeof Database>;
+  let svc: SessionService;
+  const sessionId = 's_page';
+
+  beforeAll(() => {
+    if (!dbAvailable) return;
+    db = new Database(':memory:');
+    db.exec(`
+      CREATE TABLE sessions (
+        id TEXT PRIMARY KEY,
+        title TEXT NOT NULL DEFAULT '',
+        created_at INTEGER,
+        updated_at INTEGER,
+        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,
+        content TEXT,
+        reasoning_content TEXT,
+        tool_calls TEXT,
+        tool_result TEXT,
+        attachments TEXT,
+        iteration INTEGER,
+        created_at INTEGER
+      );
+      CREATE TABLE session_summaries (
+        session_id TEXT PRIMARY KEY,
+        summary TEXT,
+        summarized_until_rowid INTEGER,
+        updated_at INTEGER
+      );
+      CREATE TABLE tasks (
+        id TEXT PRIMARY KEY,
+        session_id TEXT,
+        title TEXT,
+        description TEXT,
+        status TEXT,
+        priority TEXT,
+        parent_id TEXT,
+        assigned_to TEXT,
+        order_idx INTEGER,
+        created_at INTEGER,
+        updated_at INTEGER,
+        completed_at INTEGER
+      );
+    `);
+    db.prepare('INSERT INTO sessions (id) VALUES (?)').run(sessionId);
+    svc = new SessionService(() => db);
+    for (let i = 1; i <= 10; i++) {
+      svc.saveMessage({ sessionId, role: 'user', content: `msg-${i}` });
+    }
+  });
+  afterAll(() => {
+    if (db) db.close();
+  });
+
+  it('无 limit → 全量（向后兼容）', () => {
+    expect(svc.getMessages(sessionId)).toHaveLength(10);
+  });
+
+  it('limit 无游标 → 尾部窗口（最后 N 条，升序返回）', () => {
+    const tail = svc.getMessages(sessionId, { limit: 3 });
+    expect(tail.map((m) => m.content)).toEqual(['msg-8', 'msg-9', 'msg-10']);
+  });
+
+  it('limit + beforeRowid → 游标之前 N 条（升序返回）', () => {
+    const full = svc.getMessages(sessionId);
+    const cursorRowId = full[6].rowId!; // msg-7 的 rowid
+    const older = svc.getMessages(sessionId, { limit: 3, beforeRowid: cursorRowId });
+    expect(older.map((m) => m.content)).toEqual(['msg-4', 'msg-5', 'msg-6']);
+  });
+
+  it('游标翻到开头：返回条数 < limit 表示已完整', () => {
+    const full = svc.getMessages(sessionId);
+    const first = full[0].rowId!;
+    const older = svc.getMessages(sessionId, { limit: 3, beforeRowid: first });
+    expect(older).toHaveLength(0);
+  });
+});