feat(product-suite): complete multi-source recovery

2026-07-20 18:50:08 +08:00
parent 2e6b93d7e0
commit b803a2a15a
7 changed files with 310 additions and 17 deletions
@@ -452,9 +452,9 @@ data/images/<batch_id>/<slug>/<task_id>_<item_id>_new.<ext>    # AI 生成的新
 - 进度：标题和图片两条进度分开显示；只生成标题时图片进度显示本轮未生成/0 张，并在运行日志写明本轮生成内容。
 - 任一组件生成后 `stage=generated`；**不设逐条人工审核阶段**。若只有标题，③可选择只更新标题；若只有封面，③可选择只更新封面，②标题状态仍为待生成，后续补标题会保留已有封面且不重复生图。双击任务弹窗查看旧封面、新封面和历史候选图；T-577 后弹窗内「重置图片」只清当前任务 `new_cover_path` 并归档旧图，不启动单条 `GenerateWorker`，用户退出后用状态筛选「待生成」批量补生成封面。②「重置生成结果」提供标题/封面/全部的多选或当前筛选范围重置，默认不删除本地新封面文件；已生成且未提交线上的新标题可在②表格本地微调。
 - 并发数、重试、分辨率、jpg 质量、模型/Key 均来自设置（`data/config.json` 的 `ai` 段；Key 存 `data/config/cmhub.json` 或 direct 兼容清单）。T-547 后标题并发和图片并发都限制为 1..5，失败重试次数限制为 0..10；旧 `config.json` 或手工配置的超限值会在加载/保存时夹紧。设置仍只展示一个「图片并发」设置；cmhub 模式下②运行日志显示“图片并发 X，cmhub实际生图并发 Y，下载并发 Y”。
- T-679a 后商品套图按 worker 启动时冻结的配置建立并持久化来源：默认网关 job 精确为 `cmhub/cmhub`，保留异步提交、轮询、下载、幂等键和点数账本；自定义网关 job 精确为 `direct/openai_images_edits`，走 T-678 的同步多图编辑、固定 `n=1`、无 `task_id`、无轮询和无自动重试。执行分派只读 job 持久化来源，不能受运行中设置变化影响；不匹配的来源/提供方或 direct job 带 task ID 均安全失败，避免跨来源串路。T-679b 已接通⑥新建入口与确认；重复计费的手动重试、混合来源历史和完整发布验收仍由 T-679c/T-679 完成。
+- T-679a 后商品套图按 worker 启动时冻结的配置建立并持久化来源：默认网关 job 精确为 `cmhub/cmhub`，保留异步提交、轮询、下载、幂等键和点数账本；自定义网关 job 精确为 `direct/openai_images_edits`，走 T-678 的同步多图编辑、固定 `n=1`、无 `task_id`、无轮询和无自动重试。执行分派只读 job 持久化来源，不能受运行中设置变化影响；不匹配的来源/提供方或 direct job 带 task ID 均安全失败，避免跨来源串路。T-679b 已接通⑥新建入口与确认；T-679c 已补齐手动重试与混合来源历史展示，完整发布验收仍由 T-679 完成。
 - T-679b 后，⑥在自定义网关下仅本地校验当前已启用图片模型的接口类型、网址、模型 ID、密钥与连接超时；合格后可新建同步 direct job，但不读取 cmhub 模型目录、余额或价格。确认框按冻结 specs 展示数量、主参考图/参考图、逐图模式、请求尺寸和近似比例，并明确“自定义网关不计点数，实际费用以服务商为准”及主体一致性限制。AI帮写仍严格使用默认网关 `vision_alias`。生成期间当前任务输入锁定，任务切换、历史、日志和已完成图片查看不阻塞。
