适用版本：1.0.0（原始分析）　|　分析日期：2026-06　|　状态复核：2026-09-05（v1.7.0）

分析范围：全部代码（排除 docs/ 和 product/），涵盖 Rust 后端 42 个 .rs 文件、React 前端 65+ 个 .tsx/.ts 文件、配置与构建系统。

本报告原为一次性分析产物，现纳入文档体系并持续复核。已知 P0 安全问题（问题 7/8/9/10/11）截至 v1.0.0 仍未修复，见 CHANGELOG 已知问题。

v1.2 复核更新（2026-09-02）：Agent 已迁移为 Rust 原生引擎。涉及 Python Agent / tiny_http Bridge / 端口 9876/9877 的条目（问题 27/28/30 等）已随迁移整体解决， 正文中对应「未修复/待处理」状态以本注记为准（保留原文作为历史记录）。

v1.6.0 复核更新（2026-09-05）：数据一致性收尾 —— 问题 1（写操作事务保护）与 问题 21（构建命令 npm → pnpm）已全部解决，正文对应状态与 Phase 2 路线图已同步更新。

2026-09-05 复核更新（sqlite-vec 落地）：问题 13（向量全量加载内存爆炸）已通过 sqlite-vec vec0 KNN 镜像彻底解决（SQLite 内检索，O(k) 内存），正文问题 13、P1 汇总清单 与 Phase 2/4 路线图已同步更新。

2026-09-05 复核更新（Phase 2 收口）：问题 27（Bridge 9876 无鉴权）复核确认已随 v1.1 Rust 原生引擎迁移整体删除（src-tauri 无任何 TcpListener/HTTP server 残留，仅存注释）； 问题 28（skills/cancel 占位）已实现 CancelToken 即时中断（AtomicBool + tokio::Notify + tokio::select!，SSE 读取与 HTTP 发送均可即时打断，取消不再补发 done）。Phase 2 全部关闭， 正文与矩阵状态已同步。

2026-09-05 复核更新（Phase 3 收口）：Phase 3 六项全部落地，路线图关闭：

• 问题 3：Zustand slice 升级为三个真正独立的领域 store —— booksStore / aiStore / preferencesStore，appStore.ts 降为出口 + 跨域便捷选择器（useCurrentBook 等路径不变）；
• 问题 6：useAiChat 拆为 4 个职责单一 hook（消息仓储 / 滑动窗口摘要 / Agent 流式传输桥接 / 主编排）；
• 问题 23：新增 useShortcut 集中式快捷键系统（src/hooks/useShortcut.ts），统一解析 mod/ctrl/alt/shift 与平台差异，注册表 SHORTCUT_DEFS 集中维护，原 Ctrl+S / Esc 专注 / ⌘⇧P 命令面板已迁移；
• 问题 22：编辑器会话草稿保护（每次击键写 sessionStorage，入库成功清除，加载时自动恢复并提示）；
• 问题 15：DraggableVolume / DraggableChapter 加 React.memo，OutlinePanel 行渲染抽为 OutlineListRow memo 边界并稳定回调引用（MessageBubble / MessageList 此前已 memo）；
• 问题 29：记忆库容量上限与过期清理（memory.rs 新增 prune_memories / prune_all_memories， last_hit_at 命中打点 + 迁移列，分组上限 60 / 全书 240 / 180 天未命中过期）。 正文问题条目、优先级矩阵与 Phase 3 路线图已同步更新。

2026-09-05 复核更新（Phase 4 收口）：长期路线图中可离线实施的问题全部落地，矩阵中 余下 🟡/⚪/❌ 条目清零：

