3D 产物上传带上退避重试，一次瞬时网络失败不再废掉整笔生成

- platform-oss：新增按前缀拼对象键的 `put_object_with_transient_retry`，与内部对象 PUT 共用同一套「可判定才重试」规则与退避（传输 / 超时 / 408 / 429 / 5xx 才重试，确定性 4xx 直接失败），body 只准备一次、每次 attempt 复用引用计数字节；重试次数或退避配置不足时按配置错误失败关闭
- api-server storage：3D 产物的模型 / 预览图 PUT 改用该入口，最多 3 次尝试、退避 250 / 500 ms（与角色动画同一口径）；模型上限 512 MiB 但实际产物远小，重试成本可控
- 新增用例：重试次数为 0 与退避不足都失败关闭；对一定解析不出的域名会真的按退避重试多次
- docs/technical：写明产物 PUT 的重试口径与「每个网络动作都要能重试」的理由

docs/technical/【技术方案】Tripo 3D生成API集成-2026-09-21.md

@@ -164,6 +164,8 @@ width/height  = 预览图像素尺寸
 
 模型格式与体积由 `AssetObject` 承担（`content_type`、`content_length`、`content_hash`），因此不新增 `model_format`、`size_bytes`、`poly_count` 等列。两个槽位的 `content_type` 都在写入前按字节识别真实产物：模型按魔数认 GLB 的 `glTF` 头、FBX 的 `Kaydara FBX Binary` 头与 glTF 的 JSON 正文，预览按魔数认 PNG / JPEG / WebP；不直接采信 provider 返回或下载响应头声明的类型，对象键扩展名由该内容类型派生。只有字节判不出来时才采信声明值，且声明值必须落在该槽位的白名单内（模型：`model/gltf-binary`、`model/gltf+json`、`model/fbx`、`application/x-fbx`；预览：`image/png`、`image/jpeg`、`image/jpg`、`image/webp`）；两边都对不上就直接按上游内容不合法失败并退款，不做任何兜底 —— 放行 `text/plain` 这类未知类型只会落成「错的 content type + 拼出来的扩展名」。客户端不复制这份格式清单：画布只按「`assetKind=model3d` 且 `objectKey` 非空」放行，能否交给 3D 查看器由 `packages/model3d-viewer` 判定，判据依次是读接口声明的 `Content-Type`、字节魔数、地址扩展名，全判不出来即按 `unsupported-format` 报错。这里的顺序是「信任后端检测结果」：`content_type` 在后端写入前已经按字节核过，所以客户端以声明为先；字节魔数只兜住声明缺失或认不出来（例如 `application/octet-stream`）的情况，不负责纠正一个「认得出来但不对」的声明。
 
+产物对象由 api-server 按固定前缀 PUT 写入、再 HEAD 复核后才登记；PUT 带退避重试（最多 3 次尝试，退避 250 / 500 ms），只对传输 / 超时 / 408 / 429 / 5xx 重试，确定性 4xx 直接失败。3D job 最多只尝试一次，一次瞬时网络失败就会废掉一笔已经计费的生成，所以这条链路上的每个网络动作都要能重试。
+
 `external_generation_job.phase` 的取值集合不变，仍只允许现有两种执行阶段；阶段文案由 api-server 映射，不扩展 schema 常量。
 
 ## assetKind 接入清单对照