- direct job 提交前写入 `running + run_session_id`；停止只取消尚未提交的 job。同步请求已返回图片字节时，即使停止信号随后到达，仍保存资产并标成功。连接/读取超时或进程中断不自动补发、不进入 cmhub 恢复轮询，用户只能手动重新生成。应用仅在启动阶段持有单进程恢复租约时处理遗留 direct `running` job；活动会话跳过，确认陈旧的 job 标为“程序中断，无法确认生成结果，请手动重新生成”。进入项目、切换任务或刷新结果不做该清理。
+- direct job 提交前写入 `running + run_session_id`；停止只取消尚未提交的 job。同步请求已返回图片字节时，即使停止信号随后到达，仍保存资产并标成功。连接/读取超时或进程中断不自动补发、不进入 cmhub 恢复轮询，用户只能手动重新生成。应用仅在启动阶段持有单进程恢复租约时处理遗留 direct `running` job；活动会话跳过，确认陈旧的 job 标为“程序中断，无法确认生成结果，请手动重新生成”。进入项目、切换任务或刷新结果不做该清理。T-679c 后「继续查询已提交图片」严格只处理 `cmhub/cmhub + task_id`，切换⑤设置不会改变该筛选；direct 永不进入此入口。结果卡、项目历史与全局历史均以 job 的持久化来源显示“默认网关 / 自定义网关”，不读取当前设置。direct 失败只允许用户手动“重新生成”：当前设置仍为自定义网关且配置合格时，必须重新展示完整生成确认，并额外警告服务商可能已经对上次未确认请求计费、本次可能再次收费；确认后始终新建 job，绝不复用旧 job 或自动补发。
 - 套图比例输出固定映射为 `1:1 -> 1024x1024`、`3:4/9:16 -> 1024x1536`、`4:3/16:9 -> 1536x1024`。`image_studio_assets.aspect_ratio` 保持用户原选项，新增 `requested_output_size`、`rendered_width`、`rendered_height` 记录请求尺寸与真实像素；旧记录保持空值，SQLite 迁移仅附加且幂等。服务返回近似比例结构化结果，T-679b 在确认界面呈现。
 - 商品套图的生图来源在 T-679 组全部验收前不得进入发布版本；图片理解「AI帮写」仍仅使用默认网关 `vision_alias`。
 - T-658a 后商品套图异步生图提交统一使用 `images` 数组，单图也使用单元素 `{"image_base64": ...}`，不再提交顶层 `image_base64`。提交层最多传 8 张本地图片，单图原文件上限10MiB、编码后总输入上限32MiB；超限在请求前以中文错误阻断，后续多图参考的资产快照和提示词语义由 T-658b/T-658c 负责。
@@ -176,6 +176,7 @@
  - 自定义网关复用既有模型列表、模型详情、默认文本模型与默认图像模型。文本模型保留 `chat` / `auto`；图片模型固定使用「OpenAI 图片编辑接口」（`images_edits`），②和⑥通过 `/v1/images/edits` 以有序重复 `image[]` 上传，第一张是商品主体图、每次只请求 `n=1` 输出。历史 `chat` / `auto` 图片模型不会被改写或隐藏，但会标示「图片接口不支持」，生成前会被拦截。图片响应只接受 `data[].b64_json` / `data[].url`，不适配聊天响应或服务商私有结构。说明行明确「图片理解仅支持默认网关」。
  - 图片模型按钮显示「检查图片配置」，只在本地检查接口类型、URL、模型 ID、密钥和超时，绝不对 `/images/edits` 发送无图片的测试请求；实际可用性必须以②或后续⑥的正常生成确认判断。允许保存不完整配置。②点击生成后、自定义 worker 创建前按本轮标题/封面选择校验所需模型的启用状态、类别、地址、模型 ID、API Key 和接口类型，失败提示去⑤补齐且不发请求、不改任务状态；自定义网关不显示默认网关余额，运行日志和状态栏说明“不计点数，费用由服务商收取”。
  - T-679b 后，⑥商品套图在自定义网关下先本地校验已启用的图片模型、接口类型、网址、模型 ID、密钥与连接超时；不合格时阻止创建 job 并引导到⑤补齐。合格后可创建同步直连 job，确认框显示数量、主图/参考图、逐图模式、比例映射与“自定义网关不计点数，实际费用以服务商为准”，并说明首图为主要商品参考、主体一致性可能弱于默认网关；不请求 cmhub 模型目录、余额或价格。AI帮写仍禁用并说明仅默认网关可用。已有 `generation_source=cmhub`、`provider=cmhub` 且 `task_id` 非空的可恢复任务仍显示「继续查询已提交图片」，仅轮询、下载和保存，不新建 job 或重复扣点。所有②/⑥ worker 开始时冻结来源、实际模型和密钥的仅内存快照，保存设置不会改变正在执行的一轮。
