chore: checkpoint pi lab rust integration work

design/03-rust-web/done/3-13-rust-web-local-markdown-gfm-ast-parser-migration-v1.md

@@ -12,6 +12,7 @@
 > - `/mnt/Data1T/mnote/rust/crates/mnote-web/src/routes/web_shell.rs`
 > - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-21-local-folder-convex-unified-tree-source-v1.md`
 > - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-22-local-folder-convex-unified-tree-execution-checklist-v1.md`
+> - `/mnt/Data1T/mnote/design/07-ai/process/7-14-online-local-ai-markdown-editing-convergence-v1.md`
 
 ## 1. 结论
 
@@ -64,6 +65,17 @@
 
 - 不把 tree/domain、Convex 或 editor island 的所有语义一起重写。
 
+### 4.5 本地文件 AI 工具接入（关联 7-14）
+
+> 按 7-14，本地 `.md` 文件应通过 `mnote.doc.fetch(format: "markdown")` 供 AI 读取，通过 `mnote.doc.markdown_edit` 供 AI 写入。本方案的 GFM AST → markdown 序列化层是 AI 写入本地文件的关键依赖。
+
+- AI 读取：`mnote.doc.fetch` 的 `source` 检测到本地文件路径时，直接返回 `.md` 原文（不经 AST 解析）。
+- AI 写入：`mnote.doc.markdown_edit` 对本地文件执行 markdown 级搜索替换后，通过本方案的 markdown 序列化层写回文件系统。
+- 不要求本地文件维护 blockId。AI 编辑基于文本，不基于块结构。
+- 本地文件的 AI 写入适配器（`LocalFSAdapter`）复用 `local_folder_source.rs` 的写链路。
+
+本接入点不改变本方案的解析/序列化核心设计，仅在其上增加 AI 工具消费层。
+
 ## 5. 方案比较
 
 ### 方案 A：继续扩写手写 parser