feat: v0.5.0 审计修复版 — 类型基线重建 + 会话隔离 + SubAgent 可观测性 + 三项功能补全

P0 安全与工程基线（止血）:
- .npmrc 移除硬编码 Gitea npm 凭据，改为 GITEA_NPM_AUTH 环境变量注入（已验证未设变量时 401）
- 修复 typecheck 空操作缺陷：solution-style 根 tsconfig 改为双工程真检查（node + web），
  pre-commit 与 CI 门禁恢复拦截能力
- 修复 4 处 v0.4.1 遗留类型错误：confirmation-hook.test 枚举名 FILE_SYSTEM→FILESYSTEM、
  agent.ts VALIDATION 事件 severity 类型谓词收窄、ContextMenu.tsx 导出 attachments 类型
- 补装 v0.4.1 声明但未安装的 node-html-parser 依赖

P1 逻辑缺陷修复（跨模块边界）:
- ConfirmationHook 会话隔离：rememberedDecisions 与 pendingConfirmations 按 sessionId 隔离，
  abortSession 只清本会话 pending（修复 A 会话中断误杀 B 会话确认、拒绝记忆跨会话污染）
- SubAgent 可观测性：orchestrator 六个事件此前全项目零消费者，现接入
  ① subagent:event 生命周期广播（AgentMonitor 新增 SubAgent 状态区）
  ② SubEngine 流事件独立 TRACE 录制（sessionId=taskId 的 JSONL 文件）
- main.ts 启动链路异常兜底：初始化失败时记录日志 + 系统错误对话框 + 退出（原为白屏挂起）

P2 工程强化:
- CI：typecheck 双工程真检查；electron-test 从 experimental（continue-on-error）转正为阻塞门禁；
  GITEA_NPM_AUTH secret 注入说明
- 渲染 bundle 代码分割：单 2630KB chunk 拆为 main 557KB + vendor-react/mui/markdown/icons
  （业务代码变更不再使 vendor 缓存失效）
- database 建表 mcp_servers CHECK 直接含 streamable-http（新库不再依赖迁移 6 立即重建）

P3 功能补全:
- DeepSeek 余额显示：新增 llm:getBalance IPC + LLMSettings 余额卡片（复用适配器原死代码 getBalance）
- FTS5 会话内容搜索：messages_fts 虚表 + INSERT/UPDATE/DELETE 触发器实时同步 +
  存量库 rebuild 迁移 + sessions:searchContent IPC + Sidebar 搜索框标题∪内容联合搜索
  （短语转义防 FTS 运算符注入，按会话聚合展示 snippet）
- 审计日志导出：audit:export IPC（JSONL / CSV RFC 4180 转义）+ LogsSettings 导出按钮

文档一致性大扫除:
- README：工具数统一为 28（原 26/27/30 三口径）、handlers.ts→ipc/、录制事件名更正、
  删除虚构的审计导出/归档宣称与 Schema 虚构字段、MCP 三种传输、配置 key 更正、
  项目结构树对齐实际（settings 10 文件/lib 6 文件/react-virtuoso）、clone 地址改为 Gitea、
  新增 GITEA_NPM_AUTH 配置说明、测试数 207
