对齐 Wolai 侧栏体验并收拢设计入库

design/old/08-legacy-rust-kernel/done/ai-tool-cutover-matrix.md

@@ -0,0 +1,76 @@
+# [recycle] AI Tool Cutover Matrix
+
+> 更新时间：2026-04-16
+>
+> 目标：建立 `builtins` 到 Rust Tool registry 的一一对应矩阵，并明确每个工具当前的割接状态。
+
+## 1. 结论
+
+- 本文覆盖 `docsServerTools`、`mediaServerTools`、`mindmapServerTools`、`onlyofficeServerTools`、`registryBuiltins` 与 `ai-agent/run` 的一一对应关系。
+- `docs_search`、`docs_read` 已进入 Rust tool runtime；`ai-agent/run` 在 Convex 模式下直接通过 `executeRustBridgeTool(...)` 执行，`docsServerTools` 仅保留非 Convex / 兼容 fallback。
+- `search_web`、`image_read`、`slash_run` 已进入 Rust tool registry，TS 仅保留最小 transport 壳或数据加载壳。
+- `asset_extract_outline`、`asset_to_mindmap`、`oo_*` 继续保留 TS transport / 产品编排边界，但 `asset_to_mindmap` 的真正导图写入已收口到 Rust `mindmap_apply_ops`。
+- AI 工具链的运行态证据已经补齐：`wolai-frontend/src/lib/ai-agent/runtime/runAgent.test.ts` 已验证 `docs_search -> docs_read` 的 runtime 调用顺序与事件流。
+
+## 2. 一一对应矩阵
+
+| builtin tool | Rust toolset | Rust tool name | 当前状态 | 说明 |
+| --- | --- | --- | --- | --- |
+| `search_web` | `toolset.readonly` | `search_web` | `RUST_OWNER` | 联网检索已完全切到 Rust runtime，TS route 只保留 transport 壳。 |
+| `image_read` | `toolset.media_read` | `image_read` | `RUST_OWNER` | 图片/附件 OCR 结果已由 Rust runtime 统一归一化，TS 仅负责最小 transport 取数。 |
+| `slash_run` | `toolset.slash_write` | `slash_run` | `RUST_OWNER` | Rust 负责命令解析与结果标准化，TS 只保留创建/重命名 transport 写壳。 |
+| `docs_search` | `toolset.docs_read` | `docs_search` | `RUST_OWNER` | Convex 主链已改为 Rust runtime 执行搜索与结果归一化，TS 仅负责拉取搜索数据集 transport。 |
+| `docs_read` | `toolset.docs_read` | `docs_read` | `RUST_OWNER` | Convex 主链已改为 Rust runtime 执行裁剪与结果归一化，TS 仅负责读取目标文档 transport。 |
+| `rag_lightrag_query` | `toolset.rag_read` | `rag_lightrag_query` | `TS_TRANSPORT_KEEP` | 依赖外部 LightRAG 服务，不在本轮切换主线。 |
+| `asset_extract_outline` | `toolset.onlyoffice_read` | `asset_extract_outline` | `TS_TRANSPORT_KEEP` | 仍需附件下载和 MinerU 解析，长期保留 TS transport / 外部服务编排。 |
+| `asset_to_mindmap` | `toolset.onlyoffice_write` | `asset_to_mindmap` | `TS_TRANSPORT_KEEP` | 附件大纲提取仍依赖 TS/MinerU，但真正的导图写入已经改走 Rust `mindmap_apply_ops`。 |
+| `oo_get_selection` | `toolset.onlyoffice_editor` | `oo_get_selection` | `TS_TRANSPORT_KEEP` | 客户端插件内执行，Web 侧只做回传。 |
+| `oo_replace_selection` | `toolset.onlyoffice_editor` | `oo_replace_selection` | `TS_TRANSPORT_KEEP` | 客户端插件内执行，Web 侧只做回传。 |
+| `oo_insert_text` | `toolset.onlyoffice_editor` | `oo_insert_text` | `TS_TRANSPORT_KEEP` | 客户端插件内执行，Web 侧只做回传。 |
+| `oo_insert_html` | `toolset.onlyoffice_editor` | `oo_insert_html` | `TS_TRANSPORT_KEEP` | 客户端插件内执行，Web 侧只做回传。 |
+| `oo_insert_image` | `toolset.onlyoffice_editor` | `oo_insert_image` | `TS_TRANSPORT_KEEP` | 客户端插件内执行，Web 侧只做回传。 |
+
+## 3. Rust registry 对照
+
+- `toolset.readonly`：`search_web`
+- `toolset.media_read`：`image_read`
+- `toolset.slash_write`：`slash_run`
+- `toolset.docs_read`：`docs_search`、`docs_read`
+- `toolset.rag_read`：`rag_lightrag_query`
+- `toolset.onlyoffice_read`：`asset_extract_outline`
+- `toolset.onlyoffice_write`：`asset_to_mindmap`
+- `toolset.onlyoffice_editor`：`oo_*`
+
+## 4. 本轮 cutover 结果
+
+本轮已完成：
+
+- 以 `ai-agent/run` 为统一入口，对齐 `registryBuiltins` 与服务端 builtin 实现，避免再长出第二套工具分发表。
+- 把 `docs_search`、`docs_read`、`search_web`、`image_read`、`slash_run` 接到 Rust tool runtime，并在代码侧绑定里冻结为 Rust owner。
+- 把 `asset_to_mindmap` 收口为“TS 提纲提取 + Rust 导图写入”的明确边界，不再保留模糊的 `TS_COMPAT_PENDING` 口径。
+- 保留 `oo_*`、`client-tool-result`、`asset_extract_outline` 这类长期 `TS_TRANSPORT_KEEP` / 产品编排壳。
+
+## 5. 后续维护边界
+
+- `docsServerTools` 继续只服务于非 Convex / fallback 模式，不再承担 Convex 主链真执行。
+- `asset_extract_outline` 若未来要继续 Rust 化，应只处理解析链迁移，不涉及当前 Rust tool runtime 的 owner 边界回退。
+- `asset_to_mindmap` 若未来继续下沉，可进一步把“大纲转导图 ops”的编排逻辑迁入 Rust；在此之前，它已经是明确的 `TS_TRANSPORT_KEEP`。
+- `oo_*` 继续保持客户端插件边界，只通过 `/api/ai-agent/client-tool-result` 回传结果。
+
+## 6. 第一批 TS_LEGACY_DELETE 清单
+
+以下旧面已经满足“先停写、再切调用方、最后删除”的文档准备条件，应纳入第一批 `TS_LEGACY_DELETE`：
+
+- `documents/create-child`
+- `documents/embed`
+- `documents/empty-trash`
+- `documents/purge`
+- `documents/template`
+- `mindmap-trash/empty`
+- `builtins/**`
+
+删除原则：
+
+- `documents/create-child`、`documents/embed`、`documents/empty-trash`、`documents/purge`、`documents/template` 仅允许保留 route transport 壳，不再保留 route 内私有业务逻辑。
+- `mindmap-trash/empty` 需要在确认 Rust tool/runtime 与统一失败落账稳定后，删除 TS 旧实现。
+- `builtins/**` 中已经被 Rust tool runtime 接管的服务端真入口，应先收口到 `ai-agent/run` 或 Rust runtime，再物理删除 legacy helper。

design/old/08-legacy-rust-kernel/done/mindmap-onlyoffice-boundary.md

