69 lines
3.2 KiB
Markdown
69 lines
3.2 KiB
Markdown
|
# 4-29 VSCode Explorer Cut Paste Move v1
|
|||
|
|
|
|||
|
|
> 状态：done
|
|||
|
|
> 创建时间：2026-05-15
|
|||
|
|
> 所属主线：04-tree-domain / VSCode Explorer 文件树与垃圾箱闭环
|
|||
|
|
> 来源：`design/10-review/07-vscode-explorer-filetree-trash-gap-review.md` 阶段 7
|
|||
|
|
|
|||
|
|
## 1. 目标
|
|||
|
|
|
|||
|
|
先收口阶段 7 的最小可执行项：文件树 `Ctrl/Cmd+X` 后 `Ctrl/Cmd+V` 必须执行移动，而不是复制或 no-op。
|
|||
|
|
|
|||
|
|
## 2. 范围
|
|||
|
|
|
|||
|
|
- `wolai-frontend` 主 Sidebar 文件树剪贴板 action 从 `copy` 扩展为 `copy | cut`。
|
|||
|
|
- `Ctrl/Cmd+C` 写入 `copy` payload，`Ctrl/Cmd+X` 写入 `cut` payload。
|
|||
|
|
- `Ctrl/Cmd+V` 读取 `cut` payload 时：
|
|||
|
|
- Rust family renderer 复用 `tree.filetree.drop.preflight` 的 move plan。
|
|||
|
|
- 页面移动走 `moveDocumentCommand`。
|
|||
|
|
- 普通附件移动走 `moveFileTreeResourceAssets`。
|
|||
|
|
- 成功后清空剪贴板并刷新/广播相关树变化。
|
|||
|
|
- `copy` 路径保持原行为。
|
|||
|
|
|
|||
|
|
## 3. 非目标
|
|||
|
|
|
|||
|
|
- F2 inline rename、右键菜单补齐、DnD readonly / 冲突确认不在本小阶段内实现，继续留在阶段 7 后续子项。
|
|||
|
|
- 不扩展 `tree.filetree.paste.preflight` 的 Rust plan；cut 粘贴复用 drop preflight，是当前最小改动。
|
|||
|
|
|
|||
|
|
## 4. 验收标准
|
|||
|
|
|
|||
|
|
- `decodeFileTreeClipboardPayload` 能识别 `copy | cut`，拒绝其它 action。
|
|||
|
|
- Sidebar 快捷键监听同时处理 `Ctrl/Cmd+C`、`Ctrl/Cmd+X`、`Ctrl/Cmd+V`。
|
|||
|
|
- cut paste 分支不调用 `copyTreeCommand` / `copyFileTreeResourceAssets`，而调用 `moveDocumentCommand` / `moveFileTreeResourceAssets`。
|
|||
|
|
- 成功 cut paste 后清空剪贴板，避免二次粘贴重复移动。
|
|||
|
|
|
|||
|
|
## 5. 已落地
|
|||
|
|
|
|||
|
|
- `src/lib/file-tree/clipboard.ts`：
|
|||
|
|
- `FileTreeClipboardAction` 扩展为 `copy | cut`。
|
|||
|
|
- decoder 允许 `cut`，继续拒绝其它 action。
|
|||
|
|
- 新增 `clearFileTreeClipboardPayload`。
|
|||
|
|
- `src/components/sidebar/sidebar.tsx`：
|
|||
|
|
- 全局文件树快捷键支持 `Ctrl/Cmd+X`。
|
|||
|
|
- Rust family renderer 的 cut paste 复用 `preflightFileTreeInternalDrop(... copy: false)`。
|
|||
|
|
- cut paste 执行页面移动与附件移动，成功后清空剪贴板。
|
|||
|
|
- `src/components/sidebar/tree-pane-bindings.ts` 透出清空剪贴板 helper。
|
|||
|
|
|
|||
|
|
## 6. 验证命令
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd /mnt/Data1T/mnote/wolai-frontend
|
|||
|
|
pnpm test src/lib/file-tree/clipboard.test.ts src/components/sidebar/sidebar-paste-preflight-source.test.ts
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
结果：2 个测试文件通过，7 项测试通过。
|
|||
|
|
|
|||
|
|
局部 TypeScript 筛查：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pnpm exec tsc --noEmit --pretty false 2>&1 | rg "(src/lib/file-tree/clipboard.ts|src/components/sidebar/tree-pane-bindings.ts|src/components/sidebar/sidebar.tsx)"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
结果：无输出，本轮修改文件无新增 TypeScript 报错。全量 `tsc` 仍受仓库既有错误影响。
|
|||
|
|
|
|||
|
|
## 7. 待补
|
|||
|
|
|
|||
|
|
- 2026-05-15 已补 3000 主入口真实浏览器 smoke：`MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task430-vscode-explorer-stage7-smoke.js`。
|
|||
|
|
- `task430` 使用一次性用户 / workspace，验证页面行 `Ctrl/Cmd+X` 后聚焦目标页面并 `Ctrl/Cmd+V`，捕获 `/api/tree/commands action=move`，并通过 Convex 查询确认子页面 `parent_id` 变为目标父页面。
|
|||
|
|
- 普通附件 cut-paste move 的执行路径已有代码与 preflight 设计，真实附件 move 全矩阵仍归入后续资源树 / DnD 综合 smoke，不阻塞本小阶段“页面 cut-paste move”验收。
|