适用于使用 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

1. POST /open/v1/projects 创建项目并保存 project_id。
2. POST /open/v1/projects//agent/runs 提交自然语言需求。
3. GET …/agent/runs//events 实时读取进度，并用事件 ID 断线续传。
4. 遇到交互 Action 时调用 POST …/agent/action-responses。
5. 使用会话和消息接口恢复上下文；生成成功后调用 POST …/agent/preview-links。
6. 验收生成结果后，调用 POST /open/v1/projects//source-exports 创建当前源码导出。使用响应中的短期 download_url 下载 ZIP，并按 size 和 sha256 校验完整性。 完整请求、SSE 事件和 Action 结构见 Agent 接入总览

​

导出源码

源码导出是同步接口，可能包含恢复沙箱、打包和上传过程，客户端超时时间建议设置为 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 回复可重试且不产生重复任务。 ● 会话与项目映射可恢复，不向其他用户暴露当前 project_id。 ● 源码导出使用与项目相同的身份，下载完成后校验 size 和 sha256，且不泄露临时下载链接。 ● 错误的 code、message、details、request_id 完整进入接入方诊断链路。 ● 产品界面明确标注预览地址的临时性质。