@@ -0,0 +1,132 @@
+# [recycle] Mindmap 与 OnlyOffice 当前边界说明
+
+> 更新时间：2026-04-14
+>
+> 主仓：`/mnt/Data1T/mnote`
+
+## 1. Mindmap 当前主链
+
+### 1.1 主组件与嵌入链路
+
+- 主组件：`/mnt/Data1T/mnote/wolai-frontend/src/components/editor/blocks/MindmapBlock.tsx`
+- BlockNote 注册入口：`/mnt/Data1T/mnote/wolai-frontend/src/components/editor/schema.ts`
+- 独立全屏页：`/mnt/Data1T/mnote/wolai-frontend/src/app/mindmap/[docId]/[mindmapId]/page.tsx`
+
+当前事实：
+
+- `MindmapBlockView` 同时服务文档内嵌块与独立全屏页。
+- 独立页通过 `editorStub` 复用同一组件，不额外复制第二套思维导图主壳。
+- 文档内嵌与独立页共用同一套工具栏、侧栏、导航器、缩略图与上下文菜单子组件。
+
+### 1.2 数据入口与 ops 边界
+
+- 本地读写入口：`/mnt/Data1T/mnote/wolai-frontend/src/lib/mindmap/mindmapLocalStore.ts`
+- 节点操作入口：`/mnt/Data1T/mnote/wolai-frontend/src/lib/mindmap/mindmapOps.ts`
+- 页面 API：
+  - `/mnt/Data1T/mnote/wolai-frontend/src/app/api/mindmap/[docId]/route.ts`
+  - `/mnt/Data1T/mnote/wolai-frontend/src/app/api/mindmap/[docId]/[mindmapId]/route.ts`
+
+当前拆分：
+
+- 前端交互状态保留在 `MindmapBlock.tsx` 及其子组件内。
+- 本体数据读写由 `mindmapLocalStore.ts` 提供本地文件落盘兼容接口。
+- 节点增删改、引用、注释、链接等操作由 `mindmapOps.ts` 统一描述为 `MindmapOp`。
+- 页面 API 当前通过 Convex `api.mindmaps.*` 承接 `get/put/restore/purge`，保留现有前端形态不变。
+- 当前 Mindmap API 已补统一元信息口径：
+  - `pageId = documentId`
+  - `attachmentId = mindmapId`
+  - `workspaceId` 统一来自页面归属工作区
+  - `requestId/traceId` 统一从请求头透传或在路由侧兜底生成
+
+### 1.3 后续 adapter 目标
+
+后续若进入 Rust adapter，只抽象以下边界，不复制历史仓 UI：
+
+- 节点树结构
+- 节点引用 `refs`
+- 节点操作日志 `MindmapOp`
+- mindmap 与 page/block 的绑定关系
+
+## 2. OnlyOffice 当前主链
+
+### 2.1 页面与 API 边界
+
+- 页面入口：
+  - `/mnt/Data1T/mnote/wolai-frontend/src/app/onlyoffice/page.tsx`
+  - `/mnt/Data1T/mnote/wolai-frontend/src/app/onlyoffice/OnlyOfficeClientPage.tsx`
+- 页面侧面板：
+  - `/mnt/Data1T/mnote/wolai-frontend/src/components/onlyoffice/OnlyOfficeAiAgentPanel.tsx`
+- API 边界：
+  - `/mnt/Data1T/mnote/wolai-frontend/src/app/api/onlyoffice/sign/route.ts`
+  - `/mnt/Data1T/mnote/wolai-frontend/src/app/api/onlyoffice/proxy/route.ts`
+  - `/mnt/Data1T/mnote/wolai-frontend/src/app/api/onlyoffice/callback/route.ts`
+  - `/mnt/Data1T/mnote/wolai-frontend/src/app/api/onlyoffice/forcesave/route.ts`
+
+当前拆分：
+
+- `page.tsx` 负责页面级早期 DOM 补丁与容器加载。
+- `OnlyOfficeClientPage.tsx` 负责编辑器初始化、内部请求改写、代理地址适配与 callback URL 组装。
+- `sign` 负责 JWT 签名。
+- `proxy` 负责同源代理与回源 URL 安全限制。
+- `callback` 负责保存回写存储。
+- `forcesave` 负责触发文档服务器强制保存。
+
+### 2.2 与正文和附件的关系
+
+- Office 文件入口仍来自 `MediaBlock`：`/mnt/Data1T/mnote/wolai-frontend/src/components/editor/blocks/MediaBlock.tsx`
+- 正文里只保留附件块与跳转入口，不在 BlockNote 内直接运行 OnlyOffice 编辑器。
+- OnlyOffice 编辑器继续在独立 `/onlyoffice` 页面运行。
+- 当前 OnlyOffice 已稳定使用：
+  - `documentId` 作为页面业务标识
+  - `assetId` 作为附件业务标识
+  - 页面归属仍由文档/附件在 Convex 中的 `workspace_id` 与 `document_id` 决定
+
+## 2.5 与 Mindmap 对齐后的共享标识口径
+
+- 页面标识：
+  - Mindmap 使用 `pageId/documentId`
+  - OnlyOffice 使用 `documentId`
+- 附件标识：
+  - Mindmap 使用 `attachmentId/mindmapId`
+  - OnlyOffice 使用 `assetId`
+- 页面归属：
+  - 两者都以 Convex 中的 `workspace_id + document_id` 作为最终归属真相
+- 追踪字段：
+  - Mindmap API 已返回 `requestId/traceId`
+  - OnlyOffice 页面当前通过查询参数与调试上下文持有 `assetId/documentId/userId`，后续若接入统一 Rust adapter，继续沿用同一页面/附件口径
+
+### 2.3 静态资源边界
+
+- 根目录静态资源保留在 `/mnt/Data1T/mnote/src/components/onlyoffice/`
+- 当前已确认存在：
+  - `onlyoffice-web-apps/`
+  - `onlyoffice-plugins/`
+  - `onlyoffice-data/`
+
+这些目录继续保留为运行所需静态资源、插件和数据目录，不做迁移式替换。
+
+### 2.4 后续 adapter 目标
+
+后续若进入 Rust adapter，只抽象以下边界：
+
+- 对象解析与附件定位
+- 签名生成
+- callback 写回
+- forcesave 触发
+- 代理回源请求
+
+## 3. 历史仓禁止误复制范围
+
+以下历史仓路径只作为参考，不进入主仓主线：
+
+- `/mnt/Data1T/mnote-rust/app/documents/[id]/mindmap/page.tsx`
+- `/mnt/Data1T/mnote-rust/app/documents/[id]/office/page.tsx`
+- `/mnt/Data1T/mnote-rust/components/sidebar/sidebar.tsx`
+- `/mnt/Data1T/mnote-rust/app/page.tsx`
+- `/mnt/Data1T/mnote-rust/app/onlyoffice/page.tsx`
+
+约束：
+
+- 不复制第二套对象页壳。
+- 不复制第二套 sidebar 壳。
+- `adapter-onlyoffice`、`adapter-mindmap` 继续作为后置实现项，而不是本阶段直接迁入主线。

design/old/08-legacy-rust-kernel/done/phase8-cutover-log-2026-04-15.md

@@ -0,0 +1,48 @@
+# [recycle] Phase 8 Cutover Log 2026-04-15
+
+## 概要
+
+- 完成 Phase 8 收口，Rust 已成为 mnote 的唯一业务执行平面。
+- 完成 `task-036` 到 `task-044`，并清空 harness 中全部历史失败/待办状态。
+- ONLYOFFICE 已升级到 `9.3.1`，真实页面打开、插件桥、callback、forcesave 回归通过。
+
+## 本轮关键变更
+
+### 1. 页面与对象主链
+
+- 页面旧面 `documents/create-child`、`documents/embed`、`documents/empty-trash`、`documents/purge`、`documents/template` 已收口到统一 adapter，route 仅保留 transport。
+- Mindmap 剩余旧面已接到 Rust mindmap adapter/tool，AI/Mindmap 写链失败态开始统一落账。
+- OnlyOffice sign/proxy/callback/forcesave 已固定为 `TS_TRANSPORT_KEEP`，对象规则与 session/sign/proxy/callback 准备由 Rust adapter 持有。
+
+### 2. AI 工具面
+
+- `search_web`、`image_read`、`slash_run` 已切到 Rust Tool runtime 主路径。
+- `ai-agent/run` 不再保留 `search_web` 的 TS fallback。
+- `mediaServerTools`、`slashServerTools` 已收缩为 transport helper，不再作为私有真入口。
+
+### 3. 统一观测与状态语义
+
+- 已补 workspace 级 bridge 总览查询。
+- 已补失败态、冲突态、补偿态第一批统一落账。
+- `bridge-log/runtime` 与页面主写链、AI/Mindmap 写链的状态语义开始对齐。
+
+### 4. 文档与清单
+
+- 已更新 `rust-kernel-cutover-v1.md`。
+- 已更新 `release-readiness-source-audit.md`。
+- 已更新 `rust-kernel-backport-phase-checklist.md`。
+- 已更新 `rust-kernel-missing-targets.md`。
+- 已新增 `rust-kernel-legacy-delete-list.md`。
+- 已更新 `ai-tool-cutover-matrix.md`。
+
+## 当前结论
+
+可以使用下面这句统一口径：
+
+> Rust 已成为 mnote 的唯一业务执行平面；Web route 只保留 transport、auth、session、streaming、proxy 与 callback 壳。
+
+## 后续建议
+
+- 执行第一批 `TS_LEGACY_DELETE` 的物理删除。
+- 继续压缩 `builtins/**` 中剩余的 TS 兼容实现。
+- 对 OnlyOffice、Mindmap 和 AI 工具链做一轮发布前运行态回归复核。