+  - T-679c 后，「继续查询已提交图片」只显示并处理 `generation_source=cmhub`、`provider=cmhub` 且 `task_id` 非空的任务，切换到自定义网关后仍可继续查询旧默认网关任务；direct job 永不进入该入口。结果卡、项目历史和全局历史固定显示 job 已保存的“默认网关 / 自定义网关”，不因⑤设置切换改写；同轮混合来源显示“默认网关、自定义网关”。direct 失败只能手动“重新生成”，并再次显示完整生成确认及“服务商可能已对上次未确认请求计费，本次可能再次收费”的默认取消警告。确认后新建 job，不自动重试或复用旧 job；默认网关历史、导出、删除撤销和继续查询保持原有行为。
  - T-531 已完成：设置页任意可编辑控件变更都进入未保存状态，保存按钮旁显示“● 未保存更改”；切换到其它 Tab 或关闭窗口时弹出保存/放弃/取消。放弃会重新从本地配置文件回填控件，避免未保存的 URL/API Key 留在界面上；程序化回填、保存后重载和刷新别名填充下拉不会误触发未保存状态。
  - 自定义模型清单继续保存于 `data/config/ai_models.json`；在自定义网关面板中可维护并立即保存，切换回默认网关不会清除这些配置。
 - AI 生成参数：标题并发、图片并发、失败重试、分辨率、返回超时等短字段按三列排列；标题/图片并发可选 1..5，失败重试可选 0..10，旧配置超限值会自动夹紧；图片保存质量保留内部默认 90，不在普通 UI 展示。自定义模型角色选择只在自定义网关面板显示。
@@ -3,7 +3,7 @@ id: T-679c
 title: 商品套图多来源恢复、重试与历史展示
 phase: 7
 deps: [T-679a, T-679b]
-status: TODO
+status: DONE
 created: 2026-07-20
 ---

@@ -59,4 +59,8 @@ git diff --check

 ## 执行记录

-（做完在这里写：变更文件、恢复与重试决策、验证命令及结果。）
+- 已将「来源」和「是否可继续查询」拆为两个判断：恢复入口仍严格要求已保存的 `cmhub/cmhub + task_id`，因此切换到自定义网关后仍可查询旧默认网关任务，而 direct job 永不进入轮询或恢复。
+- 结果卡、项目历史图片/轮次和全局历史轮次均显示已保存的中文来源；来源只读 job 的 `generation_source/provider`，切换⑤设置不会改写历史显示。混合来源轮次显示两种来源摘要，不暴露模型、URL 或密钥。
+- direct 失败或启动期中断恢复后的卡片允许在当前自定义网关配置合格时手动重新生成；每次先显示完整生成确认，并默认取消且明确提示服务商可能已计费、本次可能再次收费。确认后新建 job，绝不自动补发、复用旧 job 或进入继续查询。默认网关重试、历史、导出、删除撤销和继续查询保持原有语义。
+- 新增来源过滤、持久化来源显示、切换设置不改写历史、direct 二次确认和陈旧 direct 失败重试入口的 GUI 回归测试；更新 `docs/04-architecture.md`、`docs/routes.md`、`docs/ui/tab6-suite-recovery-T679c.svg` 与 UI 索引。
+- 验证：`py -3.10 -m unittest tests.test_product_suite_gui tests.test_image_studio_generation tests.test_gui`（294 项）、`py -3.10 -m ruff check app tests main.py`、`py -3.10 -m compileall app main.py`、`git diff --check` 均通过；完整测试结果见本任务提交前的最终校验。
@@ -18,6 +18,7 @@
 | [tab6-suite-package-v1.svg](tab6-suite-package-v1.svg) | 商品套图（T-622 已实现）：从「虾皮圈电商图生成器」商品套餐交互迁移并替换主界面 AI工场入口；单一套图类型，多任务标签，商品原图，平台/国家/语言/比例，AI 帮写，白底/场景/卖点及自定义分类，结果历史、重试、删除撤销与生成进度 |
 | [tab6-suite-prompt-dialog-T637.svg](tab6-suite-prompt-dialog-T637.svg) | 商品套图（T-637 提案）：标题行「AI帮写/取消」紧随 label、最右新增「提示词设置」；提示词设置弹窗——左编辑基础模板（行序对齐调研笔记组装顺序，套图名称+补充描述、插入变量菜单、占位符校验、只读规则占位符内联）、右只读实时最终预览（预览分类下拉）、保存/恢复默认共用原子写盘；第一版不做同类多张序号/差异化 |
 | [tab6-suite-gateway-T679b.svg](tab6-suite-gateway-T679b.svg) | 商品套图（T-679b 已实现）：自定义网关生成确认展示主图/参考图、近似比例尺寸、服务商费用与主体一致性边界；生成中锁定当前任务输入，停止等待已发出同步请求返回，同时仍可切换其它任务与查看历史/结果 |
