55 lines
2.3 KiB
Markdown
55 lines
2.3 KiB
Markdown
---
|
|
id: T-658d
|
|
title: 商品套图多图参考 GUI 与全流程回归
|
|
status: TODO
|
|
phase: 7
|
|
deps: [T-658a, T-658b, T-658c]
|
|
created: 2026-07-17
|
|
---
|
|
|
|
# T-658d 商品套图多图参考 GUI 与全流程回归
|
|
|
|
## 问题 / 背景
|
|
|
|
多图参考会改变用户对「每张上传图分别作为主图生成」选项的理解。需要在商品套图界面和生成确认流程中明确说明两种模式，同时验证多图提交不会破坏历史任务、点数展示、异步轮询和其他模块。
|
|
|
|
## 方案
|
|
|
|
- 在逐图主图勾选项旁增加中文 helper：
|
|
`多款式/多SKU图请勾选；同一商品多角度图不勾选，其余图将作为参考图一同提交。`
|
|
- 生成确认弹窗说明当前模式、主图与参考图数量、配置生成张数和预计请求点数。
|
|
- 上传超过 8 张时明确提示仅使用前 7 张参考图，其余不参与本轮生成。
|
|
- 以 `1180x760` 和最小窗口尺寸检查 helper、确认文案不截断、不重叠。
|
|
- 增加端到端回归：不勾选多角度图、勾选多 SKU 图、单图、3 图、9 图、历史 NULL job、重试恢复和参考图缺失。
|
|
- 验证取消、失败、自动重试、轮询、点数展示和生成历史不受影响。
|
|
- 验证 ② AI 生成封面、AI 帮写、③ 更新蝦皮、CDP 流程不受影响。
|
|
|
|
## 验收要点
|
|
|
|
- 用户能在生成前理解两种参考图模式及实际图片数量。
|
|
- 多图请求失败时显示中文可操作提示，不暴露内部接口路径或原始堆栈。
|
|
- 9 张图片只提交主图加 7 张参考图，并在确认框和日志中说明。
|
|
- 全流程测试通过，历史单图任务仍可查看、恢复和重试。
|
|
- GUI 最小窗口下布局稳定，所有用户可见文字符合中文规则。
|
|
|
|
## 边界（不改什么）
|
|
|
|
- 不修改 cmhub 服务端协议、计费、并发和轮询策略。
|
|
- 不修改 ③ 更新蝦皮、CDP、主图拉取和 AI 帮写的业务逻辑。
|
|
- 不实现多 SKU 自动识别或多图联合生成拼图。
|
|
|
|
## 验证
|
|
|
|
```bash
|
|
py -3.10 -m unittest tests.test_product_suite_gui
|
|
py -3.10 -m unittest tests.test_product_suite tests.test_image_studio tests.test_image_studio_generation
|
|
py -3.10 -m unittest discover -s tests
|
|
py -3.10 -m ruff check app tests main.py
|
|
py -3.10 -m compileall app main.py
|
|
git diff --check
|
|
```
|
|
|
|
## 执行记录
|
|
|
|
- 待实现。
|