任务状态与重试

Kaleido 把长任务状态作为产品界面的一部分。只有服务端任务真正完成，结果卡才会进入完成态。

四种状态

状态	含义	建议操作
排队中	任务已经创建，正在等待执行槽位	保持页面打开或稍后回来，不要重复提交
运行中	Worker 已开始处理，卡片显示进度	等待；频繁刷新不会让生成更快
已完成	结果资产已落库并可读取	预览、排版、导出或进入资产库
失败	任务终止并保留失败原因	先读原因，再决定重试、换输入或联系管理员

图片任务可以并发，但仍可能因队列、供应商限流或网络而等待。规划中的视频任务会严格串行，但当前视频流程尚未开放。

进度是真实状态，不是假倒计时

图片结果页会轮询服务端任务，汇总：

• 总张数
• 已完成
• 失败
• 运行中
• 排队中

进度卡片没有到 100% 或没有进入“已完成”时，不应把预览占位图当作生成结果。

单张重试

失败卡片提供 重试这一张：

1. 只针对当前变体重新排队；
2. 其他成功或运行中的卡片不受影响；
3. 页面继续读取新任务状态；
4. 恢复成功后可正常排版与导出。

不要为了一个失败项重新提交整个批次，否则会产生重复素材和额外成本。

先判断错误类型

可以稍后重试

• 429、rate limit、API limit：供应商限流；等待后重试。
• 暂时网络或读取错误：确认网络恢复后重试。
• 未识别错误：界面会保留截断后的原始信息；重试一次，仍失败再提供给管理员。

需要更换输入

• 50411 或 pre img risk：商品图未通过供应商内容审核；更换合规商品图。
• 文件格式、大小或选择数量超限：先修正输入。

需要管理员处理

• provider not configured 或 terminal provider：生成服务未配置；重复点击无法修复。
• 模板目录为空且清除筛选后仍无内容：可能需要运营或部署侧补充模板。

警告

界面可能仍显示重试按钮，但错误文字优先。明确提示“更换商品图”或“联系管理员”时，不要反复重试。

“结果可能过时”不是失败

修改商品或模板后，已有项目可能显示“商品或模板已变更，结果可能过时”。这表示：

• 原结果仍保留；
• 系统不会自动重写你的选择；
• 你可以继续导出旧结果，或主动重新生成。

这种提示用于保护人工编辑，不代表资产损坏。

状态刷新失败

如果出现“状态刷新失败”：

1. 先检查网络；
2. 等几秒后重新打开图片产线；
3. 不要立即创建同一批次副本；
4. 若问题持续，记录批次、文件名、时间和错误文字。