- 架构/构建指南/UI UX/IR 标准 4 份 HTML 设计文档同步修正（工具数、表数 10、
  磁盘文件 2 个现状注记、ipc/*.ts 路径）
- eslint.config.js 与开发规范.md 注释对齐零容忍基线与 better-sqlite3 选型

测试: 199→207 用例（新增 ConfirmationHook 跨会话隔离 5 用例 + FTS5 搜索/审计导出 8 用例）
验证: lint 0 problems / typecheck 双工程 0 errors / test:electron 207 全过 / build 成功

docs/MetonaAI-Desktop UI UX 设计集成方案.html

@@ -480,7 +480,7 @@ MeToast.<span class="hl-fn">warning</span>(<span class="hl-str">'操作已取消
     <tr><th>Tab</th><th>内容</th></tr>
     <tr><td class="f1">LLM 配置</td><td class="f2">Provider 选择、API Key、模型名称、参数滑块（temperature/maxTokens/contextWindow）</td></tr>
     <tr><td class="f1">Agent 配置</td><td class="f2">最大迭代次数、超时、Thinking 开关、反思模式、压缩阈值</td></tr>
-    <tr><td class="f1">工具管理</td><td class="f2">27 个内置工具开关、风险级别配置、路径白名单、命令黑名单</td></tr>
+    <tr><td class="f1">工具管理</td><td class="f2">28 个内置工具开关、风险级别配置、路径白名单、命令黑名单</td></tr>
     <tr><td class="f1">MCP 服务</td><td class="f2">Server 列表、添加/删除/启停、连接状态指示灯</td></tr>
     <tr><td class="f1">外观</td><td class="f2">主题（light/dark/auto）、字体大小、消息密度、动画开关</td></tr>
     <tr><td class="f1">日志与数据</td><td class="f2">日志级别、数据库位置、数据导出/清理、使用统计</td></tr>

docs/MetonaAI-Desktop 内部API请求与响应标准.html

@@ -1189,7 +1189,7 @@ electron/harness/adapters/
         <tr><td class="field-num">3</td><td>Tool Registry 使用 MetonaToolDef / MetonaToolCall / MetonaToolResult</td><td class="field-type">harness/tools/</td></tr>
         <tr><td class="field-num">4</td><td>Memory Manager 使用 MetonaMemoryItem</td><td class="field-type">harness/memory/</td></tr>
         <tr><td class="field-num">5</td><td>IPC Preload 桥接层只传递 Metona IR 类型</td><td class="field-type">electron/preload.ts</td></tr>
-        <tr><td class="field-num">6</td><td>IPC Handlers 的输入输出为 Metona IR 类型</td><td class="field-type">electron/ipc/*.handlers.ts</td></tr>
+        <tr><td class="field-num">6</td><td>IPC Handlers 的输入输出为 Metona IR 类型</td><td class="field-type">electron/ipc/*.ts</td></tr>
         <tr><td class="field-num">7</td><td>React 组件/Zustand Store 只读写 Metona IR 类型</td><td class="field-type">src/stores/, src/components/</td></tr>
         <tr><td class="field-num">8</td><td>每个 Provider Adapter 实现 IMetonaProviderAdapter</td><td class="field-type">harness/adapters/</td></tr>
         <tr><td class="field-num">9</td><td>流式事件通过 MetonaStreamEvent 推送</td><td class="field-type">hooks/useAgentStream.ts</td></tr>

docs/MetonaAI-Desktop 架构与交互设计.html

@@ -141,14 +141,14 @@
     <a href="#workspace">&#x1F4C1; 工作空间</a>
     <a href="#db-config">&#x1F4BE; 数据库配置</a>
 
-    <div class="sidebar-section">27 个内置工具</div>
+    <div class="sidebar-section">28 个内置工具</div>
     <a href="#tools-overview">&#x1F4CA; 工具总表</a>
     <a href="#tool-filesystem">&#x1F4C4; 文件系统工具</a>
     <a href="#tool-web">&#x1F310; 网络搜索与抓取</a>
     <a href="#tool-memory">&#x1F9E0; 记忆工具</a>
     <a href="#tool-command">&#x2692;&#xFE0F; 命令工具</a>
 
-    <div class="sidebar-section">4 个磁盘文件</div>
+    <div class="sidebar-section">磁盘文件（现为 2 个）</div>
     <a href="#disk-files">&#x1F4BE; 文件总览</a>
     <a href="#file-soul">&#x2728; SOUL.md</a>
     <a href="#file-agents">&#x1F4CB; AGENTS.md</a>
@@ -165,14 +165,17 @@
 
 <div class="hero">
     <h1>MetonaAI-Desktop 架构与交互设计</h1>
-    <p>基于「生产级通用 AI Agent 桌面应用构建指南」+「Metona 内部 IR 标准」，定义完整的系统架构、27 个内置工具、4 个用户级磁盘文件、工作空间机制、数据库配置规范及全链路可追踪日志体系。</p>
+    <p>基于「生产级通用 AI Agent 桌面应用构建指南」+「Metona 内部 IR 标准」，定义完整的系统架构、28 个内置工具、4 个用户级磁盘文件、工作空间机制、数据库配置规范及全链路可追踪日志体系。</p>
     <div class="hero-meta">
         <span><span class="dot dot-cyan"></span> 版本: <strong>v1.1.0</strong></span>
         <span><span class="dot dot-green"></span> 技术栈: <strong>React + Material UI (MUI) + Electron + SQLite</strong></span>
         <span><span class="dot dot-amber"></span> 日期: <strong>2026-07-15</strong></span>
     </div>
     <div class="note-box" style="margin-top:16px">
-        <strong>&#x1F4CB; 文档层级：</strong>本文档是 <strong>工作空间、27 个内置工具、4 个磁盘文件、数据库配置的权威定义</strong>，与《构建指南》第三、五、六章对应。冲突时以本文档为准。
+        <strong>&#x1F4CB; 文档层级：</strong>本文档是 <strong>工作空间、28 个内置工具、磁盘文件、数据库配置的权威定义</strong>，与《构建指南》第三、五、六章对应。冲突时以本文档为准。
+        <div class="warn-box" style="margin-top:12px;">
+            <strong>&#x26A0; 实现状态注记（v0.3.14+）：</strong>当前实现中用户级磁盘文件为 <strong>2 个</strong>（SOUL.md + MEMORY.md）；AGENTS.md 与 USERS.md 已从实现中移除（其职责并入 SOUL.md 与内置安全准则），本文档中相关章节保留为历史设计参考。当前实现共 <strong>28 个内置工具</strong>、<strong>10 张数据库表</strong>（新增 session_summaries 分层摘要表）。
+        </div>
     </div>
 </div>
 
@@ -184,7 +187,7 @@
     <p class="desc">
         MetonaAI-Desktop 是一个运行在用户本地桌面上的通用 AI Agent 应用。它以<strong>工作空间（Workspace）</strong>为基本组织单元，
         通过 <strong>4 个 Markdown 磁盘文件</strong> 定义 Agent 的灵魂、行为、记忆和用户画像，
-        提供 <strong>27 个内置工具</strong> 赋予 Agent 操作文件系统、网络、记忆和命令行的能力。
+        提供 <strong>28 个内置工具</strong> 赋予 Agent 操作文件系统、网络、记忆和命令行的能力。
         全链路操作<strong>透明可追踪</strong>，所有决策过程、工具调用、LLM 推理记录在本地 SQLite 日志中。
     </p>
 
@@ -301,7 +304,7 @@
     <h3>工作空间生命周期</h3>
     <div class="flow-step"><span class="flow-num">1</span><span class="flow-text">用户选择/创建工作空间目录（或使用默认路径 <code>~/MetonaWorkspaces/default/</code>）</span></div>
     <div class="flow-step"><span class="flow-num">2</span><span class="flow-text">校验必需文件，缺失则自动创建（<code>MEMORY.md</code> 带元数据头）</span></div>
-    <div class="flow-step"><span class="flow-num">3</span><span class="flow-text">加载 4 个磁盘文件，构建 System Prompt（空文件不影响启动）</span></div>
+    <div class="flow-step"><span class="flow-num">3</span><span class="flow-text">加载磁盘文件（当前实现为 SOUL.md + MEMORY.md 共 2 个），构建 System Prompt（空文件不影响启动）</span></div>
     <div class="flow-step"><span class="flow-num">4</span><span class="flow-text">连接 <code>.metona/agent.db</code>，加载配置、恢复历史会话</span></div>
     <div class="flow-step"><span class="flow-num">5</span><span class="flow-text">Agent 就绪，开始对话。所有工具操作默认以工作空间为根</span></div>
     <div class="flow-step"><span class="flow-num">6</span><span class="flow-text">会话结束后，<code>MEMORY.md</code>（更新时间戳）和 <code>.metona/agent.db</code> 自动更新</span></div>
@@ -388,9 +391,9 @@
 
 <hr class="section-divider">
 
-<!-- ====== 27 个内置工具 ====== -->
+<!-- ====== 28 个内置工具 ====== -->
 <section class="api-section" id="tools-overview">
-    <h2>&#x1F4CA; 27 个内置工具 — 总表</h2>
+    <h2>&#x1F4CA; 28 个内置工具 — 总表</h2>
     <p class="desc">所有工具使用 <strong>Metona IR 的 MetonaToolDef / MetonaToolCall / MetonaToolResult</strong> 结构。内置在 Tool Registry 中，Adaper 为 LLM 生成 JSON Schema 格式的描述。</p>
 
     <table class="spec">
@@ -404,7 +407,7 @@
         <tr><td class="f-name">7</td><td class="f-name">memory_store</td><td class="f-type">database</td><td class="f-risk risk-medium">MEDIUM</td><td>否</td><td>存储一条记忆到 SQLite</td></tr>
         <tr><td class="f-name">8</td><td class="f-name">memory_search</td><td class="f-type">database</td><td class="f-risk risk-safe">SAFE</td><td>否</td><td>检索记忆（关键词匹配）</td></tr>
         <tr><td class="f-name">9</td><td class="f-name">run_command</td><td class="f-type">code_execution</td><td class="f-risk risk-high">HIGH</td><td>是</td><td>执行 Shell 命令，沙箱限制</td></tr>
-        <tr><td colspan="6" style="padding:14px;color:var(--text-dim);font-size:13px;">完整 27 个工具列表详见 README.md「内置工具」章节。新增工具涵盖：file_editor、code_search、diff_viewer、web_browser、http_request、git_status/git_diff/git_log/git_commit、lint_code、run_tests、project_info、delegate_task、task_manager、todo_write、think、view_image。</td></tr>
+        <tr><td colspan="6" style="padding:14px;color:var(--text-dim);font-size:13px;">完整 28 个工具列表详见 README.md「内置工具」章节。新增工具涵盖：file_editor、code_search、diff_viewer、web_browser、http_request、git_status/git_diff/git_log/git_commit、lint_code、run_tests、project_info、delegate_task、task_manager、think、view_image、delete_file、file_move、file_info。</td></tr>
     </table>
 </section>
 
@@ -540,10 +543,11 @@
 
 <!-- ====== 4 个用户级磁盘文件 ====== -->
 <section class="api-section" id="disk-files">
-    <h2>&#x1F4BE; 4 个用户级磁盘文件</h2>
+    <h2>&#x1F4BE; 用户级磁盘文件</h2>
     <p class="desc">
-        4 个 <code>.md</code> 文件位于工作空间根目录，是工作空间的<strong>必需文件</strong>。
-        其中 <code>SOUL.md</code>、<code>AGENTS.md</code>、<code>USERS.md</code> 完全由用户自定义，<code>MEMORY.md</code> 由 Agent 维护但用户可编辑。
+        <code>.md</code> 文件位于工作空间根目录，是工作空间的<strong>必需文件</strong>。
+        其中 <code>SOUL.md</code> 完全由用户自定义，<code>MEMORY.md</code> 由 Agent 维护但用户可编辑。
+        <strong>当前实现为 2 个文件</strong>；原设计中的 AGENTS.md / USERS.md 已移除（职责并入 SOUL.md 与内置安全准则），下方相关小节保留为历史设计参考。
     </p>
 
     <table class="spec">
@@ -922,10 +926,10 @@
     <div class="flow-step"><span class="flow-num">2</span><span class="flow-text">选择/创建工作空间 → 校验必需文件（缺失则自动创建）</span></div>
     <div class="flow-step"><span class="flow-num">3</span><span class="flow-text">连接 SQLite（.metona/agent.db）→ 执行 schema 迁移 → 加载配置</span></div>
     <div class="flow-step"><span class="flow-num">4</span><span class="flow-text">初始化 Provider Adapter（根据数据库配置选择）</span></div>
-    <div class="flow-step"><span class="flow-num">5</span><span class="flow-text">加载 4 个磁盘文件，构建 System Prompt（空文件不影响启动）</span></div>
+    <div class="flow-step"><span class="flow-num">5</span><span class="flow-text">加载磁盘文件（当前实现为 SOUL.md + MEMORY.md 共 2 个），构建 System Prompt（空文件不影响启动）</span></div>
     <div class="flow-step"><span class="flow-num">6</span><span class="flow-text">连接启用的 MCP Servers → 动态加载 MCP 工具</span></div>
     <div class="flow-step"><span class="flow-num">7</span><span class="flow-text">启动 React UI（Chromium Renderer），Agent 就绪</span></div>
-    <div class="flow-step"><span class="flow-num">8</span><span class="flow-text">（可选）提示用户编辑 SOUL.md / AGENTS.md / USERS.md 以自定义 Agent</span></div>
+    <div class="flow-step"><span class="flow-num">8</span><span class="flow-text">（可选）提示用户编辑 SOUL.md 以自定义 Agent 人格（当前实现；AGENTS.md/USERS.md 已移除）</span></div>
 
     <h3>对话流程（一次 ReAct 迭代）</h3>
     <div class="flow-step"><span class="flow-num">1</span><span class="flow-text">用户在 ChatInput 输入消息 → IPC <code>agent:sendMessage</code> 发送 MetonaRequest</span></div>

docs/生产级通用 AI Agent 智能体桌面应用：完整设计与构建指南.html

@@ -1072,11 +1072,17 @@
 │   ├── main.ts                    # 应用入口，生命周期管理
 │   ├── preload.ts                 # Preload 安全桥接脚本
 │   ├── ipc/                       # IPC 通道注册与处理
-│   │   ├── index.ts               # IPC 通道汇总导出
-│   │   ├── agent.handlers.ts      # Agent 相关 IPC 处理
-│   │   ├── db.handlers.ts         # 数据库操作 IPC 处理
-│   │   ├── mcp.handlers.ts        # MCP 管理 IPC 处理
-│   │   └── config.handlers.ts     # 配置管理 IPC 处理
+│   │   ├── index.ts               # 统一注册入口（防重入）
+│   │   ├── agent.ts               # Agent 交互域（消息/中断/事件管道）
+│   │   ├── sessions.ts            # 会话 CRUD 域
+│   │   ├── config.ts              # 配置管理域
+│   │   ├── tools.ts               # 工具与确认域
+│   │   ├── mcp.ts                 # MCP 管理域
+│   │   ├── memory.ts              # 记忆域
+│   │   ├── tasks.ts               # 任务域
+│   │   ├── data.ts                # 数据导出与清理域
+│   │   ├── workspace.ts           # 工作空间域
+│   │   └── app.ts                 # 应用工具域
 │   ├── services/                  # 主进程业务服务
 │   │   ├── database.service.ts    # 数据库初始化与连接管理
 │   │   ├── agent-engine.service.ts # Agent 引擎服务
@@ -1092,7 +1098,7 @@
 │   │   ├── tools/                 # 工具注册与管理
 │   │   │   ├── registry.ts        # 工具注册表
 │   │   │   ├── base-tool.ts       # 工具基类/接口
-│   │   │   └── built-in/          # 内置工具集（21 个文件，27 个工具）
+│   │   │   └── built-in/          # 内置工具集（21 个文件，28 个工具）
 │   │   │       ├── filesystem.ts          # 文件系统（5 工具）
 │   │   │       ├── file-editor.ts         # 编辑器
 │   │   │       ├── code-search.ts         # 代码搜索
@@ -2677,7 +2683,7 @@ export class ToolRegistry {
   }
 }
 </code></pre>
-<p><strong>&#x1F527; 备注</strong>：v0.3.3 当前已实现 <strong>27 个内置工具</strong>，完整列表详见 <code>README.md</code>「内置工具」章节。下方仅以文件系统工具为示例展示实现规范。</p>
+<p><strong>&#x1F527; 备注</strong>：当前已实现 <strong>28 个内置工具</strong>，完整列表详见 <code>README.md</code>「内置工具」章节。下方仅以文件系统工具为示例展示实现规范。</p>
 <p><strong>内置工具示例——文件系统工具</strong>：</p>
 <pre><code class="language-typescript">// ====== electron/harness/tools/built-in/filesystem.ts ======
 
@@ -3315,7 +3321,7 @@ export interface ValidationIssue {
 </tbody>
 </table>
 <h3>6.2 SQLite 存储方案设计</h3>
-<p><strong>&#x1F4C1; 实际表结构</strong>：v0.3.3 实际共 <strong>9 张表</strong>，包含：<code>sessions</code>、<code>messages</code>、<code>app_config</code>、<code>audit_logs</code>、<code>mcp_servers</code>、<code>episodic_memories</code>、<code>semantic_memories</code>、<code>working_memories</code>、<code>tasks</code>（新增任务表，用于 Agent 子任务管理）。</p>
+<p><strong>&#x1F4C1; 实际表结构</strong>：当前实际共 <strong>10 张表</strong>，包含：<code>sessions</code>、<code>messages</code>、<code>app_config</code>、<code>audit_logs</code>、<code>mcp_servers</code>、<code>episodic_memories</code>、<code>semantic_memories</code>、<code>working_memories</code>、<code>tasks</code>（任务表，用于 Agent 子任务管理）、<code>session_summaries</code>（会话滚动摘要表，分层上下文加载）。</p>
 <pre><code class="language-sql">-- ====== database/schema.sql ======
 
 -- ============================================