适用于使用 Meoo 完成 AI 生成、预览和源码交付。
按认证与授权取得业务 Bearer 凭证。系统集成统一使用团队版：单一大账号使用 Owner 临时 Token，需要最终用户隔离时使用虚拟成员临时 Token；用户 API Key 仅用于个人测试。完整流程的最小 Scope：project.write project.read agent.run agent.read source.read；按实际使用增加 skill.write 或 cloud.*。如果不需要导出源码，可以不申请 source.read。
获得业务 Bearer 凭证 → 创建或选择项目 → 创建 Agent Run → 消费 SSE、处理 Action → 查询会话和消息 → 获取短期预览地址 → 创建源码导出 → 下载并校验 ZIP
通过 Bash 的
源码导出是同步接口，可能包含恢复沙箱、打包和上传过程，客户端超时时间建议设置为 240 秒。成功响应为 201 Created，包含 filename、size、sha256、download_url 和 download_url_expires_at。
● download_url 默认有效期为 10 分钟，应在可信服务端立即下载。
● 下载链接可以直接读取项目源码，不能写入日志、数据库、分析系统或返回给无关用户。
● ZIP 会排除 Git 元数据、依赖、构建缓存、平台临时文件及 .env、.env.* 文件。 ● 下载链接过期后重新创建导出，不要修改签名参数。
● 项目体积较大时不要高频并发重试；请求结果不确定时先退避，再有限重试。 完整字段、示例和错误处理见源码导出 API。
● 不请求 release.write、release.read，也不调用 Release API。
● 预览地址是短期验收入口，不是正式网站链接；过期后重新签发。
● 源码 ZIP 是交付产物，但不产生线上版本或正式网站地址。
● 后续决定上线时，可在同一 project_id 上继续走全链路发布，无需重复生成。
● Run 创建、事件消费、断线恢复和 Action 回复可重试且不产生重复任务。
● 可展示素材生成进度与产物；积分按
前置选择
按认证与授权取得业务 Bearer 凭证。系统集成统一使用团队版：单一大账号使用 Owner 临时 Token，需要最终用户隔离时使用虚拟成员临时 Token；用户 API Key 仅用于个人测试。完整流程的最小 Scope：project.write project.read agent.run agent.read source.read；按实际使用增加 skill.write 或 cloud.*。如果不需要导出源码，可以不申请 source.read。
接入流程
获得业务 Bearer 凭证 → 创建或选择项目 → 创建 Agent Run → 消费 SSE、处理 Action → 查询会话和消息 → 获取短期预览地址 → 创建源码导出 → 下载并校验 ZIP
- POST /open/v1/projects 创建项目并保存 project_id。
POST /open/v1/projects/{project_id}/agent/runs提交自然语言需求。GET .../agent/runs/{run_id}/events实时读取进度。断线后退避重订阅同一 Run，通过message.snapshot校正文本和工具状态；SSE 帧 ID 只在本次连接内有效，不支持Last-Event-ID断点续传。- 遇到交互 Action 时调用 POST .../agent/action-responses。
- 使用会话和消息接口恢复上下文；生成成功后调用 POST .../agent/preview-links。
- 验收生成结果后，调用
POST /open/v1/projects/{project_id}/source-exports创建当前源码导出。使用响应中的短期 download_url 下载 ZIP，并按 size 和 sha256 校验完整性。 完整请求、SSE 事件和 Action 结构见 Agent 接入总览
展示素材与积分
通过 Bash 的 tool.call.sub_type 区分普通命令、图片、视频、语音和音乐生成，tool_name 仍为 Bash。参数生成完成后才首次发送 started；完成时结合 outcome 判断成功与否，并使用可选的 result 展示素材。重连 message.snapshot.tool_calls 可恢复素材类型、状态和可公开产物；普通 Shell 命令不进入工具快照。
主 Agent 与素材可分别发送 run.usage，每条 credits_used 是单笔积分。按 Run 保存 usage_id 集合和积分累计值，先去重再求和，避免重连重复累计。该事件没有 tool_call_id 或 sub_type，不要按事件顺序绑定某次生成；没有积分事件也不代表零消耗。详细字段和例子见 事件流与 Action。
导出源码
源码导出是同步接口，可能包含恢复沙箱、打包和上传过程，客户端超时时间建议设置为 240 秒。成功响应为 201 Created，包含 filename、size、sha256、download_url 和 download_url_expires_at。
● download_url 默认有效期为 10 分钟，应在可信服务端立即下载。
● 下载链接可以直接读取项目源码，不能写入日志、数据库、分析系统或返回给无关用户。
● ZIP 会排除 Git 元数据、依赖、构建缓存、平台临时文件及 .env、.env.* 文件。 ● 下载链接过期后重新创建导出，不要修改签名参数。
● 项目体积较大时不要高频并发重试；请求结果不确定时先退避，再有限重试。 完整字段、示例和错误处理见源码导出 API。
与全链路的区别
● 不请求 release.write、release.read，也不调用 Release API。
● 预览地址是短期验收入口，不是正式网站链接；过期后重新签发。
● 源码 ZIP 是交付产物，但不产生线上版本或正式网站地址。
● 后续决定上线时，可在同一 project_id 上继续走全链路发布，无需重复生成。
完成标准
● Run 创建、事件消费、断线恢复和 Action 回复可重试且不产生重复任务。
● 可展示素材生成进度与产物；积分按 usage_id 去重累计，并保存恢复所需状态，不依赖缓存重放或历史消息补齐全部历史积分。
● 会话与项目映射可恢复，不向其他用户暴露当前 project_id。
● 源码导出使用与项目相同的身份，下载完成后校验 size 和 sha256，且不泄露临时下载链接。
● 错误的 code、message、details、request_id 完整进入接入方诊断链路。
● 产品界面明确标注预览地址的临时性质。