+| [tab6-suite-recovery-T679c.svg](tab6-suite-recovery-T679c.svg) | 商品套图（T-679c 已实现）：结果卡和历史按已保存 job 显示默认网关/自定义网关；默认网关任务可继续查询，直连失败图只能手动重新生成并再次确认可能重复收费 |
 | [workbench-redesign-v1.html](workbench-redesign-v1.html) | 工作台视觉提案（HTML 可交互原型）：以当前 6 Tab 信息架构为基础，统一「数据准备区→表格命令区→表格→状态反馈区→完成任务区」页面骨架；命令按作用域分区（导入/筛选/选择集/工作流完成），表格补齐当前行、选择集、三态全选与排序契约；范围确认、部分成功、取消中间态和破坏性确认按干扰层级分配到对话框、信息条与 Toast；覆盖浅色/深色/高对比度近似、键盘（Tab/方向键/F6/Ctrl+F/F5）与 Windows 断点。商品状态相关交互已对齐 T-662b/c/d、T-663~T-665、T-667 定稿（无状态列与状态下拉筛选，③无强制更新入口）。颜色 Token 取自 `app/gui/widgets.py`。使用模拟数据，不接生产接口；页脚「原型说明与验收边界」列出假设与不可仅靠 HTML 验收的项。 |

 应用图标（非效果图，是随程序发布的资源）：`app/assets/cmshopee-logo.svg` 是可编辑母版，`cmshopee.ico`（16–256 共 9 档）用于 exe 图标和 GUI 窗口左上角，`cmshopee-256.png` 为预览与非 Windows 回退。三者由 `py -3.10 scripts/gen_logo.py` 从同一份几何定义生成，改样式请改脚本后重新生成，不要单独手改某一个文件。
