docs: align runtime architecture guidance

This commit is contained in:
lix-2026
2026-05-26 07:29:15 +08:00
parent e1681331a3
commit 0a15595066
14 changed files with 134 additions and 35 deletions
+23 -1
View File
@@ -1,6 +1,12 @@
# 01-05 当前主线与优先级总览
> 更新时间:2026-05-22
> 更新时间:2026-05-26
>
> 2026-05-26 口径补充:
> - 前端 runtime 第一轮模块级拆分已完成并归档到 `design/10-review/done/16-mnote-web-runtime-module-maintainability-checklist-v1.md``layout.rs` / `tree.rs` / `web_shell.rs` 大型 raw string 已不再是 CodeGraph 符号定位的主要问题。
> - 当前定位浏览器功能默认看 `rust/crates/mnote-web/browser/*.js`,定位 tiptap island 行为默认看 `rust/spikes/leptos-tiptap-spike/src/editor_runtime/*.rs`。
> - 当前 smoke 分类和默认基线以 `scripts/TESTING_REFERENCE.md` 为准;退役 Convex / Next / 3104 / BlockNote 路径只在显式 legacy/cloud/compat 任务中运行。
> - Reasonix 只作为受控叶子 worker;不得自行启动 runner/subagent/worktree,结果必须由 Codex/Hermes 主控复核 handoff、diff、验证证据和 git 状态。
>
> 2026-05-22 口径补充:
> - Rust SQLite control-plane 已承接默认 auth、membership、share grants、sync state、AI policy、ACP/Hermes runtime session 控制面。
@@ -119,6 +125,22 @@ P0-P6 已经有最小闭环证据;P7 已完成阶段性瘦身,但还不是
- 本地 folder sidebar watch 已从整页 HTML refetch 改为 projection API 刷新
- 当前重点已从“是否接入 live stream”转为减少补偿链、缩薄 legacy consumer 和补稳定 smoke。
### 2.4 Runtime 模块级可维护收口
当前状态:
- `/mnt/Data1T/mnote/design/10-review/done/16-mnote-web-runtime-module-maintainability-checklist-v1.md`
- `/mnt/Data1T/mnote/design/03-rust-web/process/3-23-sidebar-local-folder-resource-runtime-followup-v1.md`
- `/mnt/Data1T/mnote/design/07-ai/process/7-38-page-ai-sidebar-runtime-owner-split-v1.md`
阶段性结论:
- `web_shell.rs` 文档页 host adapter 已外置到 `browser/document-editor-adapter-runtime.js` 并继续拆成 pane、resource tab、mindmap host、slash position、Tiptap conversion、session 等模块。
- `sidebar-tree-runtime.js` 已降到 3,000 行以下,sidebar workspace、page tree、filetree open/command/upload、attachment open、page settings、live apply 等边界已模块化;Page AI 主体属于 `sidebar-page-ai-runtime.js``07-ai` owner。
- `tree-shell-runtime.js` 已降到 2,500 行以下,debug/internal tree shell 的 page/filetree/picker/render/DOM/icons/state 已有模块边界。
- `leptos-tiptap-spike/src/lib.rs` 已降到 5,000 行以下,编辑器 runtime 模块位于 `editor_runtime/`
- CodeGraph 当前应直接索引这些 JS / Rust 模块;后续不再通过“继续拆 raw string”解决问题,而是按 `3-23``7-38` 和 BufferStore / Page Aggregate / live cache 等 owner 继续收口。
## 3. 当前仍应保留但不在第一线的 reference / done
下面这些文档仍然有效,但当前不应排在第一优先;引用时必须叠加 2026-05-21 之后的 local-first MVP 后阶段口径: