mnote/design/04-tree-domain/process/4-44-filetree-action-layer-paste-drop-delete-v1.md

4-44 FileTree Action Layer Paste / Drop / Delete Checklist v1

状态：process

日期：2026-05-20

Owner：File Tree actions / preflight / smoke semantics

1. 目标

补齐 P1：delete、paste、right-click paste、external drop 的动作层仍分散，缺少 dirty / readonly / undo / fallback 的统一动作合同。目标是先把现有行为收口成可测试的轻量 action layer，不一次性照搬 VSCode IBulkEditService。

2. 允许修改范围

• rust/crates/mnote-web/src/ssr/pages/layout.rs
• rust/crates/mnote-web/src/routes/tree.rs
• rust/crates/mnote-web/src/tree_shell/* 中仅限 preflight / action contract
• scripts/task430-vscode-explorer-stage7-smoke.js
• scripts/task471-local-folder-bulk-resource-trash-smoke.js
• 可新增聚焦 smoke：scripts/task47*-filetree-action-layer-smoke.js

3. 禁止事项

• 不删除旧 media / mindmap / table fallback route。
• 不把默认删除改成永久删除。
• 不绕过 readonly preflight。
• 不破坏多选 data-selected 语义。

4. Checklist

• 提炼前端 File Tree action helper，统一记录 action、target、preflight、fallback、失败项。
• delete 对 local folder 资源统一走 archive tree command，并暴露可观测 undo/fallback 占位状态。
• right-click paste 使用当前菜单目标，而不是只能依赖 focused row。
• paste / drop 对 readonly 目标有一致阻断提示和 DOM 标记。
• external drop 二进制文件继续进入上传链路，失败时不清空 selection。
• smoke 增加至少一个语义断言：目标 row、action 名、fallback/readonly/undo 状态之一。

5. 验收

• cargo test -p mnote-web layout -- --test-threads=1
• cargo test -p mnote-web tree_command_local_folder -- --test-threads=1
• node scripts/task430-vscode-explorer-stage7-smoke.js
• node scripts/task471-local-folder-bulk-resource-trash-smoke.js
• 如新增 smoke：node scripts/task47*-filetree-action-layer-smoke.js

5.1 本轮执行记录

• 已合入：recordFileTreeAction / recordFileTreeActionStatus，为 delete、paste、open-right、new-window 等现有路径暴露稳定 DOM 状态。
• 已合入：右键 paste-into 使用菜单触发 row，不再只能靠 focused row。
• 本轮追加：layout.rs 为 filetree projection row 暴露 data-capabilities，新增 ensureFileTreeWritableTarget / blockReadonlyFileTreeAction，paste 与内部 drop 在执行前复用 /api/tree/filetree/drop-preflight；readonly 目标统一写入 data-mnote-filetree-last-action-status=blocked、data-mnote-filetree-readonly-blocked、data-mnote-filetree-readonly-message 与目标 row 标记，并沿用 alert fallback 提示。
• 本轮追加：task471-local-folder-bulk-resource-trash-smoke.js 增加语义断言，覆盖 bulk-delete 的 action 名、触发 row 与 archived undo 状态；未修改 task430 的隔离 workspaceId 前置条件，避免把环境准备失败误判为业务回归。

6. 非目标

• 不实现完整 undo stack。
• 不实现 cloud object storage drop executor。