必须先确认项目已发布或归档且当前账号具备project:export权限，再通过控制台【部署】页签点击【导出项目】生成zip包，或调用openapi/cli批量导出；zip含配置与代码但不含敏感凭证、训练语料及向量索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 AgentSpace 平台中导出项目文件，必须先确认当前项目已完成构建并处于可发布状态，未保存的草稿或运行中的调试会话无法导出；导出操作仅对拥有“项目导出”权限的角色开放，普通协作者默认无此权限。
确认项目导出权限与状态
登录 AgentSpace 控制台 → 进入目标工作区 → 点击左侧导航栏【项目管理】→ 找到待导出项目，查看右侧“状态”列是否显示为【已发布】或【已归档】；若显示“构建中”“调试中”或“草稿”，则需先完成构建流程并点击【发布】按钮。
鼠标悬停在项目名称上 → 点击出现的【详情】图标 → 滚动至“成员与权限”区域 → 查看当前账号角色是否包含“导出”操作权限；如无，需联系空间管理员在【权限策略】中为该角色添加project:export动作。
通过控制台一键导出 ZIP 包
进入项目详情页 → 顶部导航栏切换至【部署】页签 → 点击右上角【导出项目】按钮 → 在弹窗中勾选“包含运行时配置”和“包含版本元数据”（建议全选）→ 点击【确认导出】。
导出任务提交后，页面自动跳转至【任务中心】，状态变为“打包中”；通常 10～90 秒内完成，完成后将生成一个以项目名+时间戳命名的 ZIP 文件，如 sales-assistant-v2.3-20260903-0652.zip；点击下载即可获取完整项目包，内含：config.yaml、skills/ 目录、assets/ 和 metadata.json。
注意：该 ZIP 不含训练语料或向量索引文件，如需迁移 RAG 数据，请另行从【知识库】模块单独导出。
使用 OpenAPI 批量导出多个项目
方法一：调用 POST /v1/projects/export/batch 接口
准备 JSON 请求体，指定项目 ID 列表与导出格式：
{"project_ids": ["proj-8a2f3c", "proj-d9e1b7"], "format": "zip", "include_runtime": true}
请求头需携带有效 Authorization: Bearer <your-token></your-token>，且 token 必须由具备 space:admin 权限的账号签发；响应返回 task_id，后续轮询 GET /v1/tasks/{task_id} 获取下载 URL。
方法二：通过 CLI 工具导出
安装最新版 agentspace-cli（v2.4.0+）→ 执行命令：agentspace project export --ids proj-8a2f3c,proj-d9e1b7 --output-dir ./exports；工具自动处理鉴权、轮询与文件落地，无需手动拼接 API。
导出后的文件结构说明
解压 ZIP 后，根目录下必含 project.yml，定义 Agent 编排逻辑；skills/ 下每个子目录对应一个 Skill，含 manifest.yml 与 handler.py（或 handler.js）；assets/ 存放图标、提示词模板等静态资源。
【关键限制】：导出包不包含任何敏感凭证（如数据库密码、API Key），这些字段在导出时已被自动脱敏为占位符 {{SECRET_DB_PASSWORD}}，部署前需人工补全或通过环境变量注入。
打开 project.yml → 查找所有 {{ 开头的变量 → 记录其名称，用于后续部署阶段的参数绑定。
