55 lines
2.5 KiB
Markdown
55 lines
2.5 KiB
Markdown
|
# 4-39 FileTree Open Target 与 Resource Identity Checklist v1
|
|||
|
|
|
|||
|
|
> 状态：process
|
|||
|
|
>
|
|||
|
|
> 日期：2026-05-20
|
|||
|
|
>
|
|||
|
|
> Owner：File Tree runtime / open target 合同
|
|||
|
|
|
|||
|
|
## 1. 目标
|
|||
|
|
|
|||
|
|
补齐 P0-4：扩展 `FileTreeOpenTarget` 和 runtime API，使 File Tree 能稳定表达 local raw file、directory、asset folder、office/image/pdf/code/mindmap/table 等资源身份，而不是只靠 UI 侧字符串分流。
|
|||
|
|
|
|||
|
|
## 2. 允许修改范围
|
|||
|
|
|
|||
|
|
- `rust/crates/mnote-web/src/tree_shell/filetree_runtime.rs`
|
|||
|
|
- `rust/crates/mnote-web/src/tree_shell/runtime_api.rs`
|
|||
|
|
- `rust/crates/mnote-web/src/routes/tree.rs`
|
|||
|
|
- `rust/crates/mnote-web/src/routes/local_folder_source.rs`
|
|||
|
|
- 相关 Rust 单测
|
|||
|
|
|
|||
|
|
## 3. 禁止事项
|
|||
|
|
|
|||
|
|
- 不改前端打开 UI 大流程；只输出更稳定的 open target / intent 合同。
|
|||
|
|
- 不做 resource lifecycle delete/restore/purge cutover；该项由 4-40 处理。
|
|||
|
|
- 不引入新的树真相层，Resource Tree / File Tree / Page Tree 口径保持不变。
|
|||
|
|
|
|||
|
|
## 4. Checklist
|
|||
|
|
|
|||
|
|
- [x] 扩展 `FileTreeOpenTarget` 或新增字段，能表达 `local_file`、`directory`、`asset_folder`、`office`、`image`、`pdf`、`code/text`、`mindmap`、`table`。
|
|||
|
|
- [x] open target 包含 canonical resource identity、resource kind、relative path、document id / parent id（若有）。
|
|||
|
|
- [x] `parse_open_target_from_row` 支持现有 row dataset，不破坏 document/index/asset-folder/asset。
|
|||
|
|
- [x] runtime API 序列化保持 camelCase，旧字段兼容。
|
|||
|
|
- [x] Rust 单测覆盖 local raw file、directory、office/image/pdf/code/mindmap/table open target。
|
|||
|
|
|
|||
|
|
## 5. 验收
|
|||
|
|
|
|||
|
|
- [x] `cargo test -p mnote-web filetree_runtime -- --test-threads=1`
|
|||
|
|
- [x] `cargo test -p mnote-web runtime_api -- --test-threads=1`
|
|||
|
|
- [x] `cargo test -p mnote-web tree_shell_filetree_mode_embeds_asset_state -- --test-threads=1`
|
|||
|
|
|
|||
|
|
## 6. 本轮执行记录
|
|||
|
|
|
|||
|
|
- 已完成：
|
|||
|
|
- `FileTreeOpenTarget::Asset` 已补可选 `resourceKind`，并新增 `LocalFile` / `Directory` variant。
|
|||
|
|
- `resolve_open_target` 支持 `local-file` / `directory` / `office` / `image` / `pdf` / `code` / `text` / `mindmap` / `table` row kind。
|
|||
|
|
- 新增序列化合同测试，覆盖 resource kind、local file 中文路径、directory。
|
|||
|
|
- 未完成：
|
|||
|
|
- 后续仍需把更多上游 row dataset 补齐真实 `rootUri`，当前 `LocalFile` / `Directory` variant 的 rootUri 仍为空字符串占位。
|
|||
|
|
- 风险：`FileTreeOpenTarget` schema 已扩展，需保留旧 `Asset` JSON 兼容；当前 `resourceKind=None` 时不序列化。
|
|||
|
|
|
|||
|
|
## 7. 非目标
|
|||
|
|
|
|||
|
|
- 不改变资源实际打开方式。
|
|||
|
|
- 不处理 OnlyOffice 回源。
|