• 问题 17：utils.rs 新增 DynamicUpdate 动态 UPDATE 构建器，book_service::update_book 与 world_card_service::update_world_card 的逐字段手工拼装收敛为统一构建（列名白名单仍为代码字面量）；
• 问题 18：新增 SEARCH_DEFAULT_LIMIT 常量取代两处魔法数字 20；search_world_cards FTS5 无命中时降级 LIKE（与 search_service 策略对齐）；
• 问题 19：parse_world_card 由列索引改按列名访问，并抽 WORLD_CARD_COLS 常量复用；
• 问题 4：aiStore 对话持久化改为 800ms 防抖合并 + beforeunload/visibilitychange 兜底 flush （导出 flushAiConversations），流式期间不再逐条全量 JSON.stringify；
• 问题 2：booksStore.refreshTree(bookId) 全量对账动作，目录恢复章节/卷与清空回收站后调用；
• 问题 5：OutlinePanel 继续拆分 —— 拖拽逻辑抽 hooks/useOutlineDnd.ts（269 行）、 对话框状态抽 hooks/useOutlineDialogs.ts，主文件 944 → 674 行；
• 问题 24：写作统计全链路落地 —— 新增 writing_stats 按日表（保存章节时随路累计净增字数）、 get_writing_stats 命令，状态栏新增进度条 / 连续天数 / 近 30 日字数曲线（WritingStatsPanel）；
• 问题 25：AI 对话导出 Markdown / JSON（conversationExport.ts + AiSidePanel「导出」菜单， plugin-dialog 选路径 + plugin-fs 写入）；
• 问题 20：check-npm-versions.ts 按 pnpm-lock packages 键提取解析版本并取最高 semver；
• 问题 26：tauri.conf.json bundle targets 增补 deb / appimage。 正文问题条目、优先级矩阵与 Phase 4 路线图已同步更新。

• 清晰的三层架构（Commands → Service → Repository），职责分明
• 良好的类型安全 — TypeScript strict: true，Rust 强类型 + 统一 Serde camelCase
• 双状态管理策略（Zustand 持久业务 + Jotai 瞬时 UI），分工合理
• IPC 桥接层统一封装所有 invoke 调用，禁止散落使用
• FTS5 + 向量搜索双轨检索，灵活适配
• 自动迁移策略考虑增量升级

• 数据一致性：多个写操作缺少事务保护
• 安全漏洞（v1.0.1 已修复 5/6）：硬编码加密密钥 ✅、CSP 策略过宽 ✅、更新签名未配置 ✅、withGlobalTauri ✅、fs 权限无作用域 ✅；剩余 Bridge Server 无鉴权（问题 27）
• 代码重复：动态 SQL 构建、FTS5 模式多处实现

// 当前 chapter_service.rs 中的 save_chapter：
chapter_repo::save_content(conn, chapter_id, content_html, word_count)?;
book_repo::update_word_count_by_chapter(conn, book_id, word_count_delta)?;
let book_wc = book_repo::word_count_by_chapter(conn, book_id)?;

三步操作不在同一事务中。如果 update_word_count 失败，save_content 已提交（rusqlite 默认自动提交），导致章节字数与书籍总字数不一致。

影响范围：

• save_chapter
• delete_chapter（soft_delete + update_word_count）
• restore_chapter
• hard_delete_chapter
• restore_snapshot

状态：✅ 已修复（2026-09-05，v1.6.0 复核）。影响范围内全部多步写路径已事务化：

• chapter_service.rs：save_chapter / delete_chapter / restore_chapter / hard_delete_chapter 均在同一事务内完成（保存/软删/恢复 + 字数聚合 → 原子提交，任一步失败自动回滚）
• volume_service.rs：delete_volume（repo 层 soft_delete 已内置 BEGIN IMMEDIATE/COMMIT/ROLLBACK 显式事务）、hard_delete_volume（service 层 conn.transaction() 包装）
• snapshot_service.rs：restore_snapshot 事务化（快照内容回写 + 字数重算原子提交，窗口刷新事件移至提交成功之后）
• book_service.rs：hard_delete_book / clear_book_trash 事务化（级联删除/清空 + 孤立 embedding 清理原子提交）
• world_card_service.rs：复核结论为无需事务 —— 三个写操作（insert/update/delete）均为单条 SQL，FTS5 索引同步由数据库触发器原子完成，无多步写不一致风险点

建议方案：

pub fn save_chapter(db: &AppDb, chapter_id: &str, content_html: &str, word_count: i64) -> Result<SaveChapterResult, AppError> {
    let mut conn = db.pool.get()?;
    let tx = conn.transaction()?;  // 开启事务

    let result = tx.execute(/* save content */)?;
    tx.execute(/* update book word_count */)?;
    let book_wc = /* query within tx */;

    tx.commit()?;  // 原子提交
    Ok(SaveChapterResult { word_count, book_word_count: book_wc })
}