design/old/08-legacy-rust-kernel/done/release-readiness-source-audit.md

@@ -0,0 +1,193 @@
+# [recycle] 发布前源代码审计
+
+> 更新时间：2026-04-16
+>
+> 审计范围：`/mnt/Data1T/mnote`
+
+## 1. Bridge 入口与日志回查
+
+### 1.1 最小查询与写入入口
+
+当前已确认的 bridge 主线入口：
+
+- 查询：
+  - `src/app/api/documents/content/route.ts`
+  - `src/app/api/documents/meta/route.ts`
+  - `src/app/api/sidebar/route.ts`
+- 写入：
+  - `src/app/api/documents/title/route.ts`
+  - `src/app/api/documents/stats/route.ts`
+  - `src/app/api/documents/options/route.ts`
+  - `src/app/api/documents/save/route.ts`
+  - `src/app/api/blocks/patch/route.ts`
+  - `src/app/api/onlyoffice/callback/route.ts`
+
+### 1.2 日志与事件落账
+
+当前已确认：
+
+- `src/lib/documents/metadata-command-adapter.ts` 成功路径会调用 `recordBridgeCommandArtifacts`
+- `src/lib/documents/save-command-adapter.ts` 成功路径会调用 `recordBridgeCommandArtifacts`
+- `src/app/api/blocks/patch/route.ts` 成功路径会调用 `recordBridgeCommandArtifacts`
+- `src/lib/documents/media-asset-command-adapter.ts` 会在 ONLYOFFICE callback 成功写回后尝试复用同一 bridge log 落账
+- `src/lib/documents/bridge-log.ts` 会同时写入：
+  - `bridgeLogs.recordCommandLog`
+  - `bridgeLogs.recordDomainEvent`
+- 回查入口：
+  - `src/app/api/bridge/request/route.ts -> bridgeLogs.listByRequest`
+  - `src/app/api/bridge/trace/route.ts -> bridgeLogs.listByTrace`
+
+结论：
+
+- bridge 的最小查询、最小写入、日志生成、事件生成和错误返回已经形成源码闭环。
+
+## 2. 保存口径审计
+
+当前正文与页面元信息主写链如下：
+
+- `documents.save -> api.documents.updateContent`
+- `documents.title.update -> api.documents.updateTitle`
+- `documents.stats.update -> api.documents.updateStats`
+- `documents.options.update -> api.documents.updateOptions`
+- `blocks.patch -> 读取文档内容后回写 api.documents.updateContent`
+
+OnlyOffice 写回：
+
+- `src/app/api/onlyoffice/callback/route.ts -> media.assets.replace_storage -> api.mediaAssets.replaceStorageFromUpload`
+
+结论：
+
+- 页面正文、页面元信息、块补丁与 OnlyOffice 附件写回最终都以 Convex mutation 为主事实写入点。
+- 当前未发现把页面/块主真相改写到 `mnote-rust`、本地缓存目录或其他派生目录的主写链。
+
+## 3. `trace_id` / `request_id` / `workspace_id` / `page_id` 一致性
+
+### 3.1 前端与 route
+
+- `buildDocumentBridgeContext()` 统一生成 `requestId`、`traceId`、`workspaceId`
+- `buildDocumentBridgeContextWithActor()` 可为 ONLYOFFICE callback 这类无用户 cookie 的服务端回调显式注入 `actor/source`
+- `buildDocumentCommandEnvelope()` 统一挂载 `commandId`、`target.pageId`
+- `documents.title/stats/options/save` 均将 `normalizedDocumentId` 作为 `target.pageId`
+- `onlyoffice/callback` 会把 `asset.document_id` 作为 `target.pageId`，并透传 `workspaceId`
+
+### 3.2 日志落账
+
+- `recordBridgeCommandArtifacts()` 使用同一 `context.requestId`、`context.traceId`
+- `workspaceId` 统一取 `target.workspaceId` 或 `context.workspaceId`
+- `targetPageId` 统一落到 command log
+- domain event payload 同时记录 `request_id`、`trace_id`、`command_id`、`command_name`
+
+### 3.3 当前辅助验证
+
+- `src/lib/documents/bridge.test.ts` 已覆盖：
+  - `target.pageId = doc_1`
+  - `executeSaveBridgeCommand` 成功路径会调用 `recordBridgeCommandArtifacts`
+  - 返回结果保留 `req_1`、`trace_1`
+- `src/app/api/onlyoffice/callback/route.test.ts` 已覆盖：
+  - callback 成功路径会调用 `executeMediaAssetWritebackBridgeCommand`
+  - `storageId`、`assetId`、`documentId`、`workspaceId` 会进入 `media.assets.replace_storage` envelope
+
+结论：
+
+- `trace_id`、`request_id`、`workspace_id`、`page_id` 在 route、adapter、bridge log、回查入口之间已有统一口径。
+
+## 4. 禁止事项复查
+
+### 4.1 不双仓并行
+
+- 主仓脚本与文档已统一指向 `/mnt/Data1T/mnote`
+- `wolai-frontend/src`、`wolai-frontend/convex`、`rust/` 下未发现直接依赖 `/mnt/Data1T/mnote-rust` 的运行时代码路径
+
+### 4.2 不跨仓链接
+
+- 排除 `node_modules`、`.next`、`.venv`、`rust/target` 等构建产物后，主仓源码范围内未发现跨仓符号链接
+
+### 4.3 不复制第二套产品前端壳
+
+- 主仓保留的是既有 `wolai-frontend` 主壳
+- 历史仓对象页壳与第二套 sidebar 仅在文档中被标记为禁止误复制范围
+
+### 4.4 不把对象页壳 / diagnostics / smoke 页带入主线
+
+- 当前主仓 `wolai-frontend/src/app` 下未发现新增的 `diagnostic` / `smoke` 页面目录
+- 历史仓相关页面已在边界文档中明确列入禁止误复制清单
+
+### 4.5 不散落多个 Rust 源码根
+
+- 主仓顶层 `Cargo.toml` 仅存在 `rust/Cargo.toml`
+- 其余 crate `Cargo.toml` 均位于 `rust/crates/*`
+
+## 5. 运行态复核结果与最终结论
+
+本审计只能关闭源码可验证项，但截至 2026-04-16，发布前运行态复核已经补齐五条直接证据：
+
+- 已复跑 `scripts/task019-document-ui-regression.js`，文档页标题、正文、保存、刷新、回查链通过。
+- 已复跑 `scripts/task021-mindmap-ui-regression.js`，Mindmap 全屏页的新增子节点、删除子节点、保存链、刷新回查与 `requestId/traceId` 元信息同步通过。
+- 已复跑 `scripts/task022-onlyoffice-ui-regression.js`，ONLYOFFICE `9.3.1` 基线下的打开、插件桥、callback 写回、forcesave 与 `storage_id` 变化通过。
+- 已通过 `pnpm exec vitest run src/lib/ai-agent/runtime/runAgent.test.ts`，补齐 `docs_search -> docs_read` 的 AI runtime 调用证据。
+- 已通过 `bash /mnt/Data1T/mnote/rust/scripts/task049-cli-smoke.sh`，补齐 CLI 主链的最小真实执行验收。
+
+当前已不再存在阻塞发布的 CLI / AI 运行态尾项。
+
+补充核验结果：
+
+- `cargo test --manifest-path /mnt/Data1T/mnote/rust/Cargo.toml -p mnote-cli -p bridge-runtime` 已通过。
+- `wolai-frontend` 相关定向 `eslint` 当前无 error，仅剩仓库既有 warnings，不构成本轮发布阻塞。
+
+仍然要求环境满足的前置条件：
+
+- 浏览器回归环境可访问 `http://127.0.0.1:3000`
+- `MNOTE_ONLYOFFICE_PROBE_DOCX=/tmp/mnote-onlyoffice-probe/probe.docx` 可用
+- 已登录态可通过 `/auth` 或测试账号快速登录建立
+
+## 6. 旧 TS 执行面割接清单
+
+当前源码审计之外，还需要看“哪些 TS route 还能留，哪些只是历史兼容”。
+
+本轮已新增：
+
+- `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/done/rust-kernel-cutover-v1.md`
+
+该文档已把主仓当前执行面明确分成四类：
+
+- `RUST_OWNER`
+- `TS_TRANSPORT_KEEP`
+- `TS_COMPAT_PENDING`
+- `TS_LEGACY_DELETE`
+
+其中当前仍需要长期观察但不再构成主链阻塞的旧面主要包括：
+
+- `src/app/api/documents/embed/route.ts`
+- `src/app/api/mindmap-ai/**`
+
+其中页面旧面在 2026-04-16 的最终口径如下：
+
+- `src/app/api/documents/create-child/route.ts` 已改走 `documents.create`
+- `src/app/api/documents/empty-trash/route.ts` 已改走 `documents.emptyTrashByWorkspace`
+- `src/app/api/documents/purge/route.ts` 已改走 `documents.purge`
+- `src/app/api/documents/template/route.ts` 已改走 `documents.template`
+- `src/app/api/documents/embed/route.ts` 已改走 `documents.save`，但目标页面插入位与 `pageReference` block 组装仍在 TS，因此继续按 `TS_COMPAT_PENDING` / 产品编排壳维护
+- `src/app/api/mindmap/[docId]/route.ts` 与 `src/app/api/mindmap/[docId]/[mindmapId]/route.ts` 的 `DELETE/PATCH` 已改走 `mindmaps.delete/restore/purge`
+- `src/app/api/mindmap-trash/empty/route.ts` 已改走 `mindmaps.emptyTrashByWorkspace`
+- `src/app/api/blocks/*` 现网主链实际统一走 `src/lib/blocks/block-command-adapter.ts`；`src/lib/documents/block-command-adapter.ts` 应视为遗留兼容 helper，而非现网主执行面
+- `src/app/api/ai-agent/run/route.ts` 的核心工具主链现在已经统一走 Rust tool runtime：`docs_search`、`docs_read`、`search_web`、`image_read`、`slash_run` 不再保留 TS 真执行兜底
+
+结论：
+
+- 当前可以说“Rust 已成为 mnote 的主业务执行平面”。
+- 仍保留的 TS 路径只剩 `TS_TRANSPORT_KEEP`、少量 `TS_COMPAT_PENDING` 产品编排壳与冻结的 `TS_LEGACY_DELETE` 清单。
+- 第一批 `TS_LEGACY_DELETE` 已不再阻塞这轮 release readiness；它们现在的要求是“保持纯壳 / 冻结 helper，不允许反向长出新的业务规则”。
+
+最终 release readiness 口径：
+
+- 若按源码审计口径：可以说明“Rust 已成为 mnote 的唯一业务执行平面”，同时明确仍保留 `TS_TRANSPORT_KEEP` 与少量产品编排壳。
+- 若按完整发布口径：文档页、Mindmap、OnlyOffice、AI runtime、CLI smoke 的 Phase 8 scoped gate 已闭合，可以给出最终完成结论。
+- 后续维护口径：剩余 `TS_TRANSPORT_KEEP` / `TS_LEGACY_DELETE` 只属于长期清理与边界维护，不再构成第二套业务执行平面。
+
+补记：
+
+- 2026-04-15 已复跑 `scripts/task019-document-ui-regression.js`，确认文档页标题、正文、保存与刷新回查通过。
+- 2026-04-15 已复跑 `scripts/task021-mindmap-ui-regression.js`，确认新增/删除节点、保存链、刷新回查与 `requestId` / `traceId` 元信息同步通过。
+- 2026-04-15 已复跑 `scripts/task022-onlyoffice-ui-regression.js`，在升级后的 ONLYOFFICE `9.3.1` 基线上确认 `oo_insert_text` 插件桥、`同步保存`、callback 写回与 `storage_id` 变化仍然通过；本次 callback 最终写回已不再由 route 直接调用 `api.mediaAssets.replaceStorageFromUpload`，而是先经 `media.assets.replace_storage` bridge 命令再落到 Convex。
+- 2026-04-16 已通过 `src/lib/ai-agent/runtime/runAgent.test.ts`，确认 `docs_search -> docs_read` 的运行态工具链顺序、事件流与结果归一化闭合。
+- 2026-04-16 已通过 `rust/scripts/task049-cli-smoke.sh`，确认 `sidebar/page/block/search/tool/mindmap` 主链 CLI 真实执行闭合。

