Nexus/docs/design/specs/2026-06-01-files-clipboard-transfer-design.md

远程文件剪切/复制/粘贴

日期: 2026-06-01
状态: 已确认

背景

2026-05-18-file-manager-v2 要求 Ctrl+C/V/X 与右键剪切/复制/粘贴；此前无后端批量 cp/mv 接口。

方案

新增 POST /api/sync/file-clipboard：

字段	说明
server_id	目标服务器
mode	copy | move（move = 剪切后粘贴）
sources	绝对路径列表（1～50）
dest_dir	目标目录（绝对路径）

命令：cp -r src… dest/；mv -t dest/ src…（GNU mv）。

安全

• 路径必须 / 开头，禁止 ..
• 禁止粘贴到源路径自身或其子目录
• 仅 JWT 管理员；审计 file_copy / file_move

前端

• 模块级剪贴板状态（同服务器粘贴）
• 工具栏粘贴、右键与 Ctrl+C/X/V
• 剪切粘贴成功后清空剪贴板

验收

• 多选复制到另一目录，源仍在
• 剪切后粘贴，源消失
• 跨服务器粘贴提示不可用
• 粘贴到子目录被拒绝