docs: update runtime extraction checklist

This commit is contained in:
lix-2026
2026-05-25 00:08:23 +08:00
parent c3fbadb456
commit d4bef58773
@@ -520,18 +520,21 @@ Reasonix read-only audit
- `cargo check --manifest-path rust/Cargo.toml -p mnote-web` - `cargo check --manifest-path rust/Cargo.toml -p mnote-web`
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web tree_shell` - `cargo test --manifest-path rust/Cargo.toml -p mnote-web tree_shell`
- 结果:42 个 tree_shell 相关测试通过。 - 结果:42 个 tree_shell 相关测试通过。
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web runtime`
- 结果:57 个 runtime 相关测试通过。
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web filetree`
- 结果:28 个 filetree 相关测试通过。
- `GET /api/mnote-browser-runtime/tree-shell-runtime.js` - `GET /api/mnote-browser-runtime/tree-shell-runtime.js`
- 结果:`200``content-type=application/javascript; charset=utf-8`响应包含 `tree.ready``hydrateInitialFileTree` - 结果:`200``content-type=application/javascript; charset=utf-8`浏览器读取内容包含 `startTreeShellRuntime``tree.ready``hydrateInitialFileTree``reducePageActionWithRuntime``buildFileTreeRuntimeEnvironment``reconcilePageRuntimeResult`
- `codegraph_search reducePageActionWithRuntime` / `buildFileTreeRuntimeEnvironment` / `reconcilePageRuntimeResult` - `codegraph_search reducePageActionWithRuntime` / `buildFileTreeRuntimeEnvironment` / `reconcilePageRuntimeResult`
- 结果:3 个函数均可定位到 `rust/crates/mnote-web/browser/tree-shell-runtime.js` - 结果:3 个函数均可定位到 `rust/crates/mnote-web/browser/tree-shell-runtime.js`
- `MNOTE_WEB_ENABLE_DEBUG_SHELL_ROUTES=1``/tree` 运行态说明: - 真实 3000 服务运行态说明:
- Convex workspace 参数返回 `503 convex_unavailable`,因为本地未启动 Convex upstream - 本轮直接访问 `/tree?...` 返回 `404`,说明 debug shell 入口当前不作为公开默认入口暴露;运行态 JS asset 加载由固定 asset route 浏览器验证,debug shell page/filetree/picker HTML 行为由 Rust route 单测覆盖
- local_folder 参数返回 `401 local_workspace_auth_required`,因为本次未注入浏览器登录态 - 主壳登录后确认 `tree-live-controller.js` 等已外置 runtime 正常挂载,P4 主壳 filetree runtime 仍待后续切片
- 因此运行态 `/tree` HTML 由 Rust route 单测覆盖,本批不把这些环境失败视为实现失败。
剩余风险: 剩余风险:
- `type="module"` 自带作用域,`tree-shell-runtime.js` 外层 IIFE 现在是冗余但无害;本批保持同构迁出,暂不做额外重构 - `type="module"` 自带作用域,`tree-shell-runtime.js` 已移除外层 IIFE,并只 hoist P3 关键函数;其他 DOM runtime 仍按原局部闭包组织,避免扩大改动
- debug tree shell runtime 与主壳 `SIDEBAR_TREE_JS` 仍是两套 runtime,后续 P4/P5 继续拆主壳 filetree runtime 和 document pane host adapter。 - debug tree shell runtime 与主壳 `SIDEBAR_TREE_JS` 仍是两套 runtime,后续 P4/P5 继续拆主壳 filetree runtime 和 document pane host adapter。
## 10. 分阶段执行清单 ## 10. 分阶段执行清单
@@ -695,11 +698,11 @@ node scripts/task487-local-folder-tree-live-consumer-smoke.js
本设计移动到 `done/` 前必须满足: 本设计移动到 `done/` 前必须满足:
- [ ] `TREE_LIVE_CONTROLLER_JS` 已从 `layout.rs` 迁出。 - [x] `TREE_LIVE_CONTROLLER_JS` 已从 `layout.rs` 迁出。
- [ ] debug `/tree` shell runtime 大块 JS 已从 `tree.rs` 迁出,或已有明确豁免说明。 - [x] debug `/tree` shell runtime 大块 JS 已从 `tree.rs` 迁出,或已有明确豁免说明。
- [ ] 主壳 filetree runtime 的核心 selection / DND / context menu 至少完成一个模块外置切片。 - [ ] 主壳 filetree runtime 的核心 selection / DND / context menu 至少完成一个模块外置切片。
- [ ] resource open / local upload adapter 至少完成一个高频 bug 模块外置切片。 - [x] resource open / local upload adapter 至少完成一个高频 bug 模块外置切片。
- [ ] 新增 JS runtime 文件能被 CodeGraph 索引。 - [x] 新增 JS runtime 文件能被 CodeGraph 索引。
- [ ] 至少一组 tree realtime smoke 和一组 local folder filetree/resource smoke 通过。 - [ ] 至少一组 tree realtime smoke 和一组 local folder filetree/resource smoke 通过。
- [ ] `layout.rs` / `web_shell.rs` 不再继续新增大型 inline browser runtime。 - [ ] `layout.rs` / `web_shell.rs` 不再继续新增大型 inline browser runtime。