agent space团队协作需启用agent team模式，统一使用共享space存放文件，按角色或单文件设置权限，并通过sync命令同步本地环境确保文件一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Agent Space团队协作中，多个成员需安全、可追溯地访问同一套项目文件，避免各自上传导致版本混乱或权限错配。
确认空间已启用Agent Team模式
打开Agent Space控制台 → 点击顶部导航栏「空间模式」→ 确认当前为「Agent Team 模式」；若显示「Personal Mode」，点击「一键启用」并等待页面刷新完成。这一步是共享文件的前提，【未切换模式时所有文件操作均仅对当前用户可见，其他成员无法读取任何上传记录或历史版本】。
通过共享Space统一存放项目文件
团队必须使用同一个目标Space作为文件中枢，而非各自在个人Space中上传副本。
进入左侧「Spaces」→ 找到已分配给团队的共享Space（如team-finance-2026）→ 点击进入其文件浏览器 → 将项目所需文件（如prompt_v3.jinja、schema.json、test_cases.xlsx）直接上传至根目录或约定子路径（例如/data/inputs/、/prompts/v3/）。
上传后，所有具备该Space访问权限的成员均可实时看到最新文件，且修改时间、操作人自动记录在文件元信息中。
设置文件权限与协作规范
方法一：基于角色批量授权
在共享Space的「Settings」→「Access Control」中，为团队成员按角色分配权限：Owner可管理ACL、Editor可上传/编辑/删除、Viewer仅可下载和查看。确保Prompt工程师、RAG工程师等关键角色至少拥有Editor权限。
方法二：对单个文件设置细粒度策略
在文件浏览器中右键点击某prompt_v3.jinja → 选择「Manage Permissions」→ 勾选「Restrict editing to specific members」→ 输入指定成员邮箱 → 点击「Apply」。此操作会覆盖Space默认权限，适用于敏感提示词的定向管控。
【注意：文件一旦被设为“仅指定成员可编辑”，其他Editor角色成员将无法保存修改，且无前端提示，务必提前同步名单】
同步更新本地开发环境中的项目文件
第一步：定位项目本地路径
团队成员需统一将Agent Space项目映射到宿主机相同路径，例如$HOME/aospace/projects/team-finance-2026/，该目录名应与共享Space名称严格一致。
第二步：拉取最新文件
执行system-agent space sync --space-name=team-finance-2026 --target-dir=$HOME/aospace/projects/team-finance-2026，该命令会比对远程文件哈希值，仅下载变更内容，跳过未修改的大型数据集文件。
第三步：校验核心文件加载状态
运行system-agent project status --uid=prj_9a2b8c1d，检查输出中workflow.yaml、agent.json、prompts/下的文件是否显示“loaded: true”。若任一文件状态为“missing”或“parse error”，说明本地路径结构有误或YAML缩进错误，需立即修正。