OutlinePanel.tsx 中删除/恢复章节时先调用 API，成功后直接更新 Zustand：

await chapterApi.delete(chapterId)
updateChapter(chapterId, { deletedAt: new Date().toISOString() })

如果 API 成功但前端崩溃/刷新，状态不同步。

建议：关键操作后调用 loadBookTree() 全量刷新，或在 API 层面返回完整状态。

AppState 接口包含 172 行类型定义，涵盖 6 个完全不相关的领域（书籍、AI、偏好、插件、编辑器状态、AI 工具分类）。单一 store 导致：

• 任何字段变化都触发 AppState 类型检查扩散
• useAppStore() 调用让组件订阅了不必要的数据

建议方案： 拆分为独立 store：

// stores/bookStore.ts
export const useBookStore = create<BookSlice>(...)

// stores/aiStore.ts
export const useAiStore = create<AiSlice>(...)

// stores/preferencesStore.ts
export const usePreferencesStore = create<PreferencesSlice>(...)

当前 Slice 模式只是代码组织层面的拆分，未真正实现状态隔离。

状态：✅ 已修复（2026-09-05，Phase 3 收口）。已升级为三个真正独立的领域 store：

• src/stores/booksStore.ts（useBooksStore）— 书籍/卷/章节/回收站/DB 状态
• src/stores/aiStore.ts（useAiStore）— AI 配置/对话/摘要/工具箱分类/版本
• src/stores/preferencesStore.ts（usePreferencesStore）— 主题/字体/网格/编辑器宽度/视图

原 appStore.ts 降级为「三个 store 的再导出 + 跨域便捷选择器」（useCurrentBook / useCurrentChapter / useCurrentAiMessages / getEditorState），旧 import 路径全部兼容； 全部消费点已迁移到对应领域 store，单 store 订阅扩散问题消除（一个领域状态变化不再触发 其它领域组件重渲染）。

每次 addAiMessage / updateAiMessage 都立即写 localStorage：

addAiMessage: (bookId, message) =>
  set((s) => {
    const conversations = { ...s.aiConversations, [bookId]: [...(s.aiConversations[bookId] ?? []), message] }
    saveAiConversations(conversations)  // 同步写 localStorage！
    return { aiConversations: conversations }
  }),

流式对话期间每秒可能触发数十次更新，每次序列化整个 conversations 对象到 localStorage。

建议： 使用防抖持久化，仅在流式结束或页面卸载时写入：

// 仅在 streaming 结束后持久化
if (!streaming) {
  debouncedSaveAiConversations(conversations)
}

1048 行，包含 6 个子组件定义在同一个文件中：

• DraggableVolume
• DraggableChapter
• DroppableUnassignedZone
• VolumePreview
• ChapterPreview
• 两个对话框

建议： 将 DraggableVolume、DraggableChapter、对话框拆分为独立文件。

状态：🟡 部分修复。v0.9.1 已抽出 DraggableChapter / DraggableVolume / OutlineDialogs / OutlineDragDrop / OutlineRecycleBin 子组件，文件由 1048 行降至 842 行，仍属大文件。

589 行的 hook，handleSend 包含 200+ 行业务逻辑，涵盖前置校验、章节总结、RAG 检索、流式对话、错误处理、对话压缩。违反单一职责原则。

建议： 拆分为独立的自定义 hook：

• useChapterValidation — 前置校验
• useChapterSummary — 章节总结缓存逻辑
• useStreamChat — 流式对话 + RAF 缓冲
• useConversationCompression — 滑动窗口 + 摘要

状态：✅ 已修复（2026-09-05，Phase 3 收口）。useAiChat 已按职责拆为 4 个 hook：

• useAiChatMessages（components/ai/hooks/useAiChatMessages.ts）— 消息仓储（增删改/持久化）
• useConversationSummarizer（components/ai/hooks/useConversationSummarizer.ts）— 滑动窗口历史摘要
• useAgentChatStream（components/ai/hooks/useAgentChatStream.ts）— Agent 流式传输桥接 （agent-stream-chunk 监听生命周期 + RAF 合并刷新）
• useAiChat（components/ai/useAiChat.ts）— 主编排（前置校验 → 组合 → invoke）

