mnote/design/03-rust-web/process/3-20-browser-runtime-followup-checklist-v1.md

3-20 Browser Runtime 后续收口 Checklist v1

创建时间：2026-05-25 状态：process 来源：承接 design/03-rust-web/done/3-19-rust-web-browser-runtime-module-extraction-v1.md 的后续未专项完成项。

1. 目标

在 3-19 已归档的基础上，继续把仍留在 Rust inline / 主壳大 runtime 中的浏览器行为切成可审计模块。Codex 维护本文件作为事实源，Reasonix 只承接短批次审计、窄范围实现或浏览器 smoke；每批最多 2 个 worker。

2. 本轮边界

本轮优先处理：

• 主壳 filetree keyboard / clipboard / DND / context menu DOM 后续切片。
• document pane host adapter / document session / conflict panel runtime 只读审计。
• 本地上传主流程剩余边界审计，包括 uploadFileToMediaAsset、uploadFilesWithResolvedTarget、insertUploadedAssetIntoEditor。
• WS / SSE tree live 浏览器回归 smoke。

本轮不处理：

• Tiptap 编辑器内部命令、history、selection overlay；这些归 5-29。
• Rust kernel tree command 语义重写。
• Page AI panel 外置化；需要另起 07-ai 设计。

3. Batch A 候选任务

• Worker A：只读审计 document pane host adapter。
  • 目标：列出 web_shell.rs 中 document pane host / session / conflict panel 可迁模块、风险和 smoke。
  • 输出：候选模块表、禁止迁入 editor runtime 的边界、下一刀建议。
• Worker B：只读审计 local upload 主流程。
  • 目标：复核上传主流程剩余函数是否可从 SIDEBAR_TREE_JS 拆入 local-upload-runtime.js，不得改变资源归属语义。
  • 输出：函数归属表、不可迁项、必须保留的 smoke。
• Worker C：只读审计 filetree keyboard / clipboard / DND。
  • 目标：基于已落地 filetree-runtime.js / filetree-selection-runtime.js / filetree-context-menu-runtime.js，给出下一刀最小实现范围。
  • 输出：建议只迁纯 helper 还是 DOM listener，列出冲突文件。
• Worker D：浏览器 smoke 审计 WS / SSE tree live。
  • 目标：只读验证主壳 tree live 外置 runtime 在浏览器中仍加载，记录 WS 正常路径和 SSE fallback 的可测性。
  • 输出：截图、console/network、result.json；不修改源码。

4. 验收命令

按具体切片选择：

cargo fmt --manifest-path rust/Cargo.toml --all --check
cargo check --manifest-path rust/Cargo.toml -p mnote-web
cargo test --manifest-path rust/Cargo.toml -p mnote-web filetree
cargo test --manifest-path rust/Cargo.toml -p mnote-web runtime
node scripts/task487-local-folder-tree-live-consumer-smoke.js
node scripts/task479-local-folder-markdown-resource-lifecycle-smoke.js

UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据。

5. 采纳规则

• Reasonix 结果必须先查 Hindsight reasonix recall，再读 process-handoff.md/json、result.json、diff 和验证证据。
• 只采纳限定文件范围内的最小 diff；越界重构、回滚用户改动、修改 git 状态的一律拒绝。
• browser smoke worker 必须 modified_files=[]。
• 本文件只记录真实完成项；未验证项保持未勾选。

6. 本轮执行记录

• 2026-05-25：Codex 创建本续跑事实源。
• 2026-05-25：修正执行约束：本文件遵循当前 goal 的“每批最多 2 个 worker”，不再沿用早期草稿中的 4 worker 并行方案。
• 2026-05-25：下一批只派发 Worker B（local upload / filetree 下一刀只读审计）；Worker A/C/D 暂缓。