6.1 KiB
6.1 KiB
id, title, phase, deps, status, created
| id | title | phase | deps | status | created | |
|---|---|---|---|---|---|---|
| T-654 | 扩展套图分类并统一生成目标提示词 | 7 |
|
DONE | 2026-07-17 |
问题 / 背景
商品套图目前只有白底图、场景图、卖点图和自定义分类，无法直接配置模特场景图、细节说明图。提示词设置弹窗的首行仍使用“套图名称”，而自定义分类名称没有明确进入最终发送给模型的提示词，容易导致生成目标与用户选择不一致。
目标
扩展商品套图的内置分类，并统一用“生成目标”表达本次图片的生成目标。预览提示词、保存的任务提示词和实际提交给 cmhub 的提示词必须保持一致；自定义分类必须把用户填写的分类名称明确带入最终提示词。
方案
1. 套图分类
保留现有分类，并新增两个内置分类：
- 白底图
- 场景图
- 模特场景图
- 细节说明图
- 卖点图
- 自定义分类
内置分类的显示顺序固定为上述顺序，自定义分类继续使用现有的名称校验、去重和数量配置规则。新增分类必须兼容现有数量配置；在用户没有主动配置数量时，不得静默增加生成任务、点数消耗或生成轮次。
2. 生成目标字段
提示词设置弹窗中，提示词结构第一行的标签从：
套图名称:
改为：
生成目标:
默认模板、编辑器、实时预览、任务快照和最终请求均使用新字段语义。新默认模板不得继续输出“套图名称:”。
3. 内置分类固定描述
生成提示词必须使用以下固定描述，文案保持原样：
- 白底图：
生成 Shopee 台灣商品白底主圖，純白背景，商品清晰置中，不添加多餘文字。 - 场景图：
生成生活化使用場景圖，展示商品在真實情境中的用途與氛圍，畫面自然可信。 - 模特场景图：
生成模特或手持使用情境圖，畫面自然可信，商品為主角。 - 细节说明图：
生成商品細節特寫說明圖，突出材質、做工、接口、紋理或關鍵細節。 - 卖点图：
生成賣點詳解圖，使用繁體中文短文案呈現核心優勢，版面乾淨。
固定描述应由统一的分类目标映射生成，避免在 GUI、提示词组装和任务执行器中分别维护多份文案。
4. 自定义分类
自定义分类使用通用目标，并明确插入实际分类名称，最终提示词至少应表达为：
生成自定义分类图片：{自定义分类名称}。
其中 {自定义分类名称} 必须替换为用户当前配置的分类名称，不能只输出“生成自定义分类图片”而丢失名称。分类名称需要经过现有校验后再进入提示词，避免空名称、重复名称或非法内容污染任务。
5. 兼容已有模板和任务
- 不得静默覆盖用户已有的
data/prompts/product_suite/base.txt或其他用户自定义提示词模板。 - 旧模板中的
{套图名称}、套图名称:等旧字段需要有明确的兼容或迁移处理，不能因为字段改名导致旧项目无法打开、预览或生成。 - 模板保存或迁移后，应统一校验必需占位词；缺失时给出中文提示并阻止提交无效任务。
- 生成任务应保存本轮实际使用的提示词快照，避免后续修改模板影响历史记录。
6. 任务规划和成本边界
build_job_specs、提示词组装和任务序列化必须识别新增内置分类。- 只有数量大于 0 且满足当前原图、逐图主图等既有规则的分类才进入本轮任务。
- 保持现有每张原图展开、数量、失败重试、历史轮次和点数统计语义，不因新增分类产生隐式重复任务。
- 不改变 cmhub 模型别名、图片下载、历史记录和导出流程。
验收要点
- 商品套图设置中可以配置“模特场景图”和“细节说明图”，并可保存、重新打开、参与任务规划。
- 新默认提示词首行显示“生成目标:”，不再输出“套图名称:”。
- 五个内置分类的最终提示词分别包含对应的固定描述，且文案与本任务定义一致。
- 自定义分类最终提示词包含实际分类名称，例如分类名为“结构展示”时，不能只出现通用“自定义分类图片”。
- 提示词编辑区域、预览区域、任务日志中的提示词快照和实际 cmhub 请求使用同一套组装结果。
- 预览内容与实际创建任务使用的提示词一致，不出现预览成功但任务仍使用旧字段或旧分类描述的情况。
- 已有项目、已有分类、已有模板和历史任务可以正常读取；用户模板不会被静默覆盖。
- 新增分类数量未配置或为 0 时，不增加本轮任务数和点数消耗。
- 现有商品套图生成、历史生成、导出、商品列表以及蝦皮采集/更新流程不回归。
文档同步
实现时同步更新：
docs/routes.md：商品套图分类、设置和提示词行为。docs/04-architecture.md：分类模型、提示词组装和兼容策略。docs/api.md：套图设置、分类和任务提示词快照的数据约定。- 本任务文件：实现记录、验证命令和最终状态。
- 如商品套图 UI 效果图展示分类或提示词字段，按需更新
docs/ui/及其索引。
边界（不改什么）
- 本任务不接入自定义大模型或新的图片生成服务。
- 本任务不修改 Shopee/CDP 采集、上传、拖拽和更新逻辑。
- 本任务不改变“生成标题/生成图片/生成图文”的上层生成模式选择。
- 本任务不强制为新增分类设置非零默认数量，不增加用户未选择的生成和计费。
执行记录
- 2026-07-17：根据商品套图新增分类、生成目标提示词和自定义分类名缺失问题创建任务，待实现。
- 2026-07-17：完成固定分类扩展、默认分类数量兼容、生成目标提示词、旧模板兼容和自定义分类名称注入；同步更新架构、路由与 API 文档。
- 2026-07-17：验证通过
python -m ruff check app tests main.py、python -m compileall app main.py、python -m unittest discover -s tests，共 579 个测试通过。