主文件由 483 行降至约 220 行，各子 hook 职责单一；对外导出（getFriendlyAiError / QUICK_HINTS / PROVIDER_LABELS / stripHtmlToText）原路径保持兼容。

// src-tauri/src/commands/io/crypto.rs:15
const ENCRYPTION_KEY: &[u8; 32] = b"TimeWrite2024SecretKey!MirageInk";

任何获取二进制文件的人都能提取密钥，备份加密形同虚设。

状态：✅ 已修复（v1.0.1 安全加固：密钥不再硬编码）。 算法本身为 AES-256-GCM（nonce[12] + ciphertext + tag[16]），算法选型正确。

实际采用方案（crypto.rs）：

1. 环境变量 TIMEWRITE_BACKUP_KEY（任意长度 → SHA-256 派生 32 字节）—— 优先级最高，适合 CI / 高级用户
2. 持久化密钥文件 <app_data_dir>/backup.key —— 首次启动生成随机密钥（Unix 权限 0600），之后自动加载

应用启动时经 init_backup_key 初始化，加密/解密函数从全局缓存读取。密钥泄露面从「二进制内静态常量」降为「本机文件权限保护」。

"csp": "img-src 'self' asset: https:; connect-src 'self' ipc: http://ipc.localhost"

• img-src https: — 允许任意 HTTPS 图片源，可被用于用户追踪
• connect-src http://ipc.localhost — 允许明文 HTTP，应改为 https://ipc.localhost

状态：✅ 已修复（v1.0.1：img-src 移除 https: 通配，仅保留 asset: + data:；connect-src 按实际需要增加 https://api.github.com；新增 base-uri 'self' / form-action 'self' / frame-ancestors 'self' 收紧）。

⚠️ 说明：ipc: / http://ipc.localhost 是 Tauri 内部 IPC 协议（非真实网络请求），不能改为 https://，否则 IPC 调用会被 CSP 阻断。AI 请求全部在 Rust 侧（reqwest）发起、不经过 WebView，因此无需在 CSP 中放行 AI 服务商域名。

"pubkey": "TODO: 生成密钥对并填入公钥..."

必须立即修复：执行 pnpm tauri signer generate -w ~/.tauri/myapp.key 并填入公钥。

状态：✅ 已修复（v1.0.1：已生成 minisign 签名密钥对，公钥已填入 tauri.conf.json 的 pubkey）。

⚠️ 使用须知：私钥保存在 ~/.tauri/timewrite.key，口令见 v1.0.1 加固记录（请妥善保管并尽快自行更换）。发布 CI 需在 GitHub 仓库配置两个 Secret：TAURI_PRIVATE_KEY（私钥内容）与 TAURI_PRIVATE_KEY_PASSWORD（私钥口令），否则构建产物无法签名、更新校验将失败。

将 Tauri API 暴露到全局作用域（window.__TAURI__），增加 XSS 攻击面。

建议： 设为 false，仅在需要时通过 @tauri-apps/api 显式导入。

状态：✅ 已修复（v1.0.1：withGlobalTauri 已设为 false。已核实前端零使用 window.__TAURI__，所有 IPC 均经 @tauri-apps/api 显式导入）。

"permissions": ["fs:allow-read", "fs:allow-write", ...]

所有文件系统操作全局允许。

