为美术包增加图片自动转码

美术包在本地提交前将 JPEG 和 WebP 转为 PNG，保留有效 PNG 原字节统一最终图片的扩展名、媒体类型与恢复摘要，保留原有透明度和大小校验覆盖损坏下载重试、账本保留和清理、重复恢复零生成请求，并同步规范与排障记录验证通过 106 项定向测试及格式、编码、文档索引和差异检查
2026-09-27 12:52:10 +00:00
parent 155f0d316a
commit 5c648ab9c7
5 changed files with 236 additions and 44 deletions
@@ -1,5 +1,11 @@
 # 踩坑与排障记录

+## 美术包固定 PNG 路径与平台返回格式不一致
+
+- 平台生成成功仍可能返回 JPEG/WebP；直接按 `assets/art-spec.png` 等固定路径保存会在扩展名校验时失败，图片尚未落盘但已付费结果账本仍存在，不能据 manifest 为空认定没有生成结果。
+- 美术包专用入口在本地提交前有界解码并归一化为 PNG，原 PNG 字节不变；扩展名、MIME、内容摘要和恢复比较必须使用同一份最终字节。普通图片工具和独立切片的格式合同不随之放宽，转码也不能代替真实透明度校验。
+- 失败后保留原账本并按冻结意图恢复，不能删除账本后重新生成。详情见 [AGC 美术包合同](../../technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md#2026-08-23-direct-codex-美术包显式重生成与切片投影)。
+
 ## 2026-09-24 AGC 生成路由迁移必须核对账号队列契约

 - AGC 普通账号会把 external editor 路由映射到站内入口；只验证 API Key 路由不足以证明客户端链路可用。