docs: align runtime architecture guidance

2026-05-26 07:29:15 +08:00
parent e1681331a3
commit 0a15595066
14 changed files with 134 additions and 35 deletions
@@ -303,10 +303,10 @@ UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据
 | filetree keyboard/clipboard/DND/context menu | ✅ | filetree-dnd-runtime.js + filetree-keyboard-runtime.js |
 | document pane host / conflict panel runtime | ✅ | acceptDiskVersion/keepCurrentEditorVersion/writeMergedConflictResult + 已迁出的 DOM helper |
 | local upload 主流程审计 | ✅ | 全部 6 个函数已迁入 local-upload-runtime.js |
-| WS/SSE tree live smoke | ⚠️ | task487 RED（tree live transport 尚未接入 local_folder），task479/488/489/451 ✅ |
+| WS/SSE tree live smoke | ✅ | task487 已收敛为 `local-folder-events`，task479/488/489/451 ✅ |
 | **SIDEBAR_TREE_JS 主 runtime 外置** | ✅ | 10,655 行 → sidebar-tree-runtime.js（超出原计划范围） |

-### browser/ 最终模块清单（11 文件）
+### browser/ 阶段模块清单（3-20 归档时 11 文件）

 | 文件 | 行数 | 说明 |
 |------|------|------|
@@ -191,12 +191,12 @@ codegraph sync .
 | browser/ 模块 | 11 个 JS 文件，总计 ~11,000 行 |
 | editor_runtime/ 模块 | 19 个 Rust 模块（另有 mod.rs） |
 | 浏览器 smoke | task479/488/489/451 全部 PASS |
-| 测试 | editor 13/13；web full 最近一次 529/549（20 failed，非本轮 editor runtime / sidebar 外置改动面） |
+| 测试 | editor 13/13；web full 在 3-21 当时最近一次为 529/549（20 failed，非本轮 editor runtime / sidebar 外置改动面）；后续 `10-review/done/16` 已完成全量 `mnote-web --lib` 通过 |
 | CodeGraph | 350+ 文件索引完成 |

 ### 后续已拆出

 | 项 | 说明 |
 |----|------|
-| mnote-web 全量 lib 测试失败 | `cargo test --manifest-path rust/Cargo.toml -p mnote-web --lib -- --test-threads=1` 最近一次仍 20 failed（watcher OS limit、legacy proxy、access policy dialog、Hermes block tools 403、local search index、resource trash 503、web_shell 旧断言等），已拆到 `bugs/03-rust-web/process/3-24-mnote-web-lib-test-failures-v1.md`，不再阻塞本文件归档。 |
-| sidebar runtime 二阶段瘦身 | `sidebar-tree-runtime.js` 已解决 Rust raw string 定位问题，但仍是 1 万行 JS 巨文件；后续拆分计划已拆到 `design/03-rust-web/process/3-22-sidebar-tree-runtime-second-stage-split-v1.md`。 |
+| mnote-web 全量 lib 测试失败 | 这是 3-21 归档时的历史状态；后续已由 `10-review/done/16` 收口到全量 `mnote-web --lib` 通过。 |
+| sidebar runtime 二阶段瘦身 | `sidebar-tree-runtime.js` 已解决 Rust raw string 定位问题；后续二阶段拆分已完成并记录到 `design/03-rust-web/done/3-22-sidebar-tree-runtime-second-stage-split-v1.md` 与 `design/10-review/done/16-mnote-web-runtime-module-maintainability-checklist-v1.md`。 |
@@ -62,7 +62,7 @@ rust/crates/mnote-web/browser/sidebar-tree-runtime.js
 ## 4. 不建议的下一步

 - 不建议直接整体重写 `sidebar-tree-runtime.js`。
- 不建议把 `mnote-web --lib` 全量失败作为本文件前置阻塞；该问题已拆到 `bugs/03-rust-web/process/3-24-mnote-web-lib-test-failures-v1.md`。
+- 不建议把 `mnote-web --lib` 在 3-22 创建时的全量失败作为本文件前置阻塞；后续已由 `design/10-review/done/16-mnote-web-runtime-module-maintainability-checklist-v1.md` 收口到全量 `mnote-web --lib` 通过。
 - 不建议为了 DRY 把 shell 业务编排强行迁入小 helper，尤其是需要 workspace/root/document/session 状态的函数。

 ## 5. 验收基线
@@ -2,7 +2,7 @@

 > 创建时间：2026-05-25
 > 状态：`process`
-> 来源：`design/03-rust-web/process/3-22-sidebar-tree-runtime-second-stage-split-v1.md` Batch B / Batch D。
+> 来源：`design/03-rust-web/done/3-22-sidebar-tree-runtime-second-stage-split-v1.md` Batch B / Batch D。

 ## 1. 背景