故障排查

先根据页面上最具体的错误处理。Kaleido 会尽量保留原始失败原因，不应只看“失败”两个字。

无法登录

提示邮箱未验证

点击登录页的 重新发送，检查垃圾邮件，并使用最新一封邮件中的链接。验证链接 24 小时有效且仅可使用一次。

忘记密码

使用 忘记密码？ 获取 30 分钟有效的重置链接。重置后所有旧会话会失效。

一直显示恢复登录失败

点击“重新尝试恢复登录”；仍失败时退出并重新登录。不要清除问题证据前反复操作。

模板库没有内容

1. 清空搜索词；
2. 把分类、促销节点和品类恢复为全部；
3. 切换排序；
4. 确认登录会话有效；
5. 仍为空时联系运营或管理员确认模板目录。

不要把结构预览误认为最终成片缺失；模板卡本来只展示槽位结构。

“生成”按钮不可用

逐项确认：

• 已选至少一个模板；
• 商品图上传和确认已完成；
• 至少选择一个导出规格；
• 当前没有正在创建批次；
• 页面没有显示上传失败。

商品图上传失败

• 格式必须为 JPEG、PNG 或 WebP；
• 文件不超过 20 MiB；
• 不要通过改扩展名伪造格式；
• 检查网络后使用卡片上的重试；
• 更换图片会清空旧上传状态。

某张图片生成失败

先看卡片中的中文提示：

• 供应商限流：等待后点 重试这一张；
• 内容审核：更换商品图；
• 服务未配置：联系管理员；
• 其他错误：保留原始提示，重试一次后再上报。

详见任务状态与重试。

结果预览打不开

预览使用短时效签名 URL：

1. 点击 重试预览（若结果页提供）；
2. 或关闭预览并重新打开；
3. 刷新后重新获取地址；
4. 仍失败时确认资产是否已删除。

不要把过期签名 URL 当作永久下载地址。

一键翻译失败

翻译失败不会修改底图。你可以：

• 检查语言码是否为合法 BCP-47；
• 稍后重试；
• 直接在文字块手工修改；
• 对敏感促销和合规措辞始终人工复核。

导出或回存失败

每个画幅独立执行。检查失败的是哪个规格：

• 确认底图仍可读取；
• 至少选中一个规格；
• 保持页面打开直到上传完成；
• 成功规格已经入库时，不必全部重做。

资产删除失败

批量删除会保留失败项：

• 状态不可删除：资产正在被使用或当前状态不允许；
• 已不存在：服务端已无该资产，刷新列表；
• 其他错误：保留原因并重试或联系管理员。

上报问题时提供什么

请提供：

• 发生时间；
• 所在页面与操作步骤；
• 文件名或模板名；
• 卡片上的完整错误文字；
• 是否只影响单张还是整批；
• 浏览器和网络环境。

不要提供密码、验证 Token、Cookie、API Key 或私密签名链接。