docs: codify fallback retirement direction

2026-05-10 08:46:43 +08:00
parent b7ceb7afae
commit 2f9ef85350
16 changed files with 616 additions and 63 deletions
@@ -58,7 +58,7 @@
 - **Web 承载层：`axum`**
 - **页面渲染模型：`Leptos Islands`**
 - **AI 执行面：`mnote-cli`**
- **最后保留的重编辑兼容孤岛：少量编辑器 runtime（当前默认主编辑器已是页面内 `leptos-tiptap` island，`BlockNote` 仅保留为 fallback / 对照链）**
+- **最后保留的重编辑兼容孤岛：少量编辑器 runtime（当前默认主编辑器已是页面内 `leptos-tiptap` island，`BlockNote` 仅保留为 `recycle/` 历史参考副本）**

 一句话概括：

@@ -68,7 +68,7 @@

 当前真正难替代的主要是：

- 以 `BlockNote` fallback、转换链和剩余兼容保存链为代表的重编辑 runtime
+- 以旧 `BlockNote` 编辑器副本、转换链和剩余兼容保存链为代表的重编辑 runtime

 而下面这些能力，从长期看都可以先退出当前大前端壳：

@@ -359,8 +359,8 @@ Leptos Islands 很适合承接下面这类长期目标：

 - `mnote-web` 已经不是只停留在 crate 骨架；`3000` 公开入口已由 Rust Web 主壳承接，`3104` 已退到仅显式 debug / internal 边界。
 - Rust Web 主壳已经接入 `/api/tree/events` snapshot / delta / resync consumer，双 pane 也已复用同一条 tree realtime 主链，而不是每个页面壳各自维护第二条流。
- 文档页读取已经进入 Rust-first `page aggregate` 过渡态：`/api/documents/page` 优先消费 Rust `/api/page-aggregate/:id` 的 `mnote.page_aggregate.v1` snapshot，失败时才回退 TS builder。
- 默认主编辑区已经切到页面内 `leptos-tiptap` island；阅读态、页头、页面设置和页面内 AI 面板都在 `3000` 主壳上继续收口，`BlockNote` 只保留为 fallback / 对照链。
+- 文档页读取已收口到 Rust `/api/page-aggregate/:id` 的 `mnote.page_aggregate.v1` snapshot；`/api/documents/page` 已降级为显式退场的 compat 边界，不再参与运行时主路径。
+- 默认主编辑区已经切到页面内 `leptos-tiptap` island；阅读态、页头、页面设置和页面内 AI 面板都在 `3000` 主壳上继续收口，`BlockNote` 只保留为 `recycle/` 历史参考 / 对照材料。
 - Sidebar 已形成“服务端首包 + 客户端局部 island”的最小边界，导航数据聚合契约不再散落在布局层。
 - SearchPalette 与页面级 AI 面板都已经收成轻 host + 按需 runtime island，重量运行态不再默认跟随主布局常驻。
 - Global AI 继续保留为实验入口，但不再回到 app layout 主链，避免长期路线再次滑回“全局大面板常驻”模式。