chengmaandClaude Opus 4.8
e2fbae2ee1
- 新增 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>
67 lines
5.9 KiB
Markdown
67 lines
5.9 KiB
Markdown
---
|
||
id: T-622
|
||
title: ⑥用「商品套图」模块替换现有 AI工场（迁移电商图生成器套餐模块）
|
||
phase: 7
|
||
deps: [T-564]
|
||
status: TODO
|
||
created: 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` 汇总。
|
||
|
||
## 待决 / 选型（实现前确认）
|
||
|
||
1. **技术栈**：推荐**原生 PySide6 重写 UI**、复用现有 `image_studio_*` 后端；已排除内嵌 WebView（避免 QtWebEngine 打包体积与依赖）。若坚持搬 WebView 需另评估。
|
||
2. 平台/国家/语言下拉的选中值如何进入生成上下文（提示词模板变量 or 生成请求参数），需与 `image_studio_generation` 对齐。
|
||
3. 效果图当前为「滚动区裁剪」呈现；如需一屏展示全部配置项，属实现期布局细节。
|
||
|
||
## 验收要点
|
||
|
||
- ⑥ 标签由「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 风控；生成/导出等本地操作不触碰 ③ 的线上提交边界。
|