docs(tasks): add suite category prompt task

docs/tasks/T-654.md

@@ -0,0 +1,116 @@
+---
+id: T-654
+title: 扩展套图分类并统一生成目标提示词
+phase: 7
+deps: [T-637]
+status: TODO
+created: 2026-07-17
+---
+
+## 问题 / 背景
+
+商品套图目前只有白底图、场景图、卖点图和自定义分类，无法直接配置模特场景图、细节说明图。提示词设置弹窗的首行仍使用“套图名称”，而自定义分类名称没有明确进入最终发送给模型的提示词，容易导致生成目标与用户选择不一致。
+
+## 目标
+
+扩展商品套图的内置分类，并统一用“生成目标”表达本次图片的生成目标。预览提示词、保存的任务提示词和实际提交给 cmhub 的提示词必须保持一致；自定义分类必须把用户填写的分类名称明确带入最终提示词。
+
+## 方案
+
+### 1. 套图分类
+
+保留现有分类，并新增两个内置分类：
+
+- 白底图
+- 场景图
+- 模特场景图
+- 细节说明图
+- 卖点图
+- 自定义分类
+
+内置分类的显示顺序固定为上述顺序，自定义分类继续使用现有的名称校验、去重和数量配置规则。新增分类必须兼容现有数量配置；在用户没有主动配置数量时，不得静默增加生成任务、点数消耗或生成轮次。
+
+### 2. 生成目标字段
+
+提示词设置弹窗中，提示词结构第一行的标签从：
+
+```text
+套图名称:
+```
+
+改为：
+
+```text
+生成目标:
+```
+
+默认模板、编辑器、实时预览、任务快照和最终请求均使用新字段语义。新默认模板不得继续输出“套图名称:”。
+
+### 3. 内置分类固定描述
+
+生成提示词必须使用以下固定描述，文案保持原样：
+
+- 白底图：`生成 Shopee 台灣商品白底主圖，純白背景，商品清晰置中，不添加多餘文字。`
+- 场景图：`生成生活化使用場景圖，展示商品在真實情境中的用途與氛圍，畫面自然可信。`
+- 模特场景图：`生成模特或手持使用情境圖，畫面自然可信，商品為主角。`
+- 细节说明图：`生成商品細節特寫說明圖，突出材質、做工、接口、紋理或關鍵細節。`
+- 卖点图：`生成賣點詳解圖，使用繁體中文短文案呈現核心優勢，版面乾淨。`
+
+固定描述应由统一的分类目标映射生成，避免在 GUI、提示词组装和任务执行器中分别维护多份文案。
+
+### 4. 自定义分类
+
+自定义分类使用通用目标，并明确插入实际分类名称，最终提示词至少应表达为：
+
+```text
+生成自定义分类图片：{自定义分类名称}。
+```
+
+其中 `{自定义分类名称}` 必须替换为用户当前配置的分类名称，不能只输出“生成自定义分类图片”而丢失名称。分类名称需要经过现有校验后再进入提示词，避免空名称、重复名称或非法内容污染任务。
+
+### 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：根据商品套图新增分类、生成目标提示词和自定义分类名缺失问题创建任务，待实现。