在agent space中安全复制文件需避开拖拽操作，先确认源space中账号具备【read + copy】权限，再通过「copy to…」功能或openapi原子复制，新文件不继承原acl且默认采用目标space权限模板。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Agent Space中安全、可追溯地复制项目文件，必须避开直接拖拽或全选复制这类破坏空间隔离的操作，否则会导致权限继承错乱或配额归属失效。
确认目标Space与源Space的权限边界
进入Agent Space控制台 → 点击左侧「Spaces」→ 找到你要复制文件的源Space（例如sales-assistant-prod）→ 点击右侧「Settings」→ 查看「Access Control」标签页中当前登录账号是否拥有【Read + Copy】权限。若仅显示「Read」，复制操作将被静默拒绝且无提示。
注意：跨Space复制不继承原文件的ACL策略，新文件默认采用目标Space的默认权限模板。
使用内置Copy to功能执行原子复制
在源Space内打开文件浏览器 → 定位到待复制的文件或文件夹 → 右键点击 → 选择「Copy to…」→ 在弹出窗口中输入目标Space名称（支持下拉选择已授权的Space）→ 点击「Confirm」。
这一步会触发后台原子操作：先校验目标Space剩余配额，再生成带时间戳的副本路径（如/copied_20260902_2115_sales_q3_report.xlsx），最后写入目标Space的独立存储卷。整个过程不经过本地缓存，避免中间态泄露。
通过OpenAPI批量复制（适用于结构化目录）
方法一：调用POST /v1/spaces/{source_space_id}/files/copy接口
请求体需包含：
• target_space_id（必填，目标Space唯一ID，非名称）
• paths（数组，每个元素为源路径绝对路径，如["/data/input/raw.csv", "/config/prompt_v2.json"]）
• overwrite（布尔值，默认false；设为true时同名文件将被覆盖）
方法二：使用curl命令行快速提交
curl -X POST "https://api.agentspace.ai/v1/spaces/spc_abc123/files/copy" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target_space_id":"spc_xyz789","paths":["/tasks/weekly_summary.md"],"overwrite":false}'
响应成功后返回202 Accepted，并附带job_id用于轮询状态。失败时HTTP状态码为400或403，错误信息明确指出是配额不足还是权限缺失。
