diff --git a/docs/tasks/T-654.md b/docs/tasks/T-654.md new file mode 100644 index 0000000..251dc57 --- /dev/null +++ b/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:根据商品套图新增分类、生成目标提示词和自定义分类名缺失问题创建任务,待实现。