@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1120" height="720" viewBox="0 0 1120 720" font-family="'Segoe UI','Microsoft YaHei',sans-serif">
+  <defs><style>
+    .window{fill:#f5f7fa;stroke:#cfd6df}.header{fill:#203451}.title{fill:#fff;font-size:16px;font-weight:600}.tab{fill:#eef1f5}.tabText{fill:#556477;font-size:13px}.tabActive{fill:#fff;stroke:#d9e0e8}.tabActiveText{fill:#2167c9;font-size:13px;font-weight:600}.panel{fill:#fff;stroke:#d9e0e8}.h{fill:#1f2937;font-size:15px;font-weight:600}.label{fill:#39475a;font-size:12px}.muted{fill:#6b7788;font-size:11px}.card{fill:#fff;stroke:#cfd8e3}.thumb{fill:#e7eef7;stroke:#b8c8db}.default{fill:#e8f2ff;stroke:#8db8ed}.direct{fill:#fff7e8;stroke:#e5bc73}.badgeText{fill:#31506f;font-size:11px}.danger{fill:#fff1f0;stroke:#e39b94}.dangerText{fill:#a83b33;font-size:12px}.dialog{fill:#fff;stroke:#9caab9}.dialogTitle{fill:#172b4d;font-size:17px;font-weight:600}.dialogText{fill:#34465a;font-size:13px}.notice{fill:#fff7e8;stroke:#e5bc73}.noticeText{fill:#875a16;font-size:12px}.primary{fill:#2468c8}.primaryText{fill:#fff;font-size:13px;font-weight:600}.secondary{fill:#fff;stroke:#aebdcd}.secondaryText{fill:#31506f;font-size:12px}.divider{stroke:#e1e6ec}
+  </style></defs>
+  <rect class="window" x=".5" y=".5" width="1119" height="719" rx="8"/><rect class="header" x=".5" y=".5" width="1119" height="44" rx="8"/><rect class="header" x=".5" y="22" width="1119" height="22"/>
+  <text class="title" x="20" y="28">蝦皮圈優化助手</text><rect class="tab" x=".5" y="44" width="1119" height="40"/><text class="tabText" x="26" y="69">① 导入采集</text><text class="tabText" x="152" y="69">② AI生成</text><text class="tabText" x="257" y="69">③ 更新蝦皮</text><text class="tabText" x="392" y="69">账号管理</text><text class="tabText" x="496" y="69">设置</text><rect class="tabActive" x="580" y="48" width="130" height="36" rx="4"/><text class="tabActiveText" x="603" y="70">商品套图</text>
+  <rect class="panel" x="18" y="103" width="1084" height="47" rx="5"/><text class="label" x="34" y="132">套图任务 1</text><text class="label" x="655" y="132">账号：主店（papa）</text><text class="label" x="857" y="132">商品ID：51513423876</text>
+  <rect class="panel" x="18" y="162" width="424" height="534" rx="5"/><text class="h" x="36" y="194">商品原图</text><text class="muted" x="36" y="220">原图、卖点与生成设置保持可查看</text><rect class="thumb" x="36" y="240" width="112" height="90" rx="4"/><rect class="thumb" x="162" y="240" width="112" height="90" rx="4"/><rect class="thumb" x="288" y="240" width="112" height="90" rx="4"/><text class="h" x="36" y="373">生成设置</text><text class="label" x="36" y="403">比例 3:4　逐图主图 未开启</text><rect x="36" y="424" width="365" height="105" rx="4" fill="#f6f8fa" stroke="#d8dee4"/><text class="muted" x="50" y="452">商品卖点与要求已保存</text><text class="muted" x="50" y="474">当前失败图片可单独重新生成</text><text class="h" x="36" y="570">套图结构配置</text><text class="label" x="36" y="598">白底图 1 张　场景图 2 张　卖点图 2 张</text>
+  <rect class="panel" x="456" y="162" width="646" height="534" rx="5"/><text class="h" x="478" y="194">生成结果</text><text class="muted" x="478" y="219">来源按已保存任务显示，切换设置不会改变历史记录</text>
+  <rect class="card" x="478" y="244" width="182" height="224" rx="5"/><text class="label" x="491" y="269">白底图</text><rect class="default" x="583" y="252" width="63" height="21" rx="10"/><text class="badgeText" x="591" y="267">默认网关</text><rect class="thumb" x="491" y="285" width="156" height="132" rx="4"/><text class="muted" x="491" y="448">默认网关 · 生成成功</text>
+  <rect class="card" x="679" y="244" width="182" height="224" rx="5"/><text class="label" x="692" y="269">场景图</text><rect class="direct" x="778" y="252" width="69" height="21" rx="10"/><text class="badgeText" x="785" y="267">自定义网关</text><rect class="danger" x="692" y="285" width="156" height="132" rx="4"/><text class="dangerText" x="734" y="354">生成失败</text><text class="dangerText" x="692" y="448">自定义网关 · 失败</text><rect class="secondary" x="795" y="428" width="53" height="26" rx="3"/><text class="secondaryText" x="806" y="446">重试</text>
+  <rect class="card" x="880" y="244" width="182" height="224" rx="5"/><text class="label" x="893" y="269">卖点图</text><rect class="default" x="985" y="252" width="63" height="21" rx="10"/><text class="badgeText" x="993" y="267">默认网关</text><rect x="893" y="285" width="156" height="132" rx="4" fill="#f2f4f7" stroke="#d8dee7"/><text class="muted" x="936" y="354">已提交</text><text class="muted" x="893" y="448">默认网关 · 可继续查询</text>
+  <line class="divider" x1="478" y1="500" x2="1074" y2="500"/><text class="h" x="478" y="532">历史生成</text><text class="label" x="478" y="559">2026-07-20 14:20　店铺：主店　商品ID：51513423876</text><text class="label" x="478" y="583">来源：默认网关、自定义网关</text><text class="muted" x="478" y="609">继续查询只显示默认网关且已有任务编号的图片</text>
+  <rect x="0" y="0" width="1120" height="720" fill="#16253a" opacity=".28"/><rect class="dialog" x="292" y="194" width="536" height="344" rx="7"/><text class="dialogTitle" x="323" y="232">确认重新生成商品套图</text><line class="divider" x1="292" y1="252" x2="828" y2="252"/><text class="dialogText" x="323" y="286">这张图片上次通过自定义网关生成但未完成。</text><rect class="notice" x="323" y="302" width="474" height="67" rx="4"/><text class="noticeText" x="339" y="330">服务商可能对上次未确认请求已计费，</text><text class="noticeText" x="339" y="351">本次重新生成可能再次收费。</text><text class="dialogText" x="323" y="402">生成来源：自定义网关　图片比例：3:4</text><text class="dialogText" x="323" y="427">本次重新生成：场景图 1 张</text><rect class="secondary" x="614" y="480" width="74" height="31" rx="4"/><text class="secondaryText" x="637" y="501">取消</text><rect class="primary" x="700" y="480" width="97" height="31" rx="4"/><text class="primaryText" x="715" y="501">确认重新生成</text>
+</svg>