AI 视觉生产中心提示词工程
交付版本：4.34.1-candidate；当前产品变更 CR-20261009-045。产品操作见PRD，本文件只说明调用与装配。候选文件可供研发评审，不代表已切生产。
1. 按用户动作选择链路
| 动作 | 输入 | 执行 | 输出 |
|---|---|---|---|
| 后端卖点加载／下一步预览 | 商品数据、模板、当前卖点 | 确定性加载／派生，不调用AI | 单行列表／槽位预览 |
| 用户点击AI整理 | 商品资料＋当前卖点 | 卖点整理微任务，业务层分配ID | 模型输出{selling_points:[{title}]}，接口返回id/title |
| 套图点击生成 | 冻结商品、平台、模板、槽位、卖点、模型与语言规格 | 共用规划师逐槽输出完整Prompt→Java原样透传→图片模型 | 计划快照及逐图结果 |
| 普通单图编辑 | 当前采用父图＋参考图＋选区＋用户原文 | Java固定拼接→图片编辑模型 | 目标图新版本 |
| 模特商品图生成／编辑 | 商品图、身份图、画面参考、原文或父版本 | 直接候选确定性装配→图片模型 | 独立图片／编辑版本 |
| 模特身份创建／样例 | 身份描述和授权参考 | 创建Prompt来源待补齐，人工选择与确认规则已定 | 身份候选、多视角素材及配方 |
普通编辑和模特商品图不先用AI整理意图；可选“卖点AI整理”不改变这条边界。Planner只在普通生成分支使用，不在下一步预览执行。
2. 唯一来源
| 资产 | 唯一源／当前状态 | 消费范围 |
|---|---|---|
| 一期图片工坊 | prototype/ai-workspace-v2-prd/image-workshop-agent-prompt.html；登记active，仓库不能证明全部实际运行时 | 一期已有消费者，不与新候选重复注入 |
| 普通套图规划 | 规划师规范，研发包1.0.0 | 普通套图／商品图；旧模特Planner不用于当前模特直接链路 |
| 普通图片编辑 | 本文第4节 | Java按操作拼接，短固定规则 |
| 卖点整理 | 卖点整理Prompt，v1.3-candidate | 本地原文主动整理；模型仅title，业务层分配id |
| 模特商品图 | 装配合同＋规则JSON，1.2.3-candidate | 直接生成、四工具编辑；仅自定义可框选，场景／风格／换模特整图；两类参考 scopes 封闭映射、无文字请求 copy 置空 |
| 模特身份创建 | 完整规则及合同，1.1.0-candidate | 原型装配已接入；真实模型未执行 |
登记以 project-governance/prompt-assets.json 为准。固定文案只保留一份唯一源，阅读页从该源生成；示例、旧实验和构建说明不是运行Prompt。模特直接参考编译器：scripts/model-product-direct-prompt.mjs，Java实现遵守同一合同。
3. 可选卖点整理
唯一输入为用户确认后的 rawSellingPointText；模型返回selling_points:[{title}]，业务层分配id后回填逐条列表。商品库来源直接加载，不因弹窗打开而被改写。
三来源点击「AI 整理」先打开独立草稿弹窗；输入和取消不调用、不改正式原文、列表或预览，点击“确认并整理”后才进入整理中。成功回填统一逐条列表；失败保留原文与已有列表。原型为模拟整理，真实服务由后端接入。
原型是模拟整理，不能当作真实模型效果验证。
4. 普通图片编辑固定装配
图片顺序：图1是当前采用父版本；场景／风格仅有一个当前有效参考时，图2是该参考原图。自定义修改可按用户实际上传顺序传0–4张参考。无图就不虚构图号，历史编辑、其他工具和已替换的预设／上传图绝不进入新请求。
| 操作 | 固定指令 |
|---|---|
| 换场景（预设或上传） | 将图1的背景换成图2所示环境，保持图1的商品和文字内容不变；不复制图2商品、人物、文字或 Logo。 |
| 换风格（预设或上传） | 参考图2的视觉风格修改图1，可调整字体样式和排版，保持图1的商品事实和原有文字内容不变；不复制图2商品、人物、文案或 Logo。 |
| 自定义修改／无参考图的场景或风格编辑 | 使用用户实际修改要求；不凭空补参考图或场景 |
用户补充原文直接追加到操作指令，决定具体调整；参考只补充视觉，商品保留约束优先。商品快照保留服务端，不把 locked_context 长模板塞回编辑请求。文字内容与文字样式分开：风格可改字体与排版，不能擅自复制参考图里的文案、商品或Logo。
CR-20260929-039 范围门禁：下段局部选区固定增量只适用于“自定义修改”。换场景、换风格固定整图，即使自定义工具保留已保存批注草稿，也不能追加区域提示词或发送 region、regions、mask。服务端须拒绝场景／风格携带任一局部字段；此为确定性装配规则，不是模型能力推断。
局部选区固定增量：用户选择框选且有序 regions[] 均有效时，在上述操作指令后追加“仅修改图1中所框选的区域。区域外尽量保持图1的商品、文字与布局；参考图只用于本次目标变化，不复制其无关内容。”按编号顺序逐条追加“区域 N：{该区域的用户标注原文}”，每条文字与各自的原图像素坐标选区一一绑定，不合并成最后一条，也不让 Planner 或其他 AI 整理。任一未保存草稿不能提交；生产适配器若只支持单区而无法保持多区对应，应在调用前阻断并保留全部输入，不能丢弃多余区域。目标区域须以核实过的适配器形式独立传递，不能只靠文字冒充可靠选区；整图编辑不附区域增量、遮罩或历史标注。选区按父图原始像素坐标转换和裁剪，父图始终为第一输入，参考图有则在后。
| 适配器类别 | 局部装配及启用条件 |
|---|---|
| GPT-Image-2／Sunburst／Flare | OpenAI 官方 Image Edits 有 mask；路由确认后将选区转为与父图同尺寸、透明区为待编辑区的 alpha 遮罩，与父图、参考图、Prompt 按该路由的 JSON 或 multipart 形式提交，不混用两套字段。mask 是引导，不保证边缘精确。 |
| Seedream 5 Pro | 官方公开坐标／框选／箭头交互能力，公开请求未见独立 mask/region；“标注原图副本＋说明标注含义及去除标注”仅为候选适配，实际请求与效果验证前不启用局部生产提交。 |
| Seedream 5 Lite | 官方未将 Lite 列入 Pro／Flash 的交互编辑声明；不能直接塞 ERP region 或照搬 OpenAI mask。局部路由未验证时阻止生产提交，保留输入。 |
| Grok Imagine 2.0 | 已确认产品仅开放整图，公开 xAI JSON 示例未列 mask/region。框选入口和 box 提交须阻断，旧选区不得静默丢弃后冒充整图成功；前端限制待实施，本文不是已接入声明。 |
逐项依据和 UI／厂商模型 ID 差异见官方 API 证据记录。这是候选装配规范，不代表本仓库已有六模型局部编辑适配器或生产图片服务；真实接入先验证请求、响应、费用与实图保真，再考虑切生产。
不支持“参考＋选区”等组合时返回明确错误并保留输入，不静默改成整图、不调用额外Planner、不重生成整套。成功新版本记录父图、操作、原文、有序多区及其文字、参考和 Prompt 版本；普通图片编辑或恢复成功后默认采用目标图的新版本，失败不产生成功版本或改变采用。模特商品图仍为新版本手动采用，下载只取该图片当前采用版。
5. 普通套图统一规划
普通套图与图片工坊生成共用一个规划核心，按当前槽位调用，不再叠加总导演或维护三套规划Prompt。完整一期图型任务与当前事实、布局、用户要求进入一次规划请求；输出完整生图Prompt，Java原样传递并独立传规格和素材。详细职责见统一规划师。
不采用“只输出计划再由固定模板编译最终Prompt”的旧合同。固定规则和当前输入只是同一请求内容，不是两层模型调用。逐槽调用不等于整套一次调用。旧固定比例、全局内缩/色温和模特规划保留历史，不进入当前装配。
6. 模特商品图直接装配
合同及JSON不复制到本文。1.2.3-candidate 新生成且 reference.scopes=["完整画面"] 时，参考原图作为直接编辑底图排第一，随后商品依据、身份依据；旧范围参考仍为商品→身份→参考，无参考为商品→身份。消费者必须使用编译器返回的 images[index/ref/role] 有序数组，不能从 UI 上传顺序或旧固定序列推导。单图编辑图序仍为父图→可选商品→换模特时目标身份→0–4张编辑参考；不再注入旧身份图。
CR-20261008-041 的产品意图是预设与上传参考都尽量贴近整张画面，参考可见文字不再被默认禁止继承；用户明确文字、无文字设置、选定商品和模特身份优先。旧“仅参考构图背景／人物姿势”是历史规则，不能在新生成请求中继续作为默认门禁。唯一源已定向整合为 1.2.3-candidate；B4 一例经总控人工接受主要目标，但抓握、商品倾角及局部比例仍偏离，不能推论为稳定、逐像素或生产 API 效果通过。单图编辑参考 scopes 不受此生成变更影响。
生成传真实 language/copy，无文字不新增排版文字；模型、规格和数量作为Provider参数独立传递。编辑传 parentVersionId/adoptedVersionId、操作、范围、参考及 scopes。场景／风格固定作用且仅整图，换模特也仅整图；三者 region=null、无多区／mask。仅自定义在能力允许时提交 box。切工具保留自定义草稿，但其他工具不得继承选区；服务端明确拒绝场景／风格局部请求。
用户原文保持不改写；固定来源约束优先，参考只在选中范围起作用。返回Prompt版本、有序图片及父版本，结果独立保存，不能把最近预览图误作父图。
7. 发布、追踪和验证
- Prompt管理维持四类、稳定key、版本、启停、测试、引用追踪和恢复；不因候选增加普通用户入口。恢复为新版本，历史快照可追溯。
- 结构测试验证字段、角色、图序、版本和参数透传；真实模型验收验证商品／身份、文字、操作效果和未编辑区域，两者不互相替代。
- 编译器现有20项＋映射19项测试可复跑；旧Golden报告只代表原范围，不证明当前生产质量。
- 真实Provider的输入字段、最大参考数、Mask、费用、限流及错误码由接入验证；密钥仅后端注入。调用失败保留原输入，不自动新增付费调用。
- 候选切生产须具备实际效果证据和明确切换确认。本轮未切运行时。登记与文件结构校验不能冒充效果证明。
作图规划师模型配置（CR-20260922-022）
作图规划师使用 Luna（模型标识 gpt-6-luna），推理强度为中（medium）。这是规划调用配置，不是图片生成模型；普通单图编辑与模特商品图的直接调用链不因此新增规划调用。gpt-5.6-luna 是 CR-024 的历史配置，2026-09-24 后不再作为当前配置；历史实验与执行记录保留原样。
后端在实际规划请求中设置并记录模型与推理强度；不得只把“中等推理”写入提示词代替请求配置。历史实验中的low、high、max记录保留原样，不作为当前默认值。本文同步用户指定的研发配置，不宣称生产服务已切换或历史验收使用了medium。
CR-20260922-022 · 规划师研发交付包
本次确认的规划师规则、完整正文、装配和输出合同统一以规划师研发交付为准；旧2.6概述不再作为运行正文。Luna/medium，每个槽位一次；五金字体专项仅五金非详情图加载。原型界面不变，生产服务未切换。16份装配对照。
CR-20260928-026-PROMPT · 分组候选实测（未切生产）
普通套图的橱窗／详情显式分组路由候选已迭代为 1.1.1-candidate（CR-20260928-026-PLATFORM-GUARD）；线上阅读材料见候选规则与实测说明。1.1.0 的工程链路完成 16 条静态路由、16 次规划返回、15 次图片返回，1 条因规划内部矛盾在生图前拦截；无自动重试。每张已生图的最终 Prompt、图序、尺寸和模型参数均与计划记录核对一致。
该报告不是效果通过：存在物理场景不遵从、引线落点错误、平台标识误入画面、商品事实冲突与内部用语泄漏等问题，未获用户效果验收，也未切入生产消费者。1.1.1 针对 Shopee 标识问题新增护栏：platform/site/language 只作投放规则与本地化上下文，最终 Prompt 必须禁止擅加平台 Logo、名称、站点、水印、页面框架或官方背书；仍保留商品真实品牌、包装文字、标签和有据产地。该护栏本轮作为候选阅读材料交付，已有静态装配回归，未实图复验、未启用生产运行时。实验实际使用 gpt-5.6-luna / medium；现行规划配置为 gpt-6-luna / medium，后续规划只用后者，不得静默回退，因此不得将该实验当作 gpt-6-luna 的效果复验通过。
CR-20261009-045 · 画面要求示例的装配边界
本轮原型已获用户确认，基于线上f54bced增量修改；不是独立候选页替换。固定Prompt正文及编译器仍为1.2.3-candidate，没有新增模型调用、Planner或意图识别。
| 用户操作 | 界面保存 | 编译器/请求映射 |
|---|---|---|
| 选择商品、模特、可选画面参考 | 现有素材及reference快照 | productImages/modelImages/reference；图序以编译器images为准 |
| 空框点一个示例 | 填入示例完整文本，之后可编辑 | 生成时description取输入框最终原文，任务数据userText原样接收 |
| 有原文时选择追加 | 原文＋换行＋完整示例 | 只传拼接后最终原文；不传“追加”操作或示例标题 |
| 有原文时选择替换 | 原文替换成示例，可继续编辑 | 只传替换后最终原文；原文不混入Prompt |
| 暂不使用/关闭 | 保留原文 | 没有额外要求注入，也不发模型请求 |
| 选模型、数量、规格 | 原有生成设置 | Provider envelope独立承接；不拼入用户要求 |
| 选语言、填写图片文案 | 保持线上原字段 | language/copy原合同不变；无文字copy置空；空copy不授权自动翻译 |
示例唯一界面来源为prototype-src/ai-image-set-demo/src/instruction-examples.json；它不是业务Prompt固定正文，不把六条全部注入每次请求。示例是可编辑建议，不是模型能力保证。原型startGeneration目前只冻结description和其他设置并展示固定演示图，没有接入真实编译器/Provider，不能把快照或离线装配样本称为实际模型请求。
可复现装配检查：node --test scripts/model-product-instruction-contract.test.mjs。检查六条最终原文、追加/替换后原文、取消不新增提示、language/copy独立、Provider参数不进入任务数据及图序。输出样本：node scripts/model-product-instruction-contract.test.mjs不发送外部请求；有完整请求展示时应标记离线样本并记录Prompt版本，不能冒充历史实测入参。
已知边界：画面要求与独立语言/copy可能互相矛盾，沿用既有规则且不引入关键词判断；统一优先级仍为未确认建议。本轮没有证明译文、删字、构图等真实出图质量，也不启用完整形象实验1.3.x候选。