# Reasonix Worker B：Local Folder Tree Live 前端 consumer 接入

Project root：`/mnt/Data1T/mnote`

你不是唯一 worker。不要回滚、覆盖或清理他人的改动；只修改本任务 ownership 范围内的文件。不要提交 git。

## 背景

`3-3` 暂不能归档，因为 `sourceKind=local_folder` 当前在 `TREE_LIVE_CONTROLLER_JS` 中直接设置 `data-mnote-tree-live-transport="local-folder-static"` 并 return；Sidebar / FileTree 依赖 `startLocalFolderSidebarWatch()` 轮询 `/api/tree/local-folder-watch` 后补拉 projection。

新 checklist：`design/03-rust-web/process/3-18-local-folder-tree-live-consumer-convergence-checklist-v1.md`

## Ownership

允许修改：

- `rust/crates/mnote-web/src/ssr/pages/layout.rs`

禁止修改：

- Rust route 后端文件
- `scripts/*.js`
- 其他 design 文档

## 目标

1. local_folder 默认路径应进入 tree live controller，不再直接 `local-folder-static` return。
2. 使用 Worker A 新增/扩展的 local_folder tree live SSE，接收到 snapshot/resync 后 dispatch `tree:snapshot` / `tree:resync`，复用已有 `renderSidebarSnapshot()` consumer。
3. `startLocalFolderSidebarWatch()` 可保留为 fallback，但不再是默认主链。
4. 不破坏 web_shell/tiptap 的 `/api/local-folder/events` 文档外部变更通道。
5. DOM 状态应能区分新主链，例如 `data-mnote-tree-live-transport="local-folder-events"`，并在应用成功后设置 `data-mnote-tree-live-applied="snapshot"` 或 `"resync"`。

## 验收命令

```bash
cargo test --manifest-path rust/Cargo.toml -p mnote-web sidebar_tree_runtime -- --test-threads=1
cargo test --manifest-path rust/Cargo.toml -p mnote-web web_shell -- --test-threads=1
git diff --check
```

## 最终回复格式

- 修改文件列表
- local_folder tree live 主链变化
- fallback 保留情况
- 运行过的命令和结果
- 未完成项或风险