状态：✅ 已修复（v1.0.1：12 项 fs 权限均已限定 $APPDATA/**、$RESOURCE/** 路径作用域；assetProtocol.scope 同步收窄。用户通过系统对话框选择的路径由 dialog 插件动态授权，不影响导入导出 / 插图功能）。

修复方式：

{
  "identifier": "fs:allow-read",
  "scope": ["$APPDATA/**", "$RESOURCE/**"]
}

INSERT OR REPLACE INTO chapters_fts(rowid, title, content)
    SELECT rowid, title, content_html FROM chapters WHERE deleted_at IS NULL;

大数据量下拖慢启动。

建议：仅在新数据插入时通过触发器增量更新，启动时只检查 chapters_fts 和 chapters 行数是否一致。

状态：✅ 已修复。db/mod.rs 已建立 6 个 CREATE TRIGGER（chapters / world_cards 各 3 个，INSERT/UPDATE/DELETE 自动同步 FTS5）。

all_rows.extend(embedding_repo::list_chapter_embeddings(conn, book_id)?);
all_rows.extend(embedding_repo::list_world_card_embeddings(conn, book_id)?);

数千章节时内存爆炸。

建议：

• 短期：限制 LIMIT 加载数量
• 长期：使用 sqlite-vss 扩展或 LanceDB 嵌入

状态：✅ 已修复（2026-09-05，sqlite-vec 迁移落地）。

• 新增 vec0 虚拟表 chunks_vec（rowid ↔ embeddings.id）作为 KNN 索引镜像，经 sqlite3_auto_extension 进程级注册 sqlite-vec 扩展（静态编译，bundled SQLite 直接可用，无 load_extension 权限问题）。
• 语义检索改为 SQLite 内完成：embedding MATCH ? ORDER BY distance LIMIT k（cosine），内存占用 O(k)（k≤2000），彻底移除旧实现「全书向量读入内存 + Rust 逐条余弦」的 O(n·d) 路径；bytes_to_floats / cosine_similarity 已删除。
• embeddings 表保持为唯一事实来源（备份/清理/统计兼容）；db/mod.rs::ensure_chunks_vec 启动幂等对齐（维度探测，旧库自动回填），rebuild_chunks_vec 在 trigger_embedding / 导入后全量重建；孤儿清理、单书/全量备份导入均同步删除 vec 镜像行。
• 维度变化（更换 embedding 模型）自动重建镜像表；search_service 向量无命中或出错时降级 FTS5 关键词搜索，不再抛错。
• sqlite-vec crate 锁定 0.1.9 稳定版（0.1.10-alpha.x 的 crates.io 包缺失 sqlite-vec-diskann.c 无法编译）。
• 新增冒烟测试 db::tests::sqlite_vec0_knn_cosine_smoke 覆盖建表 / 插入 / cosine KNN / rowid 删除。

overscan: activeId ? 9999 : 10 — 拖拽时渲染全部条目，大目录树会卡顿。

建议：使用 @dnd-kit 的 rectIntersection 碰撞检测算法，保持 overscan: 20，避免全量渲染。

以下组件未使用 React.memo，每次父组件更新都重渲染：

• OutlinePanel 中的 flatItems 用 useMemo 但组件本身未 memo
• RichTextEditor 直接使用 useCurrentChapter() 返回新引用

建议： 对 DraggableVolume、DraggableChapter、MessageBubble 等列表项使用 React.memo。

状态：✅ 已修复（2026-09-05，Phase 3 收口）。DraggableVolume / DraggableChapter 已加 React.memo；OutlinePanel 虚拟列表行渲染抽为 OutlineListRow memo 边界组件，目录增删/重排 相关处理器全部 useCallback 稳定化（rowHandlers 合集），拖拽悬停等局部状态变化时未受影响行 直接跳过渲染。MessageBubble / MessageList / AgentMessageList 复核确认此前已 memo。

vite.config.ts manualChunks 中缺少 react 相关 vendor chunk：

if (id.includes('node_modules/react') || id.includes('node_modules/react-dom')) {
  return 'react-vendor'
}

这是最大的 vendor chunk，应单独拆出。

状态：✅ 已修复。vite.config.ts:95 已精确匹配 node_modules/react/ / react-dom/ / scheduler/ 输出为 react-vendor，并另拆 tiptap / lucide / state / router / markdown / utils / virtual / highlight / katex / dnd-kit / tauri-vendor 等 chunk。

book_service.rs 和 world_card_service.rs 中几乎完全相同的动态 UPDATE 构建逻辑：

let mut set_clauses: Vec<String> = Vec::new();
let mut param_values: Vec<Box<dyn rusqlite::types::ToSql>> = Vec::new();
// 逐个字段检查...
let sql = format!("UPDATE {} SET {} WHERE id=?", table, set_clauses.join(", "));

建议： 提取为宏或泛型函数：

macro_rules! build_update {
    ($table:expr, $id:expr, { $($field:ident: $col:expr),* $(,)? }) => { ... }
}

search_service.rs 先 FTS5 后 LIKE 降级，world_card_service.rs 仅在 fts_query 为空时才降级 LIKE。硬编码 limit 值不同（20 vs top_n）。

建议： 统一为 trait 或通用函数 fn search(query, limit) -> Vec<T>。

// world_card_repo.rs — 脆弱
let title: String = row.get(0)?;
// vs
// book_repo.rs — 推荐
let title: String = row.get("title")?;

列索引在 schema 变更时极易错位。

readLockVersions 函数中的正则匹配逻辑不完整，实际锁版本解析是空操作。

"beforeDevCommand": "npm run dev",
"beforeBuildCommand": "npm run build"

项目使用 pnpm，应改为 pnpm run dev / pnpm run build。

状态：✅ 已修复（2026-09-05）：tauri.conf.json 的 beforeDevCommand / beforeBuildCommand 已改为 pnpm run dev / pnpm run build，与项目 pnpm 包管理一致。

如果应用崩溃，未保存的内容丢失。

建议：利用 TipTap 的 content + sessionStorage 在每次编辑时备份草稿。

状态：✅ 已修复（2026-09-05，Phase 3 收口）。RichTextEditor 新增会话级草稿保护：

• 每次击键（防抖前）同步写入 sessionStorage（key mi_draft:{bookId}:{chapterId}）；
• 内容成功入库（saveContent）后自动清除草稿，避免误恢复；
• 章节加载时若存在「与库中内容不同的草稿」则优先恢复并 toast 提示「已恢复未保存的编辑草稿」。

覆盖崩溃/误关/切章前未落库等场景（sessionStorage 生命周期 = 当前标签页会话）。

仅实现了 Ctrl+S 保存。写作软件应有丰富的快捷键（加粗/倾斜/标题/撤销等）。

建议：使用 useEffect 监听全局 keydown，或使用 TipTap 内置快捷键。

状态：✅ 已修复（2026-09-05，Phase 3 收口）。新增集中式全局快捷键系统 src/hooks/useShortcut.ts：

• useShortcut(combo, handler, opts?) hook：统一解析组合键语法（mod / ctrl / alt / shift，mod = ⌘(macOS)/Ctrl(其余)），支持 enabled / preventDefault / keydown|keyup；
• SHORTCUT_DEFS 注册表集中维护全部快捷键定义（便于文档化/设置页展示）；
• 已迁移：编辑器 mod+s 保存、Escape 退出专注模式（EditorPage，仅专注模式生效）、 mod+shift+p 命令面板唤起。格式快捷键（B/I/H1-3 等）由 TipTap 编辑器内置提供不变。

Book 类型有 dailyTarget、todayCount，但前端无进度可视化。

建议：在 StatusBar 添加日更进度条。

对话记录仅在 localStorage，无法导出备份。

建议：添加导出为 Markdown/JSON 功能。

tauri.conf.json 仅配置了 dmg（macOS）和 nsis（Windows）。

建议添加 deb 和 AppImage。

原报告分析于 Agent 子系统引入之前，以下为 2026-08-31 补充。

python/bridge.rs 启动的 tiny_http 服务监听 127.0.0.1:9876，提供 read_chapter / list_chapters / search_world_cards / book_context 四个路由，tools/db_tools.py 直接 POST /agent/{endpoint} 调用，无 Token 校验。

任何本机进程均可读取用户全部作品内容。虽然绑定 localhost 缓解了远程风险，但多用户机器或恶意本地软件仍可窃取数据。

建议：Bridge 启动时生成随机 Token 写入临时文件，Python 侧读取后置于 Authorization 头；Rust 侧校验。

状态：✅ 已消除（2026-09-05 复核确认）。v1.1 Agent 迁移为 Rust 原生引擎时，Python Agent(9877) 与 tiny_http Bridge(9876) 已整体删除：src-tauri 无任何 TcpListener/HTTP server 残留（仅存注释），无跨进程 HTTP 回调，Agent 同进程经 repository 层直查 SQLite—— 本问题的本地数据泄露攻击面已不存在，正文保留为 v1.0 历史记录。

server/routes.py:124-128 的 cancel_skill 仅返回 {"status": "cancelled"}，未真正中断正在执行的任务。前端「停止生成」按钮调用 cancel_agent_skill 后，Python 侧 LangGraph 流仍在继续消耗 Token。

建议：引入任务注册表（requestId → asyncio.Task），cancel 时 task.cancel() 并触发 SSE cancelled 事件。

状态：✅ 已修复（2026-09-05）。Rust 引擎取消升级为 CancelToken（AtomicBool + tokio::Notify）：cancel_agent_skill 置位并 notify_waiters()，引擎在 SSE 流读取与 HTTP 发送两个阻塞点经 tokio::select! 即时中断——不再等待 60s 行超时或下一个 chunk；被放弃 的流读取随即 drop、连接关闭，服务端停止生成；取消路径不再补发 done 事件（engine.rs 可验证）。

memory/store.py 的 memories 表无行数上限，relevance_score 随时间衰减但从不删除。长期使用会产生大量低分记忆，拖慢检索（每次取 50 条候选全量打分）。

建议：定期清理 relevance_score 低于阈值且超过 N 天未命中的记忆；或按 (book_id, skill_type) 限制上限。

状态：✅ 已修复（2026-09-05，Phase 3 收口）。commands/agent/memory.rs 新增：

• last_hit_at 列（db/mod.rs 迁移 + schema.rs 校验），检索命中时打点记录最近注入时间；
• prune_memories(conn, book_id, skill_type)：分组上限 60 条/(book_id, skill_type)（超出按 相关度低 → 久未命中 → 后插入淘汰）、全书上限 240 条（组清理后兜底）、超过 180 天 未命中的记忆过期删除；
• 每次自动保存新记忆后随路清理（extract_and_save），应用启动时 prune_all_memories 兜底清理存量（lib.rs setup，幂等）。

9877（Agent）/ 9876（Bridge）散落于 config.py、bridge.rs、manager.rs 及 CSP 配置（tauri.conf.json:28）。虽支持环境变量覆盖，但前端 CSP 中的端口是硬编码的，改端口需同步修改多处。

建议：统一由 Rust 侧动态分配空闲端口并注入 Python 环境变量，CSP 改用运行时注入。

状态：✅ 已消除（2026-09-05 复核）。9876/9877 随 v1.1 Rust 原生引擎迁移全部删除， 当前无任何端口监听/CSP 端口条目，本问题前提已不存在。

agent/ 已提供 pyproject.toml + uv.lock，配合 scripts/setup-agent.ts 创建 .venv 并校验，依赖可复现。

状态：✅ 已满足。

「状态」列为 2026-08-31 复核 + v1.0.1 安全加固后的结果（✅ 已修复 / 🟡 部分修复 / ❌ 未修复 / ⚪ 待确认）。

路线图已按 2026-08-31 复核结果重排：只保留仍未关闭的问题，已完成的（FTS5 触发器、Vite chunk、OutlinePanel 初步拆分）不再占用排期。

剩余与安全相关的未决项：Bridge Server（9876）Token 鉴权（问题 27，需代码改动 + 协议变更，已移至 Phase 2）。

1. 为 Bridge Server（9876）增加 Token 鉴权（问题 27） ✅ 已消除：v1.1 迁移 Rust 原生引擎时 Bridge(9876)/Python(9877) 整体删除，无端口服务残留（2026-09-05 复核）
2. 补齐 book_service / world_card_service / snapshot_service 的事务保护（问题 1 收尾） ✅ 已完成（2026-09-05，v1.6.0）
3. 实现 /skills/cancel 真正的任务中断（问题 28） ✅ 已完成（2026-09-05）：CancelToken（Notify + select）即时中断，取消不再补发 done
4. beforeDevCommand / beforeBuildCommand 改为 pnpm run …（问题 21） ✅ 已完成（2026-09-05，v1.6.0）
5. 向量搜索加 LIMIT 分页加载（问题 13 缓解） ✅ 已由 sqlite-vec KNN 方案（O(k)）取代（2026-09-05）

1. 拆分 useAiChat 为 4 个职责单一的 hook（问题 6） ✅ 已完成（2026-09-05）： useAiChatMessages / useConversationSummarizer / useAgentChatStream + 主编排，主文件 483 → ~220 行
2. Zustand slice 升级为真正独立的 store（问题 3 收尾） ✅ 已完成（2026-09-05）： booksStore / aiStore / preferencesStore 三个独立实例，appStore.ts 保留为出口 + 跨域选择器（import 路径兼容）
3. 全局快捷键系统（问题 23） ✅ 已完成（2026-09-05）：useShortcut + SHORTCUT_DEFS 注册表；mod+s 保存 / Escape 专注 / mod+shift+p 命令面板已迁移
4. 离线草稿保护（问题 22） ✅ 已完成（2026-09-05）：RichTextEditor 击键即写 sessionStorage（mi_draft: 前缀），入库清除，加载自动恢复并提示
5. DraggableVolume / DraggableChapter / MessageBubble 加 React.memo（问题 15） ✅ 已完成（2026-09-05）：两个 Draggable 已 memo；OutlinePanel 行渲染抽 OutlineListRow memo 边界 + 处理器 useCallback 稳定化
6. 记忆库容量上限与过期清理（问题 29） ✅ 已完成（2026-09-05）：分组 60 / 全书 240 / 180 天未命中过期 + last_hit_at 命中打点，随保存与启动自动清理

本阶段既有的「离线可实施」清单已全部落地；路线图收口。 剩余候选（sqlite-vec 迁移已完成一次、Bridge Server Token 鉴权等）多为跨版本演进项，另见问题 27 附注。

1. 动态 SQL 构建抽取为宏/泛型函数（问题 17） ✅ 已完成（2026-09-05）： utils.rs 新增 DynamicUpdate 构建器（String / i64 / JSON 混合 + 自动 updated_at/id 条件）， book_service::update_book 与 world_card_service::update_world_card 已收敛复用
2. sqlite-vec / LanceDB 迁移，彻底解决向量检索内存问题（问题 13） ✅ 已完成（2026-09-05，vec0 镜像 + KNN）
3. AI 对话导出为 Markdown / JSON（问题 25） ✅ 已完成（2026-09-05）： conversationExport.ts（plugin-dialog 选路径 + plugin-fs 写入）；AiSidePanel「导出」菜单提供 .md（含思考过程折叠块与 token 统计）与 .json（完整结构化）两种格式
4. Linux 构建目标（deb / AppImage）（问题 26） ✅ 已完成（2026-09-05）： tauri.conf.json bundle targets 增补 deb / appimage
5. 写作统计面板：日更进度条、连续天数、字数曲线（问题 24） ✅ 已完成（2026-09-05）： 新增 writing_stats 按日净增表（保存章节随路累计）+ get_writing_stats 命令； 状态栏 WritingStatsPanel：日更进度条 / 连续天数 / 近 30 日迷你柱状图
6. Agent 端口动态分配（问题 30） ✅ 已消除：9876/9877 已随 v1.1 迁移全部删除，无端口可分配

MirageInk/
├── src/                          # React 前端
│   ├── components/
│   │   ├── ai/                   # AI 助手组件
│   │   ├── common/               # 通用组件
│   │   ├── editor/               # 编辑器组件
│   │   ├── layout/               # 布局组件
│   │   ├── library/              # 书籍库组件
│   │   └── outline/              # 目录/大纲组件
│   ├── hooks/                    # 自定义 Hooks
│   ├── lib/                      # 工具库 & IPC 桥接
│   ├── pages/                    # 页面组件
│   ├── plugins/                  # 插件系统
│   ├── router/                   # 路由配置
│   ├── stores/                   # 状态管理 (Zustand + Jotai)
│   ├── styles/                   # 全局样式
│   └── types/                    # TypeScript 类型定义
├── src-tauri/                    # Rust 后端
│   └── src/
│       ├── commands/             # Tauri IPC 命令层
│       ├── db/                   # 数据库层 (Schema + Migration)
│       ├── models/               # 数据模型
│       ├── repositories/         # 数据访问层
│       └── services/             # 业务逻辑层
├── docs/                         # 项目文档
├── product/                      # 产品资源
├── scripts/                      # 构建/工具脚本
├── package.json                  # 前端依赖
└── vite.config.ts                # Vite 构建配置