mnote/.codex/reasonix-tasks/2026-05-25-batch-am-worker-a-3-20-filetree-preflight-readonly.md

Reasonix Worker Task

任务

对 3-20 的 filetree drop/upload preflight DOM helper 做只读审计，范围只限于：

• rust/crates/mnote-web/src/ssr/pages/layout.rs
• rust/crates/mnote-web/browser/filetree-runtime.js
• design/03-rust-web/process/3-20-browser-runtime-followup-checklist-v1.md

只做边界审计和最小切片建议，不修改源码、不运行测试、不提交 git。

Project Root

/mnt/Data1T/mnote-worktrees/0525-am-worker-a-3-20-filetree-preflight-readonly

输入文件

• Checklist：
  • /mnt/Data1T/mnote/design/03-rust-web/process/3-20-browser-runtime-followup-checklist-v1.md
• 相关代码入口：
  • /mnt/Data1T/mnote-worktrees/0525-am-worker-a-3-20-filetree-preflight-readonly/rust/crates/mnote-web/src/ssr/pages/layout.rs
  • /mnt/Data1T/mnote-worktrees/0525-am-worker-a-3-20-filetree-preflight-readonly/rust/crates/mnote-web/browser/filetree-runtime.js

Ownership

你负责：

• 只读分析以下函数是否适合迁入 filetree-runtime.js：
  • fileTreeRowsForUploadPreflight
  • fileTreeDocumentParentsForPreflight
  • fileTreeTargetChildrenForPreflight
  • fileTreeDropPreflightRows
• 给出下一刀最小 helper 建议。
• 明确哪些依赖必须继续留在 layout.rs 壳层。

你不能修改：

• 任何源码
• 任何 design / bugs 文档
• 任何生成产物

共享或冲突文件规则：

• 本任务是只读审计，工作区必须保持源码零 diff。
• 允许写 runner 自己的输出文件，例如 process-handoff.md/json、final.md、result.json。

额外限制

• 禁止创建新的 .codex/reasonix-tasks/*.md
• 禁止启动新的 reasonix / claudecode / codex / hermes / runner
• 禁止操作其他 worktree
• 不要建议整体迁出 ensureFileTreeWritableTarget
• 不要建议整体迁出 /api/tree/filetree/drop-preflight fetch
• 不要建议整体迁出 resolveFileTreeUploadTarget 或 refreshLocalFolderSidebarSnapshot
• 重点只看 DOM 行遍历、属性采集、目标 children/parents 组装这一层

需要回答的问题

1. 这 4 个 preflight helper 中，哪些已经具备迁入 filetree-runtime.js 的条件？
2. 最小可迁 helper 签名应该是什么？
3. 哪些依赖必须继续留在 layout.rs？
4. 是否应该一刀一起迁，还是拆成两刀更稳？

验收命令

不需要运行测试；这是只读审计任务。

最终回复格式

请按以下结构回复：

• 修改文件：
• 审计结论：
• 建议的最小切片：
• 必须留在 layout.rs 的边界：
• 未完成项：
• 风险和需要 Codex 复核的点：