design/old/08-legacy-rust-kernel/done/rust-backport-audit-inventory.md

@@ -0,0 +1,85 @@
+# [recycle] Rust 回迁资产审计清单
+
+> 更新时间：2026-04-14
+>
+> 主仓：`/mnt/Data1T/mnote`
+
+## 1. 本轮已确认的主仓 Rust 资产
+
+### 1.1 Workspace 根
+
+- `rust/Cargo.toml`
+- `rust/Cargo.lock`
+
+### 1.2 已并入主线的 crate
+
+- `rust/crates/core-domain/`
+- `rust/crates/core-protocol/`
+- `rust/crates/event-log/`
+- `rust/crates/storage-convex-bridge/`
+- `rust/crates/index-fts/`
+
+### 1.3 已并入主线的 Rust 设计文档
+
+- `rust/design/INDEX.md`
+- `rust/design/core/01-domain-model-v0.md`
+- `rust/design/core/02-command-query-tool-protocol-v0.md`
+- `rust/design/core/03-storage-event-indexing-v0.md`
+- `rust/design/core/04-onlyoffice-integration-boundary-v0.md`
+
+### 1.4 本轮新增的主仓设计文档
+
+- `design/rust-kernel-backport-plan.md`
+- `design/rust-kernel-backport-phase-checklist.md`
+- `design/rust-single-repo-maintenance-boundary.md`
+- `design/mindmap-onlyoffice-boundary.md`
+- `design/sidebar-rust-query-target.md`
+
+## 2. 当前仍未并入主线的目录
+
+以下目录当前未在主仓 `rust/` 内出现，仍保持后置状态：
+
+- `rust/crates/adapter-onlyoffice/`
+- `rust/crates/adapter-mindmap/`
+- `rust/crates/adapter-legacy-mnote/`
+- `rust/crates/mnote-cli/`
+- `rust/bridge/`
+- `rust/scripts/`
+- `rust/fixtures/`
+- `rust/tests/`
+
+## 3. 已确认没有误带入的历史噪音
+
+当前主仓 `rust/` 与根 `design/` 下未发现以下类型内容被直接带入主线：
+
+- 第二套 Next 页面壳
+- 历史 `diagnostics` 页面
+- `smoke` 页面
+- 历史仓 `.next/`、`.tmp/` 产物目录
+- `adapter-*` 与 `mnote-cli` 实现目录
+
+备注：
+
+- `rust/target/` 为本地编译产物，不属于回迁设计资产。
+- 发布前若需进一步清理编译产物，应单独征得用户同意，不在本轮处理。
+
+## 4. 主仓启动路径核对
+
+当前可验证的主仓入口如下：
+
+- 根目录热启动：`npm run desktop:hot`
+- 前端开发：`cd /mnt/Data1T/mnote/wolai-frontend && pnpm dev`
+- 后端开发：`cd /mnt/Data1T/mnote/wolai-backend && uvicorn app.main:app --reload --port 8000`
+- Rust 校验：`cargo --manifest-path /mnt/Data1T/mnote/rust/Cargo.toml ...`
+
+核对结果：
+
+- 根 `package.json` 的仓库级脚本只指向 `scripts/*.js`
+- `scripts/desktop-hot.js` 只从主仓根目录解析 `.env.all`
+- `scripts/desktop-hot.js` 只调起 `wolai-frontend/` 与 `wolai-backend/`
+- `AGENTS.md` 的常用开发命令也全部指向 `/mnt/Data1T/mnote`
+
+## 5. 当前结论
+
+- 主仓已具备“只进入 `/mnt/Data1T/mnote` 就能找到前端、后端、Rust、OnlyOffice 相关入口”的文档与脚本口径。
+- 本轮新增目录与文档均位于主仓 `design/` 或既有 `rust/` 主线下，未把 `mnote-rust` 的历史页面壳或构建噪音带入主线。

design/old/08-legacy-rust-kernel/done/rust-kernel-cutover-v1.md

