在agent space中安全重命名项目文件须避开拖拽，通过「rename」入口或openapi调用完成；单文件右键重命名，批量需调用/batch-rename接口；重命名后须同步更新agent.json路径、执行stop/reload命令并验证文件引用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Agent Space中安全重命名项目文件需绕过拖拽操作，必须通过内置重命名入口或OpenAPI调用完成，否则会触发ACL继承异常或配额归属错乱。
通过Agent Space控制台重命名单个文件
进入目标Space → 点击左侧「Files」→ 定位到待重命名文件 → 右键点击该文件 → 选择「Rename」 → 在弹出的输入框中修改名称 → 按回车确认。这一步不经过本地缓存，直接提交原子写请求至目标存储卷。
注意：若文件正被某个Agent会话打开（如Codex正在读取/config/prompt.json），重命名将被拒绝并提示“File in use”，此时需先关闭对应Session再操作。
批量重命名多个项目文件
Agent Space原生不支持图形界面下的多选重命名，必须使用OpenAPI接口实现结构化批量操作。
方法一：调用POST /v1/spaces/{space_id}/files/batch-rename接口
请求体必须包含paths数组（每个元素为绝对路径）和renames映射对象，例如：{"paths":["/src/main.py","/tests/test_init.py"],"renames":{"/src/main.py":"/src/entrypoint.py","/tests/test_init.py":"/tests/test_bootstrap.py"}}
方法二：使用curl命令行执行
curl -X POST "https://api.agentspace.ai/v1/spaces/spc_abc123/files/batch-rename" \<br>-H "Authorization: Bearer YOUR_API_KEY" \<br>-H "Content-Type: application/json" \<br>-d '{"paths":["/data/raw.csv","/config/llm.yaml"],"renames":{"/data/raw.csv":"/data/cleaned_v2.csv","/config/llm.yaml":"/config/llm_prod.yaml"}}'
【overwrite字段默认为false；若目标名称已存在且overwrite=false，该条目将跳过并返回warning】
重命名后确保项目配置同步生效
第一步：确认agent.json中引用路径已更新
若重命名了prompts/system_prompt.txt，需同步修改agent.json内"prompt_file"字段值为"/prompts/system_prompt.txt"，否则Agent启动时因路径404而静默失败。
第二步：停止并重载项目
在宿主机终端执行：system-agent stop --project-id your-project-uid → system-agent reload --project-id your-project-uid。
这一步不可省略，【仅修改文件名不会自动触发workflow.yaml中定义的监听器重载】。
第三步：验证workflow.yaml中task节点是否仍可解析
运行system-agent validate --project-id your-project-uid，检查输出中是否含"✅ All file references resolved"。若出现"Reference not found: /old_name.py"，说明某处硬编码路径未更新。
