cmshoppe/docs/tasks/T-622.md at e2fbae2ee131e0e15bd852d22d98ab7022e994df

Files

T

chengmaandClaude Opus 4.8 e2fbae2ee1 docs: 落 T-622 ⑥商品套图替换AI工场（迁移套餐模块）+ 效果图

- 新增 docs/tasks/T-622.md：需求定稿+落地事实（全原生PySide6、复用image_studio后端与异步生图、绑账号+商品ID、去详情图、原生重写不引WebView）
- 新增 docs/ui/tab6-suite-package-v1.svg：家风效果图（顶部账号+商品ID、6图上传、2×2下拉去label、卖点框加高、结构3类、生成按钮toggle、可滚动区、右侧结果+进度）
- docs/ui/README.md 登记该效果图

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-07-13 15:20:42 +08:00

5.9 KiB

Raw Blame History

id, title, phase, deps, status, created

title

phase

deps

status

created

T-622

⑥用「商品套图」模块替换现有 AI工场（迁移电商图生成器套餐模块）

T-564

TODO

2026-07-13

问题 / 背景

顾客不满意最新代码里的 ⑥「AI工场」模块（现有原生 PySide6 实现，后端表 image_studio_*）。要求把 /mnt/d/chengma/虾皮圈电商图生成器源码 项目里的「商品套图（商品套餐）」模块交互迁移过来，替换现有 ⑥「AI工场」。

已核实的现状事实（落地依据，来自读码）：

cmshopee 全原生 PySide6，未引入 QtWebEngine / QWebChannel；迁移源是 QWebChannel + WebView 单页应用（web/index.html + web/app.js + web/style.css）。
现有 ⑥「AI工场」后端分层已完整，可复用：app/image_studio.py（领域 Project/Asset/Job/Selection）、app/image_studio_generation.py（异步生图）、app/image_studio_export.py（导出）、app/image_studio_images.py（图片处理）、app/image_paths.py；DB 表 image_studio_projects/assets/jobs/selections（app/db.py:293+）；提示词目录 data/prompts/image_studio/（app/appconfig.py:256）。
现有 AI工场 project 强绑定「账号别名 + 商品ID」（app/image_studio.py:148「缺少账号别名」、:291「缺少商品ID」）——顾客不满的是交互/UI，后端契约（绑账号+商品ID、异步生图）保留。
异步生图已接：POST /api/v1/generate/image/tasks + Idempotency-Key + task_id 轮询（app/ai.py:1104+，T-564 已落地）。

UI 已定稿：docs/ui/tab6-suite-package-v1.svg（本仓库家风：#2b3a55 头栏 / #2f6fed 蓝 / 微软雅黑；已在 docs/ui/README.md 登记）。

需求定稿（以 SVG 为准）

整体

⑥ 单一图片类型（去掉「详情图」，与套图合并；详情类目可用「自定义分类」加回）。
保留多任务并行（顶部「套图任务 1 / 2 / ＋」标签，互不阻塞）。
顶部上下文条：账号 下拉 + 商品ID 输入 + 拉取蝦皮主图 按钮（右靠、与「打开文件夹」同右边缘）；每个套图任务绑定一个账号+商品ID，切换任务随之切换。
采用原生 PySide6 重写 UI，复用上述 image_studio_* 后端与异步生图管线；不引入 QtWebEngine。

左侧配置面板（可滚动区 + 底部固定按钮）

商品原图上传：两行共 6 张缩略图（主图 / 参考1..5）+ 添加；支持点击/拖拽/粘贴，或「拉取蝦皮主图」带入；第 1 张为主图，最多 16 张。
生成设置：4 个可切换下拉（平台=Shopee / 国家地区=中国台湾 / 语言=繁体中文 / 比例=1:1），不显示 label（靠位置辨识）；+ 复选框「每张上传图分别作为主图生成」。
- 平台/国家/语言当前后端为固定单值，做成下拉是为将来多平台扩展；选中值须透传进生成提示词上下文，不得只做装饰。
商品卖点与要求：多行输入框（较高）+「✧ AI 帮写」按钮。
套图结构配置：默认仅 3 类「白底图 / 场景图 / 卖点图」，各带 − 数量＋ 计数器；＋添加自定义分类（可改名 / 删除）。
底部固定「▶ 生成套图（N）」按钮（在滚动区外，不随滚动）；点击后同一按钮切换为「■ 停止生成」（建议危险色）；取消独立「停止」按钮。按钮下方 label：建议填写产品名称、核心卖点、目标人群、使用场景与禁用元素。
除「生成套图」按钮外，其余组件同属一个竖直滚动区。

右侧结果区

工具栏：生成结果 + 共 N 张·成功 M 张 徽标 + 历史生成 + 打开文件夹。
结果网格：每张卡片显示图片/生成中骨架/失败（带「重试」）；右键单图可预览 / 复制路径 / 重新生成。
底部一行（与左侧「生成套图」按钮同高）：进度条 + 套图 X/Y（秒）· 失败 N 汇总。

待决 / 选型（实现前确认）

技术栈：推荐原生 PySide6 重写 UI、复用现有 image_studio_* 后端；已排除内嵌 WebView（避免 QtWebEngine 打包体积与依赖）。若坚持搬 WebView 需另评估。
平台/国家/语言下拉的选中值如何进入生成上下文（提示词模板变量 or 生成请求参数），需与 image_studio_generation 对齐。
效果图当前为「滚动区裁剪」呈现；如需一屏展示全部配置项，属实现期布局细节。

验收要点

⑥ 标签由「AI工场」交互替换为「商品套图」布局，功能对齐 SVG；旧 AI工场入口不再暴露。
顶部账号+商品ID 生效：切换任务/账号/商品ID 正确带入；「拉取蝦皮主图」把线上主图拉进「商品原图」。
套图结构 3 类默认 + 自定义分类增删改；数量计数正确，合计张数与「生成套图（N）」一致。
生成走异步管线（复用 T-564）：提交→轮询→逐张落盘；单张失败可重试；「生成⇄停止」toggle 正常；多任务并行互不阻塞。
平台/国家/语言/比例选中值确实进入生成上下文（非装饰）。
复用现有 image_studio_* 表与目录，不新造并行后端；不引入 QtWebEngine。
验证：py -3.10 -m unittest（相关模块）、python -m ruff check app tests main.py、py -3.10 -m compileall app main.py、git diff --check 全绿。

边界（不改什么）

不改动 image_studio.py / image_studio_generation.py / image_studio_export.py 的后端数据契约与异步生图协议（仅按需扩展字段）。
不动 ①~⑤ 既有标签与流程。
不引入 QtWebEngine（采纳原生重写方案时）。
安全红线：不写真实凭证到代码/文档/日志；config.json、cmshopee.db、images/ 等不提交；不绕过 Shopee 风控；生成/导出等本地操作不触碰 ③ 的线上提交边界。

5.9 KiB Raw Blame History Unescape Escape