Your Name
49 lines
1.5 KiB
Markdown
49 lines
1.5 KiB
Markdown
# 文件管理：剪切 / 复制 / 粘贴
|
||
|
||
**日期**：2026-06-01
|
||
|
||
## 摘要
|
||
|
||
实现 v2 设计中的远程文件剪贴板：`POST /api/sync/file-clipboard`（`cp -r` / `mv -t`），前端 Ctrl+C/X/V、工具栏粘贴、右键菜单与状态芯片。
|
||
|
||
## 动机
|
||
|
||
用户要求补齐此前因缺少后端 API 未实现的剪切/复制/粘贴。
|
||
|
||
## 涉及文件
|
||
|
||
- `server/api/schemas.py` — `FileClipboardApply`
|
||
- `server/api/remote_path_validation.py`（新建）
|
||
- `server/api/sync_v2.py` — `/file-clipboard`
|
||
- `frontend/src/composables/useFilesClipboard.ts`（新建）
|
||
- `frontend/src/composables/useFilesHotkeys.ts`
|
||
- `frontend/src/pages/FilesPage.vue`
|
||
- `tests/test_remote_path_validation.py`（新建）
|
||
- `docs/design/specs/2026-06-01-files-clipboard-transfer-design.md`
|
||
|
||
## 安全
|
||
|
||
- 绝对路径 + 禁止 `..`
|
||
- 禁止粘贴到源目录子路径
|
||
- 审计 `file_copy` / `file_move`
|
||
|
||
## 迁移 / 重启
|
||
|
||
需部署**后端 + 前端**（新 API）。
|
||
|
||
## 验证
|
||
|
||
```bash
|
||
pytest tests/test_remote_path_validation.py -q
|
||
```
|
||
|
||
浏览器：复制→进入另一目录→粘贴；剪切→粘贴后源消失；跨服务器粘贴应提示。
|
||
|
||
---
|
||
|
||
## 2026-06-01 补充：跨目录粘贴
|
||
|
||
- 粘贴目标：默认当前目录；**单选一个文件夹**时粘贴到该文件夹；**右键目录**「粘贴到 xxx」；**目录树右键**粘贴到该节点
|
||
- 状态栏显示剪贴板内容与粘贴目标路径
|
||
- 前端 `validatePasteTarget` 与后端一致，禁止粘贴到源目录内部
|