diff --git a/docs/tasks/T-657.md b/docs/tasks/T-657.md new file mode 100644 index 0000000..e7c9a9c --- /dev/null +++ b/docs/tasks/T-657.md @@ -0,0 +1,61 @@ +--- +id: T-657 +title: 为参考图规则变量补充规则标签 +phase: 7 +deps: [T-656] +status: TODO +created: 2026-07-17 +--- + +## 问题 / 背景 + +商品套图默认模板中的 `{参考图规则}` 当前只渲染规则正文。用户希望最终提示词能明确标识该段内容的用途,因此两种逐图主图模式都需要在变量值前增加 `参考图规则:` 标签。 + +## 目标 + +保留 T-655 已确定的两种参考图正文,只在变量内容最前面统一增加: + +```text +参考图规则: +``` + +最终变量值为: + +- `per_image_primary=true`:`参考图规则:当前上传图片是本任务唯一主参考图;保持商品主体、款式、颜色和关键细节准确;不编造用户与参考图均未提供的信息。` +- `per_image_primary=false`:`参考图规则:使用第一張上傳圖作為主商品圖,其餘圖片只作為參考。` + +## 方案 + +- 在 `product_suite_prompt_context()` 中统一生成带 `参考图规则:` 前缀的 `{参考图规则}` 值,继续根据归一化的 `per_image_primary` 切换正文。 +- 默认模板保持 `{参考图规则}` 独占一行,不再额外添加第二个标签,避免重复显示。 +- 提示词设置弹窗预览、`build_suite_prompt()`、`build_job_specs()` 和 job prompt 快照继续共用同一个 renderer。 +- 更新两种模式的纯逻辑测试和 GUI 预览断言,确保前缀、正文和模式切换都准确。 +- 已有用户模板不静默覆盖;模板中的 `{参考图规则}` 会自然得到新变量值,旧模板兼容策略不变。 + +## 验收要点 + +- 未勾选逐图主图时,`{参考图规则}` 以 `参考图规则:` 开头,后接单主图模式正文。 +- 勾选逐图主图时,`{参考图规则}` 以 `参考图规则:` 开头,后接逐图主图模式正文。 +- 最终提示词中不出现两个连续的“参考图规则”标签。 +- 预览文本、实际 job prompt 和保存的 prompt 快照完全一致。 +- T-656 的“生成目标:{套图名称},{生成目标}”首行、分类描述、数量和历史流程不回归。 + +## 文档同步 + +实现时同步更新: + +- `docs/routes.md`:参考图规则最终提示词示例。 +- `docs/04-architecture.md`:参考图规则变量契约。 +- `docs/api.md`:`product_suite_prompt_context()` 返回值说明。 +- 本任务文件:执行记录、验证命令和最终状态。 + +## 边界(不改什么) + +- 不修改两种模式的参考图正文,不修改 `per_image_primary` 的任务数量规划。 +- 不修改默认模板的其它字段、分类描述、cmhub 接口或生图流程。 +- 不修改 Shopee/CDP 采集、上传、拖拽和更新逻辑。 +- 不静默迁移或覆盖用户已保存的提示词模板。 + +## 执行记录 + +- 2026-07-17:根据用户要求创建任务,待实现。