@@ -0,0 +1,399 @@
+# [recycle] Rust 内核总割接方案 v1
+
+> 更新时间：2026-04-16
+>
+> 关联文档：
+> - `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/process/rust-kernel-replacement-roadmap-v1.md`
+> - `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/process/rust-kernel-missing-targets.md`
+> - `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/process/rust-kernel-backport-phase-checklist.md`
+> - `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/done/release-readiness-source-audit.md`
+
+## 1. 目的
+
+本文只回答一个问题：
+
+> **什么时候可以宣布“Rust 已成为 mnote 唯一业务执行平面”，以及宣布前必须退役哪些旧 TS 执行面。**
+
+这里的“退役”不等于“把所有 Next route 全删掉”。
+
+真正要退役的是：
+
+- TS route 内部承载的业务规则
+- TS 私有工具注册表里的第二套执行语义
+- 绕过 Rust command/query/tool 的直连 Convex 主链
+
+允许长期保留的是：
+
+- transport
+- auth
+- session
+- streaming
+- SSR / BFF
+- 第三方对象服务回调壳
+
+---
+
+## 2. 状态定义
+
+为了避免后续再出现“看起来迁了，实际上没迁”的模糊表述，本文统一使用下面四类状态。
+
+### 2.1 `RUST_OWNER`
+
+定义：
+
+- 核心业务规则已经进入 Rust command/query/tool/runtime
+- TS route 只做参数校验、鉴权、HTTP 包装、Convex transport 或第三方请求转发
+
+处理策略：
+
+- 允许继续保留 route 壳
+- 不允许再往 route 内加业务规则
+
+### 2.2 `TS_TRANSPORT_KEEP`
+
+定义：
+
+- 这条 route 本身不是业务真规则入口
+- 但因为浏览器会话、回调、上传下载、SSE、客户端桥等原因，需要长期保留在 Web 层
+
+处理策略：
+
+- 永久保留或长期保留
+- 只能承载 transport / session / proxy / callback
+
+### 2.3 `TS_COMPAT_PENDING`
+
+定义：
+
+- 当前已经有部分 Rust 接缝
+- 但仍存在 TS 业务拼接、对象规则或直连 Convex 的旧执行逻辑
+
+处理策略：
+
+- 不能宣布总割接完成
+- 必须继续迁到 Rust 后，才能降级为 `RUST_OWNER` 或 `TS_TRANSPORT_KEEP`
+
+### 2.4 `TS_LEGACY_DELETE`
+
+定义：
+
+- 该 route 或旧逻辑只服务于历史兼容、诊断、临时过渡或旧 UI
+- 一旦对应能力完成 Rust cutover 并切完调用方，就应删除
+
+处理策略：
+
+- 先停写
+- 再切调用
+- 最后物理删除
+
+---
+
+## 3. 当前总盘点
+
+## 3.1 页面系统
+
+### 已进入 `RUST_OWNER`
+
+- `wolai-frontend/src/app/api/documents/meta/route.ts`
+- `wolai-frontend/src/app/api/documents/content/route.ts`
+- `wolai-frontend/src/app/api/documents/title/route.ts`
+- `wolai-frontend/src/app/api/documents/stats/route.ts`
+- `wolai-frontend/src/app/api/documents/options/route.ts`
+- `wolai-frontend/src/app/api/documents/save/route.ts`
+- `wolai-frontend/src/app/api/documents/create/route.ts`
+- `wolai-frontend/src/app/api/documents/move/route.ts`
+- `wolai-frontend/src/app/api/documents/delete/route.ts`
+- `wolai-frontend/src/app/api/documents/restore/route.ts`
+- `wolai-frontend/src/app/api/documents/duplicate/route.ts`
+- `wolai-frontend/src/app/api/documents/copy-tree/route.ts`
+- `wolai-frontend/src/app/api/documents/create-child/route.ts`
+- `wolai-frontend/src/app/api/documents/empty-trash/route.ts`
+- `wolai-frontend/src/app/api/documents/purge/route.ts`
+- `wolai-frontend/src/app/api/documents/template/route.ts`
+
+判定依据：
+
+- 已统一走 `buildDocument(Command|Query)Envelope`
+- 已切到共享 page/metadata/save adapter 或 `resolveRustBridge*`
+- route 只剩 transport、鉴权、参数整理与 HTTP 返回
+- `create-child` 已改为复用 `documents.create`
+- `template`、`empty-trash`、`purge` 已补齐 Rust runtime/transport 映射，不再由 `page-command-adapter.ts` 直接调用 Convex mutation
+
+### 仍是 `TS_COMPAT_PENDING`
+
+- `wolai-frontend/src/app/api/documents/embed/route.ts`
+
+原因：
+
+- `embed` 已不再直接调用 `api.documents.updateContent`，最终写入已改走 `documents.save`。
+- 但目标页面插入点计算、`pageReference` block 组装仍在 TS 侧完成，尚未进入独立 Rust command 面。
+- 因此它已经摆脱“直连 Convex mutation”的假完成状态，但还不能宣布为完全 `RUST_OWNER`。
+
+处理结论：
+
+- 页面旧面中，`create-child`、`template`、`empty-trash`、`purge` 已转为统一 Rust transport。
+- `embed` 仍是 Phase 8 前需要继续清理的剩余页面旧面。
+- 当前仍不可直接物理删除这些 route 文件，必须先切完调用方并确认不再承载 TS 内容编排。
+
+---
+
+## 3.2 块系统
+
+### 已进入 `RUST_OWNER`
+
+- `wolai-frontend/src/app/api/blocks/get/route.ts`
+- `wolai-frontend/src/app/api/blocks/patch/route.ts`
+- `wolai-frontend/src/app/api/blocks/move/route.ts`
+- `wolai-frontend/src/app/api/blocks/embed/route.ts`
+
+判定依据：
+
+- 现网 route 实际统一走 `wolai-frontend/src/lib/blocks/block-command-adapter.ts`
+- `patch/move/embed` 已通过 `documents.save` 主链落盘，不再依赖 route 内直连 Convex mutation
+- route 仅保留 transport、参数校验与 HTTP 返回
+
+### 仍需冻结的兼容 helper
+
+- `wolai-frontend/src/lib/documents/block-command-adapter.ts`
+
+说明：
+
+- 该文件当前不再是 `/api/blocks/*` 的主调用链。
+- 它仍保留旧桥接 helper 语义，因此需要明确按兼容层冻结，不能再被当成“现网主执行面”继续扩展。
+
+### 可删的旧逻辑
+
+- 旧 `loadBlocks/saveBlocks` 私有执行路径
+- 任何绕过共享 block adapter 的 AI 文档写入旧实现
+
+处理结论：
+
+- 块系统主链已经满足“route 保留、旧业务逻辑退役”的前提
+- 后续只允许在 Rust block ops 上继续扩展
+
+---
+
+## 3.3 查询聚合与观测
+
+### 已进入 `RUST_OWNER`
+
+- `wolai-frontend/src/app/api/sidebar/route.ts`
+- `wolai-frontend/src/app/api/search/documents/route.ts`
+- `wolai-frontend/src/app/api/bridge/request/route.ts`
+- `wolai-frontend/src/app/api/bridge/trace/route.ts`
+
+### 仍是 `TS_TRANSPORT_KEEP`
+
+- `wolai-frontend/src/app/api/search/recent/route.ts`
+
+说明：
+
+- `search/recent` 当前只承担“打开页面后写最近访问记录”的 side-effect，不再承担搜索召回
+- 它可以长期保留在 Web 层，但必须明确不是搜索业务真入口
+
+### 当前仍缺
+
+- workspace 级统一观测总览
+- 分页、按对象过滤、按状态过滤
+- 完整失败态和冲突态的全链路落账
+
+---
+
+## 3.4 AI 与工具面
+
+### 已进入 `RUST_OWNER`
+
+- `wolai-frontend/src/app/api/ai-agent/run/route.ts` 中的 `doc_get`
+- `wolai-frontend/src/app/api/ai-agent/run/route.ts` 中的 `doc_find`
+- `wolai-frontend/src/app/api/ai-agent/run/route.ts` 中的 `doc_insert_blocks`
+- `wolai-frontend/src/app/api/ai-agent/run/route.ts` 中的 `doc_replace_range`
+- `wolai-frontend/src/app/api/ai-agent/run/route.ts` 中的 `docs_search`
+- `wolai-frontend/src/app/api/ai-agent/run/route.ts` 中的 `docs_read`
+- `wolai-frontend/src/app/api/ai-agent/run/route.ts` 中的 `search_web`
+- `wolai-frontend/src/app/api/ai-agent/run/route.ts` 中的 `image_read`
+- `wolai-frontend/src/app/api/ai-agent/run/route.ts` 中的 `slash_run`
+
+说明：
+
+- Convex 主链下，`ai-agent/run` 已直接通过 `executeRustBridgeTool(...)` 执行 `docs_search`、`docs_read`、`search_web`、`image_read`、`slash_run`。
+- `docsServerTools` 当前只保留非 Convex / fallback 模式，不再承担 Convex 主链真执行。
+- `search_web`、`image_read`、`slash_run` 已切到 Rust Tool runtime，`ai-agent/run` 不再保留 TS 真执行兜底。
+
+### 仍是 `TS_TRANSPORT_KEEP`
+
+- `wolai-frontend/src/app/api/ai-agent/client-tool-result/route.ts`
+- `wolai-frontend/src/lib/ai-agent/tools/builtins/onlyoffice/onlyofficeServerTools.ts` 中的 `asset_extract_outline`
+- `wolai-frontend/src/lib/ai-agent/tools/builtins/onlyoffice/onlyofficeServerTools.ts` 中的 `asset_to_mindmap`
+- `wolai-frontend/src/lib/ai-agent/tools/builtins/onlyoffice/onlyofficeServerTools.ts` 中的 `oo_*`
+- `wolai-frontend/src/lib/ai-agent/tools/builtins/rag/**`
+
+说明：
+
+- `client-tool-result` 只负责浏览器内客户端工具回传，不承担业务决策。
+- `asset_extract_outline` 仍依赖附件下载与 MinerU 解析，因此长期保留 TS transport / 外部服务编排。
+- `asset_to_mindmap` 当前属于“TS 提纲提取 + Rust 导图写入”的明确编排边界：附件解析仍在 TS/MinerU，但导图应用已改走 Rust `mindmap_apply_ops`。
+- `oo_*` 继续保持客户端插件边界，不再尝试下沉为第二套服务端真执行入口。
+
+### 仍是 `TS_COMPAT_PENDING`
+
+- `wolai-frontend/src/app/api/mindmap-ai/agent/route.ts`
+- `wolai-frontend/src/app/api/mindmap-ai/assets/route.ts`
+- `wolai-frontend/src/app/api/mindmap-ai/expand-node/route.ts`
+- `wolai-frontend/src/app/api/mindmap-ai/outline-to-mindmap/route.ts`
+
+处理结论：
+
+- AI builtins 主链已经完成从 `TS_COMPAT_PENDING` 到 `RUST_OWNER` / `TS_TRANSPORT_KEEP` 的最终归类。
+- `mindmap-ai/**` 若继续保留，必须明确只是上层产品编排，不能成为对象规则真入口。
+- AI 工具矩阵与第一批旧面删除清单分别见：
+  - `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/done/ai-tool-cutover-matrix.md`
+  - `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/done/rust-kernel-legacy-delete-list.md`
+
+---
+
+## 3.5 对象域
+
+### Mindmap：已进入 `RUST_OWNER`
+
+- `wolai-frontend/src/app/api/mindmap/[docId]/route.ts`
+- `wolai-frontend/src/app/api/mindmap/[docId]/[mindmapId]/route.ts`
+
+说明：
+
+- `GET/POST` 之前已在 Rust query/command 主链上。
+- 2026-04-15 起，`DELETE` 与 `PATCH(action=restore|purge)` 也已补齐 Rust runtime/transport 映射，不再由 route 直接调用 Convex mutation。
+
+### Mindmap：仍是 `TS_COMPAT_PENDING`
+
+- `wolai-frontend/src/app/api/mindmap-ai/**`
+
+### Mindmap：已进入 `RUST_OWNER` 的补充兼容入口
+
+- `wolai-frontend/src/app/api/mindmap-trash/empty/route.ts`
+
+说明：
+
+- `mindmap-trash/empty` 现已切到 `mindmaps.emptyTrashByWorkspace` Rust runtime/transport。
+- 该 route 仍保留为 Web transport 壳，但不再直接持有 TS 真执行。
+
+### OnlyOffice：已进入 `TS_TRANSPORT_KEEP`
+
+- `wolai-frontend/src/app/api/onlyoffice/sign/route.ts`
+- `wolai-frontend/src/app/api/onlyoffice/proxy/route.ts`
+- `wolai-frontend/src/app/api/onlyoffice/callback/route.ts`
+- `wolai-frontend/src/app/api/onlyoffice/forcesave/route.ts`
+
+说明：
+
+- 这四条路由因为 JWT、proxy、下载上传、第三方回调等原因会长期保留
+- 但对象规则、session 边界、签名、回写准备、forcesave 计划已进入 Rust adapter
+
+处理结论：
+
+- OnlyOffice 当前不是“可删除 route”，而是“保留 route 壳、禁止再长业务规则”
+
+---
+
+## 4. Phase 8 Cutover Gate
+
+只有下面四组 gate 同时满足，才能宣布“Rust 成为唯一业务执行平面”。
+
+### Gate A：页面、块、查询主链全部 Rust 持有
+
+要求：
+
+- `documents.*` 主链不再存在 TS 业务路由
+- `blocks.*` 主链不再存在第二套执行逻辑
+- `search.documents`、`sidebar.dataset.list`、`bridge request/trace/command` 全部走 Rust query/runtime
+
+### Gate B：对象域只保留 transport 壳
+
+要求：
+
+- Mindmap 主读写统一进入 Rust adapter
+- OnlyOffice 只保留签名、代理、回调、forcesave 等 transport 壳
+- 任何对象域规则都不再从 route 直连 Convex mutation 发展
+
+### Gate C：AI 与 CLI 共用同一工具面
+
+要求：
+
+- `ai-agent/run` 不再为核心工具保留 `builtins/**` 私有真入口
+- CLI 与 AI 调用同一组 Rust `Tool`
+- `event_replay`、`index_rebuild`、`bridge_*_get` 这组观测/恢复命令对 CLI、AI、Web 等价可用
+- `docs_search`、`docs_read`、`search_web`、`image_read`、`slash_run` 必须保持 `RUST_OWNER`
+
+### Gate D：旧 TS 兼容面完成物理退役或明确降级
+
+要求：
+
+- `create-child`、`embed`、`empty-trash`、`purge`、`template`、`mindmap-trash/empty` 等旧接口要么迁入 Rust，要么标记为废弃并从 UI 脱钩
+- `mindmap-ai/**` 若继续保留，必须明确只是上层产品编排，不能成为对象规则真入口
+- 旧 `docTools` / `mindmapTools` / 页面私有写入胶水不再允许继续扩展
+
+---
+
+## 5. 允许删除与禁止删除
+
+## 5.1 现在就禁止继续扩展的旧面
+
+- `documents/create-child`
+- `documents/embed`
+- `documents/empty-trash`
+- `documents/purge`
+- `documents/template`
+- `mindmap-trash/empty`
+- `mindmap-ai/**` 私有写入逻辑
+- `ai-agent` 中非 Rust 的核心编辑工具真入口
+
+规则：
+
+- 这些路径可以暂时存在
+- 但不允许再加新业务逻辑
+- 第一批 `TS_LEGACY_DELETE` 冻结清单见 `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/done/rust-kernel-legacy-delete-list.md`
+
+## 5.2 完成 cutover 后允许删除的旧面
+
+- 上述旧接口本身
+- 被 Rust adapter 替代后的旧 `builtins/**` 服务端工具实现
+- 任何只为过渡期保留的直接 Convex 业务拼接 helper
+
+当前已冻结的第一批删除对象：
+
+- `documents/create-child`
+- `documents/embed`
+- `documents/empty-trash`
+- `documents/purge`
+- `documents/template`
+- `mindmap-trash/empty`
+- `builtins/**`
+
+## 5.3 必须长期保留的壳
+
+- `/api/onlyoffice/sign`
+- `/api/onlyoffice/proxy`
+- `/api/onlyoffice/callback`
+- `/api/onlyoffice/forcesave`
+- `/api/ai-agent/client-tool-result`
+- 其他承担 auth/session/streaming/proxy/callback 的 Web route
+
+这些接口可以保留，但只能承担 Web transport 责任。
+
+---
+
+## 6. 最终宣布口径
+
+只有当本文第 4 节四组 gate 在主链范围内同时满足时，才允许对外使用下面这句话：
+
+> **Rust 已成为 mnote 的唯一业务执行平面；Web route 只保留 transport、auth、session、streaming、proxy、callback 与少量明确冻结的产品编排壳。**
+
+截至 2026-04-16：
+
+- `docs_search`、`docs_read`、`search_web`、`image_read`、`slash_run` 已满足 Gate C 的主链要求。
+- `bridge-log/runtime` 已补齐统一失败态、冲突态与补偿态的状态语义，页面主写链与 AI/Mindmap 写链已接入统一失败落账。
+- `mnote-cli` 已通过仓库内真实执行 smoke，CLI 与 AI 现在可以共用同一组 Rust Tool / runtime。
+- `TS_TRANSPORT_KEEP`、`TS_COMPAT_PENDING`、`TS_LEGACY_DELETE` 三类边界已经完成最终冻结，可作为后续发布与退役口径。
+
+现在可以统一表述为：
+
+> **Rust 已成为 mnote 的主业务执行平面；仍保留的 TS 代码只承担 transport、外部服务编排、客户端桥与冻结兼容壳责任。**

