chore: checkpoint pi lab rust integration work

design/07-ai/reference/7-12-page-ai-hermes-tool-routing-and-review-surface-v1.md

@@ -13,6 +13,7 @@
 > - `/mnt/Data1T/mnote/design/old/07-ai/process/7-10-page-block-ai-tooling-execution-checklist-v1.md`
 > - `/mnt/Data1T/mnote/design/07-ai/done/7-9-page-block-ai-tooling-roadmap-v1.md`
 > - `/mnt/Data1T/mnote/design/07-ai/done/7-6-mnote-hermes-plugin-tool-contract-v1.md`
+> - `/mnt/Data1T/mnote/design/07-ai/process/7-14-online-local-ai-markdown-editing-convergence-v1.md`
 > - `/mnt/Data1T/mnote/design/05-editor-mainline/reference-code/cli-main`
 > - `/mnt/Data1T/mnote/design/05-editor-mainline/reference-code/blocknote-ai`
 > - `/mnt/Data1T/mnote/design/05-editor-mainline/reference-code/tiptap-apcore`
@@ -52,6 +53,8 @@
 
 > **Hermes 继续作为唯一页面 AI agent runtime；mnote 提供 Agent-native editor command layer。**
 
+**新增（2026-05-16，按 7-14）**：AI 编辑的主路径应降维到 markdown 文本层。`mnote.doc.markdown_edit`（搜索替换文本对）是 AI 写入的主入口，覆盖 80%+ 场景；`mnote.block.*` 保留为结构性辅助。在线 Convex 文档和本地 `.md` 文件通过 `mnote.doc.fetch(format: "markdown")` + `mnote.doc.markdown_edit` 共用同一条 AI 写入路径。
+
 因此，`本地意图解析 + Rust apply` 必须被重新定义为：
 
 - Hermes 的工具路由提示层。
@@ -72,21 +75,13 @@
 
 ### 2.1 `/api/page-ai/block-edit-workflow` 方向需要收口
 
-当前 route 已证明低歧义中文块编辑可以很快完成：
+**当前口径修正（2026-05-16，按 7-14）**：
 
-```text
-local_rule -> mnote.doc.apply_block_ops -> Rust apply -> page readback
-```
+- `direct_block_edit_operations`（正则抠「」内文本的快路径）应退役。这不是 AI，是命令行。
+- `/api/page-ai/block-edit-workflow` 底层应切换到 `mnote.doc.markdown_edit`：用户自然语言 → 模型产出 search/replace 文本对 → markdown_edit apply。
+- 不再维持 direct path / model fallback 双路径，markdown_edit 是唯一主路径。
 
-但如果把这个 route 继续扩成 `PageAIIntentParser / OperationPlanner / ApplyController`，它会自然变成第二套 runtime：
-
-- 自己判断意图。
-- 自己调用模型。
-- 自己解析模型输出。
-- 自己决定 fallback。
-- 自己写入并展示结果。
-
-这会和 Hermes 的 session、profile、tool toggle、tool event、usage、audit、abort/retry 产生重叠。
+当前 route 对低歧义中文的加速效果不应成为保留一条非 AI 路径的理由。快路径作为 deterministic shortcut 的定位不变，但其实现必须改为调用 `mnote.doc.markdown_edit`，而不是绕过模型直接拼 operations。
 
 ### 2.2 模型直接输出 operations 仍不可靠
 
@@ -278,6 +273,8 @@ Browser Page AI panel
 
 替代当前继续扩大的 `block-edit-workflow` 概念。
 
+**新增（2026-05-16，按 7-14）**：Router 的 `recommendedToolCall` 主输出改为 `mnote.doc.markdown_edit`（search/replace 文本对），块级 `mnote.doc.apply_block_ops` 仅在明确的结构性编辑场景（拖拽排序等）下推荐。
+
 输入：
 
 - 用户 prompt。
@@ -290,28 +287,28 @@ Browser Page AI panel
 ```json
 {
   "schema": "mnote.page_ai_command_route.v1",
-  "intent": "direct_block_edit",
+  "intent": "markdown_edit",
   "confidence": 0.94,
   "recommendedToolCall": {
-    "toolName": "mnote.doc.apply_block_ops",
+    "toolName": "mnote.doc.markdown_edit",
     "args": {
       "operations": [
-        {"op": "replace", "matchText": "A", "content": "B"}
-      ],
-      "dryRun": true
+        {"search": "原文片段", "replace": "新文本"}
+      ]
     }
   },
   "risk": "low",
   "requiresHermesRun": false,
   "requiresReview": false,
-  "reason": "明确中文引号替换表达，目标文本唯一命中"
+  "reason": "明确文本替换表达，目标文本唯一命中"
 }
 ```
 
 规则：
 
-- 只覆盖低歧义命令。
-- 不能为复杂改写、总结、跨页面、多块结构化编辑直接生成写入。
+- 默认推荐 `mnote.doc.markdown_edit`（search/replace 文本对，AI 不需要理解 blockId）。
+- 仅在明确的结构性编辑场景（"把第三块拖到第一块后面"）推荐 `mnote.doc.apply_block_ops`。
+- 不能为复杂改写、总结、跨页面直接生成写入。
 - 不能调用第二套长链模型；如需模型，交给 Hermes run。
 - 输出必须可被 Hermes 当作 tool hint 消费。