docs: record async image task tradeoffs

progress.md

@@ -1760,3 +1760,17 @@
   - T-615 第一版只做日志遥测，不新增 admin 报表或统计表；如后续需要报表，单独评估数据量、索引和保留周期。
   - 旧同步接口下线前必须继续保持成功响应兼容；待新版客户端默认异步、旧路调用归零或低于运营阈值一段时间后，再宣布 deprecated 并单独立下线任务。
 - 下一步：部署后观察 `generation_route_usage` 日志；继续处理真实支付回调到账闭环、客户端下载包发布等业务事项。
+
+## 2026-07-08 文档补充：T-614 异步生图实现取舍记录（非任务）
+
+- 状态：DONE。
+- 背景：复核 T-612~T-615 审核建议后确认两点实现行为需要文档化：worker 会复跑 `prepare_generation()`；`image_url` 输入会在 submit 阶段下载。
+- 变更：
+  - `docs/04-architecture.md`：补充 worker 复审 prompt、重解析别名 / Provider / 定价的当前取舍；明确账务仍使用已预扣 `CallRecord.points_cost`，不重复扣点；队列积压时再做提交时模型配置快照。
+  - `docs/api.md`：在异步生图提交接口说明桌面端主链路推荐 `image_base64`，`image_url` 会在 submit 阶段下载并可能阻塞。
+  - `docs/deployment.md`：补充生产排查口径，submit 慢时先检查是否批量使用 `image_url`；worker 重解析配置是短队列下偏安全取舍。
+  - `docs/06-tasks.md`：Backlog 新增“异步生图提交时模型配置快照”。
+  - `docs/current-state.md`：同步当前实现边界。
+- 验证：仅文档更新；使用 `git diff --check` 检查格式。
+- 决策：当前不改代码。`image_base64` 是桌面端主路径，submit 仍为短请求；`image_url` 阻塞属于边缘兼容路径。模型配置快照不作为热修，待队列积压或多模型价差扩大后单独立任务。
+- 下一步：无需立即编码；继续按生产优先级处理支付回调闭环、客户端发布和线上遥测观察。