design/old/08-legacy-rust-kernel/done/rust-kernel-final-closure-checklist.md

@@ -0,0 +1,113 @@
+# [recycle] Rust 内核最终收尾详细清单
+
+> 更新时间：2026-04-16
+>
+> 关联文档：
+> - `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/done/rust-kernel-cutover-v1.md`
+> - `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/done/release-readiness-source-audit.md`
+> - `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/done/rust-kernel-legacy-delete-list.md`
+> - `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/done/ai-tool-cutover-matrix.md`
+
+## 1. 当前结论
+
+截至 2026-04-16，上一轮最终收尾里剩下的 CLI、AI runtime 与文档口径尾项已经闭合。
+
+现在这份清单不再是“还缺什么”，而是给出最终关闭结果：
+
+- 第一批 `TS_LEGACY_DELETE` 已经被压缩为“纯 transport 壳 / 冻结 helper / 明确删除清单”，不再允许继续长出第二套业务语义。
+- 页面、块、Mindmap、OnlyOffice 与 AI 工具主链已经完成最终收口，不再存在主链级别的“Rust 包装 + TS 真执行”假完成状态。
+- `mnote-cli` 已进入最小真实执行态，并且有可复跑的仓库内 smoke。
+- AI 工具矩阵里的 builtins 主链已经完成最终归类，不再保留模糊的 builtins 级 `TS_COMPAT_PENDING`。
+- 发布前运行态复核证据已经补齐，可以给出统一最终口径。
+
+---
+
+## 2. 尾项关闭结果
+
+### 2.1 第一批 `TS_LEGACY_DELETE`
+
+当前状态：已关闭为“冻结清单 + 纯壳边界”。
+
+结果：
+
+- `documents/create-child`、`documents/empty-trash`、`documents/purge`、`documents/template` 已进入统一 Rust transport / adapter 主链。
+- `mindmap-trash/empty` 已进入 Rust runtime / transport 主链。
+- `builtins/**` 中已被 Rust runtime 接管的服务端真入口，不再允许继续作为主执行面扩展。
+- `documents/embed` 与 `mindmap-ai/**` 这类仍保留的上层编排路径，必须按冻结边界维护，不能反向长出新的核心业务规则。
+
+验收结论：第一批旧面已经不再阻塞“Rust 成为主业务执行平面”的宣布口径。
+
+### 2.2 双路径执行清理
+
+当前状态：已关闭。
+
+结果：
+
+- 页面主写链、块主写链、Mindmap 删除/恢复/清空回收站、OnlyOffice callback/forcesave 均已切到 Rust command/query/tool/runtime 主链。
+- 旧 TS 侧保留的仅是 transport、外部服务编排或历史兼容 helper，不再是现网主真执行入口。
+- `src/lib/documents/block-command-adapter.ts` 明确被冻结为遗留兼容 helper；现网 `/api/blocks/*` 统一走 `src/lib/blocks/block-command-adapter.ts`。
+
+### 2.3 CLI 最小真实执行态
+
+当前状态：已关闭。
+
+结果：
+
+- `mnote-cli` 新增并稳定支持 `--execute` 真实执行模式。
+- 已修复 `block patch --execute` 的块树回写形状问题，`block move --execute` 不再因为内容快照损坏而失败。
+- 仓库内最小 smoke 已扩展到：
+  - `sidebar dataset`
+  - `page get/create/title/save/move/delete/restore`
+  - `block insert/patch/move/embed`
+  - `search documents`
+  - `tool run docs_search/docs_read`
+  - `mindmap put/get/op`
+- 运行命令：`bash /mnt/Data1T/mnote/rust/scripts/task049-cli-smoke.sh`
+- 验收产物会落盘到 `/tmp/task049-cli-smoke-*`，便于失败后回查逐步 JSON 输出。
+
+### 2.4 AI 工具矩阵收口
+
+当前状态：已关闭。
+
+结果：
+
+- `docs_search`、`docs_read` 已进入 Rust tool runtime；Convex 主链下 `ai-agent/run` 直接通过 `executeRustBridgeTool(...)` 执行，`docsServerTools` 仅保留 fallback。
+- `search_web`、`image_read`、`slash_run` 持续保持 `RUST_OWNER`。
+- `asset_extract_outline`、`asset_to_mindmap`、`oo_*` 已明确归类为 `TS_TRANSPORT_KEEP`，不再保留 builtins 级 `TS_COMPAT_PENDING`。
+- `asset_to_mindmap` 的真正导图写入已收口到 Rust `mindmap_apply_ops`；TS 侧仅保留外部解析与编排壳。
+
+### 2.5 发布前运行态复核
+
+当前状态：已关闭。
+
+截至 2026-04-16，已经具备以下运行态证据：
+
+- 浏览器回归：`scripts/task019-document-ui-regression.js`
+- 浏览器回归：`scripts/task021-mindmap-ui-regression.js`
+- 浏览器回归：`scripts/task022-onlyoffice-ui-regression.js`
+- AI runtime 证据：`pnpm exec vitest run src/lib/ai-agent/runtime/runAgent.test.ts`
+- CLI 主链证据：`bash /mnt/Data1T/mnote/rust/scripts/task049-cli-smoke.sh`
+- Rust 执行层证据：`cargo test --manifest-path /mnt/Data1T/mnote/rust/Cargo.toml -p mnote-cli -p bridge-runtime`
+
+补充说明：定向 `eslint` 当前无 error，仅剩仓库既有 warnings，不构成这轮收尾阻塞项。
+
+---
+
+## 3. 最终完成标准核对
+
+现在已经同时满足下面几条：
+
+- 第一批 `TS_LEGACY_DELETE` 已物理删除或明确冻结为不可扩展壳。
+- 仓库里不再存在主链级别的“Rust 包装 + TS 真执行”双路径假完成状态。
+- `mnote-cli` 已覆盖一批关键主链的真实执行，并具备仓库内可复跑 smoke。
+- AI 工具矩阵中的 builtins 主链已不再保留模糊的 `TS_COMPAT_PENDING`。
+- 发布前运行态复核已经重新通过。
+- 文档口径与代码现状可以统一到同一个最终结论。
+
+---
+
+## 4. 一句话结论
+
+现在可以把最后一阶段的结论收口为：
+
+> **Rust 已成为 mnote 的主业务执行平面；Web / TS 侧仅保留 transport、外部服务编排、客户端桥与明确冻结的兼容壳。**

