用途:让 Ideogram 集成质量可复现,同时不把付费凭据暴露给不可信变更。每个 PR 用 fixtures 与 schema 检查,真实冒烟测试隔离在受信任分支、合成内容、花费与并发控制之后。
前置条件:CI 信任模型、分支策略、测试运行器、适配器接缝与密钥提供方;覆盖同步、异步、安全、错误、webhook、轮询与存储的脱敏 fixtures;为 schema 刷新、实况冒烟花费和失败运行清理指定负责人。
认证:PR 任务必须在没有 IDEOGRAM_API_KEY 情况下运行。单独批准的实况任务可在服务端获得短期或环境作用域密钥,仅以 Api-Key 发送到 https://api.ideogram.ai。
主要做法:盘点工作流、fork 行为、密钥暴露、缓存产物与既有付费调用;为 multipart 字段名、互斥提示、类型化错误、安全结果、异步终态、签名校验、下载限制与存储清理添加离线测试;固定经审阅的 OpenAPI 快照或哈希并报告漂移;扫描 fixtures 与产物中的密钥、提示、URL、图像字节与客户标识;将实况冒烟限制在受保护的可信上下文,需人工或环境批准、单个合成请求、严格超时、输出数量与成本上限;不持久化厂商 URL、删除生成的测试资产、仅发布无内容状态证据;合并必须要求离线测试通过,不让厂商可用性使普通 PR 变得不稳定。
工具纪律与审批边界:用 Read、Glob、Grep 检查工作流和测试,用 Write、Edit 修改经批准的 CI、fixture 与文档。未经仓库授权,不得添加密钥、启用付费 fork 任务或更改必需检查。工作流权限、新密钥访问、实况花费、外部产物上传、必需检查变更与分支保护变更需审批;来自 fork 的代码绝不能获得 Ideogram 密钥。
错误处理:遇到 fixture 密钥、未记录 schema 变更、不安全输出绕过或留存图像产物时失败;在可选实况通道隔离厂商故障,不削弱确定性合并门禁;取消超时任务并在重试前对账已接受的异步生成。
输出与校验:返回工作流与测试路径、信任边界、断言数量、OpenAPI 哈希、密钥扫描结果、离线门禁状态、实况通道状态与花费、清理凭据与回滚方案。测试可信与不可信事件路径、检查有效权限、重跑离线套件并确认产物无内容,演练取消并确认实况创建对象被删除。依赖枚举、限制或测试版特性前,重新核对端点页面与当前 OpenAPI 描述。