mnote/design/03-rust-web/done/3-11-rust-web-3000-existing-tree-editor-runtime-relink-checklist-v1.md

3-11 [done] Rust Web 3000 既有 Tree / Editor Runtime 重新接入清单 v1

更新时间：2026-04-29

纠偏来源：用户指出此前 3-10 的完成判断只证明了 API / 直达文档页 smoke，并没有证明用户打开 3000 / 后能看到文件树、页面树，或从 UI 新建页面进入 leptos-tiptap。

参考主线：

• /mnt/Data1T/mnote/design/04-tree-domain/done/4-11-tree-rust-family-final-renderer-and-host-thinning-checklist-v1.md
• /mnt/Data1T/mnote/design/05-editor-mainline/done/5-6-page-aggregate-alignment-checklist-v1.md
• /mnt/Data1T/mnote/design/03-rust-web/done/3-10-rust-web-3000-tree-editor-runtime-integration-checklist-v1.md

1. 根因确认

• 已确认 3000 / 走的是 gateway::root_entry -> HomePage -> PageLayout -> workspace_shell，不是 /tree debug shell。
• 已确认既有完整 tree runtime 在 rust/crates/mnote-web/src/tree_shell/* 与 routes/tree.rs，不应再临时造一套简化树 UI。
• 已确认此前默认 sidebar 在 my_page_items 非空时会优先渲染简化 row，绕开 Rust page tree renderer。
• 已确认 SIDEBAR_TREE_JS 被嵌套成 <script><script>...，导致 UI 新建点击逻辑没有执行。
• 已确认 leptos-tiptap 文档页链路本身可用，真实缺口是从根页 UI 到树命令再到文档页的产品工作流未闭环。

2. 接入既有页面树 / 文件树

• 默认 workspace sidebar 优先嵌入 Rust render_initial_page_tree_html 输出的 page tree HTML。
• 默认 workspace sidebar 新增 Rust render_initial_filetree_html 输出的 file tree section。
• page tree row 保留 Rust renderer action 标记：tree-node-open、tree-action-create、tree-action-rename。
• page tree row 同时保留 wolai-sidebar-row、data-node-id、data-parent-id、data-depth、data-active，兼容已有 smoke 和 active row 验收。
• 空工作区不再只显示静态“暂无页面”，而是显示 page tree / file tree 的 Rust renderer 空态，并保留新建入口。

3. 接入 UI 命令链路

• 左栏全局 + 使用真实 workspaceId 调 /api/tree/commands action=create。
• page tree row 的子页面 + 使用当前 node 作为 parentId 调 /api/tree/commands action=create。
• page tree row 的 open action 会进入 /documents/:id?workspaceId=...。
• page tree row 的 rename action 通过 /api/tree/commands action=rename 回写，不再停留在纯静态按钮。
• 修复 sidebar JS 嵌套 <script>，确保浏览器真实执行点击逻辑。

4. 接入 leptos-tiptap 验证链路

• 从 3000 / 点击新建页面后会进入 /documents/:id?workspaceId=...。
• 文档页输出 __MNOTE_PAGE_AGGREGATE__ 和 __MNOTE_EDITOR_BOOTSTRAP__。
• 文档页 mount root 为 data-testid="mnote-leptos-tiptap-island-editor-root"。
• 浏览器内 .editor-surface .ProseMirror[contenteditable="true"] 可见。
• 输入保存后 reload 可读回。

5. 回归验证

• cargo test -p mnote-web workspace_shell
• cargo test -p mnote-web root_entry
• cargo test -p mnote-web tree_shell_page_renderer_outputs_initial_html_contract
• cargo test -p mnote-web document_shell
• cargo test -p mnote-web page_aggregate
• MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task122-rust-web-create-page-ui-smoke.js
• MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task120-rust-web-tree-integration-smoke.js
• MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task121-rust-web-editor-island-hydration-smoke.js
• MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task114-rust-web-gateway-entry-smoke.js
• MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task115-rust-web-document-shell-smoke.js
• MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task118-rust-web-wolai-ui-parity-smoke.js
• MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task119-rust-web-wolai-visual-regression-smoke.js

6. 完成判定

• 用户直接打开 http://127.0.0.1:3000/ 可以看到页面树 section。
• 用户直接打开 http://127.0.0.1:3000/ 可以看到文件树 section。
• 用户可以从根页左栏 + 新建页面。
• 新建后能进入文档页并看到 leptos-tiptap 主编辑区。
• 本轮没有把 /tree debug shell、iframe host 或简化静态 UI 当作默认完成口径。