design/old/08-legacy-rust-kernel/done/rust-kernel-legacy-delete-list.md

@@ -0,0 +1,73 @@
+# [recycle] Rust Kernel Legacy Delete List
+
+> 目标：给 Phase 8 第一批 `TS_LEGACY_DELETE` 提供固定清单，先停写并切调用方，再删除已被 Rust 替代的 TS 真入口。
+
+## 1. 第一批删除对象
+
+- `documents/create-child`
+- `documents/embed`
+- `documents/empty-trash`
+- `documents/purge`
+- `documents/template`
+- `mindmap-trash/empty`
+- `builtins/**`
+
+## 2. 删除前提
+
+- 页面旧面必须已经切到统一 page adapter 或 lifecycle adapter，route 仅剩 transport。
+- AI 核心工具必须已经切到 Rust Tool runtime 或 `ai-agent/run` 统一入口，不能再由 `builtins/**` 私下持有真执行面。
+- 统一 bridge-log 必须能记录失败态、冲突态与补偿态，避免删除旧面后失去回查能力。
+
+## 3. 删除策略
+
+### 3.1 页面旧面
+
+- `documents/create-child`
+- `documents/embed`
+- `documents/empty-trash`
+- `documents/purge`
+- `documents/template`
+
+策略：
+
+- 先冻结 route 内业务逻辑，确保所有调用方都走 adapter。
+- 保留 Web route 的 auth、参数校验和 HTTP transport。
+- 先继续清理 `page-command-adapter.ts` / `page-lifecycle-command-adapter.ts` 中残留的 TS 真执行。
+- 在前端调用方仍直接依赖这些 route，且 adapter 仍承载真实写入前，不得直接物理删除 route 文件。
+- 当 release audit 与 cutover gate 均确认无回退需求后，再物理删除历史 helper/分支。
+
+### 3.2 Mindmap 旧面
+
+- `mindmap-trash/empty`
+
+策略：
+
+- `mindmap-trash/empty` 现已切到 `mindmaps.emptyTrashByWorkspace` Rust runtime/transport。
+- 该 route 仍是兼容入口，但只保留 Web transport 壳，不再直接持有 TS 真执行。
+- 仍需确认 `task-042` 的失败/冲突/补偿落账和最终运行态回归稳定，再删除纯兼容分支。
+
+### 3.3 AI 工具旧面
+
+- `builtins/**`
+
+策略：
+
+- `search_web`、`image_read`、`slash_run` 这类已切到 Rust runtime 的工具，删除其服务端真入口，只保留必要 transport helper。
+- `client-tool-result` 与 `oo_*` 属于 `TS_TRANSPORT_KEEP`，不在本批物理删除范围。
+- `asset_extract_outline`、`asset_to_mindmap` 尚未完全 Rust 化，暂不从 `builtins/**` 整体删除，但必须禁止继续扩展新的私有真入口。
+
+## 4. 当前结论
+
+- 第一批 `TS_LEGACY_DELETE` 已完成清单冻结。
+- `documents/create-child`、`documents/embed`、`documents/empty-trash`、`documents/purge`、`documents/template`、`mindmap-trash/empty`、`builtins/**` 已被明确纳入 Phase 8 的旧面退役范围。
+- 截至 2026-04-15，这批对象中还没有可直接物理删除的 route 文件；当前可安全推进的是：
+  - 把 route 固定为纯 transport 壳。
+  - 把 adapter 内残留的 TS 真执行继续收口。
+  - 为每个旧面补齐调用方清单与“可删前置条件”。
+- 其中页面旧面已完成第一轮收口：
+  - `create-child` 已复用 `documents.create`
+  - `template`、`empty-trash`、`purge` 已补齐 Rust runtime/transport 映射
+  - `embed` 已切到 `documents.save`，但插入位计算与 `pageReference` block 组装仍在 TS
+- 因此页面旧面的主要残留已缩到 `wolai-frontend/src/lib/documents/page-command-adapter.ts` 中的 `embed` 内容编排，以及 `wolai-frontend/src/lib/documents/page-lifecycle-command-adapter.ts` 的历史兼容面。
+- `mindmap-trash/empty` 已不再由 route 直接调用 `api.mindmaps.emptyTrashByWorkspace`，但在调用方与最终运行态回归全部通过前，仍不满足物理删除条件。
+- 后续删除动作必须以 `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/done/rust-kernel-cutover-v1.md` 和 `/mnt/Data1T/mnote/design/old/08-legacy-rust-kernel/done/release-readiness-source-audit.md` 的最终 gate 为准。

design/old/08-legacy-rust-kernel/done/rust-single-repo-maintenance-boundary.md

@@ -0,0 +1,110 @@
+# [recycle] mnote 单仓维护边界约定
+
+> 更新时间：2026-04-14
+>
+> 主仓：`/mnt/Data1T/mnote`
+>
+> 历史仓：`/mnt/Data1T/mnote-rust`
+
+## 1. 主结论
+
+- 只保留 `/mnt/Data1T/mnote` 作为启动、规划、保存、验证的唯一主仓。
+- `/mnt/Data1T/mnote-rust` 只作为历史资产来源，不再承担主执行入口。
+- 任何新设计、执行清单、架构说明都优先写入 `/mnt/Data1T/mnote/design/` 或 `/mnt/Data1T/mnote/rust/design/`。
+
+## 2. 主仓执行入口
+
+- 根目录脚本入口只认 `/mnt/Data1T/mnote/package.json` 与 `/mnt/Data1T/mnote/scripts/`。
+- 当前 `package.json` 仅通过 `node scripts/*.js` 暴露仓库级入口，没有任何脚本要求先进入 `mnote-rust`。
+- 如需调用 Rust，统一使用 `cargo --manifest-path /mnt/Data1T/mnote/rust/Cargo.toml ...`，不从历史仓发起 Cargo 命令。
+- 当前 `scripts/desktop-hot.js` 已固定从主仓根目录解析 `.env.all`，并以 `wolai-frontend/`、`wolai-backend/` 作为唯一联调入口。
+
+## 3. `mnote-rust` 历史资料分类
+
+### 3.1 核心规范
+
+这些内容可作为协议与设计参考，但主线副本以 `/mnt/Data1T/mnote/rust/` 为准：
+
+- `design/blueprint/`
+- `design/core/`
+- `crates/core-domain/`
+- `crates/core-protocol/`
+- `crates/event-log/`
+- `crates/storage-convex-bridge/`
+- `crates/index-fts/`
+
+### 3.2 历史阶段
+
+这些内容保留为阶段记录，不作为当前实现依据：
+
+- `design/phases/**`
+- `design/execution/**`
+- `design/UI/**`
+- `design/mindmap/**`
+
+### 3.3 参考实现
+
+这些内容可用于盘点边界、提取协议或核对交互，但不能整块复制覆盖主仓：
+
+- `app/**`
+- `components/**`
+- `lib/**`
+- `convex/**`
+- `infra/onlyoffice/**`
+- `crates/mnote-cli/`
+- `crates/adapter-onlyoffice/`
+- `crates/adapter-mindmap/`
+- `crates/adapter-legacy-mnote/`
+
+### 3.4 错误方向
+
+以下内容明确不进入主仓主线：
+
+- 对象页壳与试验页：`app/page.tsx`、`app/onlyoffice/page.tsx`、`app/documents/**`
+- 第二套导航壳：`components/sidebar/sidebar.tsx`
+- 诊断与构建产物：`.next/diagnostics/**`、`.next/**`、`.tmp/**`
+- 仅用于历史 smoke/夹具的目录：`.tmp/phase7-test-fixtures/**`
+
+## 4. 主仓默认不动目录
+
+除非当前任务明确要求接线或修复，否则默认不扩写以下目录：
+
+- `/mnt/Data1T/mnote/wolai-frontend/`
+- `/mnt/Data1T/mnote/wolai-backend/`
+- `/mnt/Data1T/mnote/infra/convex/`
+- `/mnt/Data1T/mnote/src/components/onlyoffice/`
+- `/mnt/Data1T/mnote/recycle/`
+
+## 5. 最小维护约定
+
+### 5.1 Workspace 责任面
+
+- 入口文件：`/mnt/Data1T/mnote/rust/Cargo.toml`、`/mnt/Data1T/mnote/rust/Cargo.lock`
+- 维护范围：`/mnt/Data1T/mnote/rust/crates/*`
+- 要求：新增 crate、依赖调整、共享协议变更，必须先在主仓 workspace 内完成，不得回写到历史仓再反向复制。
+
+### 5.2 Bridge 责任面
+
+- 入口文件：`/mnt/Data1T/mnote/wolai-frontend/src/lib/documents/bridge.ts`
+- 相关边界：
+  - `/mnt/Data1T/mnote/wolai-frontend/src/lib/documents/metadata-command-adapter.ts`
+  - `/mnt/Data1T/mnote/wolai-frontend/src/lib/documents/save-command-adapter.ts`
+  - `/mnt/Data1T/mnote/wolai-frontend/src/app/api/documents/**`
+  - `/mnt/Data1T/mnote/wolai-frontend/src/app/api/sidebar/route.ts`
+  - `/mnt/Data1T/mnote/wolai-frontend/convex/bridgeLogs.ts`
+- 要求：新 command/query 先收口协议边界，再决定是否继续下沉到 Rust crate。
+
+### 5.3 接入链责任面
+
+- C1 页面元信息：`src/app/(app)/documents/[id]/page.tsx`、`src/components/editor/document-content.tsx`
+- C2 Sidebar 聚合：`src/components/sidebar/**`、`src/hooks/use-convex-sidebar-data.ts`、`src/lib/sidebar-data.ts`
+- C3 正文保存：`src/components/editor/blocknote-editor.tsx`、`src/app/api/documents/save/route.ts`
+- Phase D 边界：`src/components/editor/blocks/MindmapBlock.tsx`、`src/app/onlyoffice/**`、`src/app/api/onlyoffice/**`
+- 要求：优先改主仓现有链路，不复制历史仓页面壳替换现实现。
+
+## 6. 禁止误复制清单
+
+- 不把 `mnote-rust` 当成新的主执行仓。
+- 不复制第二套 Next 前端壳、对象页壳、diagnostics 页、smoke 页进入主线。
+- 不通过软链接、硬链接、跨仓路径偷接来伪装“已迁移”。
+- 不在主仓根目录散落多个 Rust 源码根。