AI 视觉生产中心研发契约
产品 PRD 版本：4.34.1-candidate 前端实施契约版本：4.34.1-candidate 来源变更：CR-20261009-045 确认依据：用户确认以新02最新原型85987a8为准，原文整理与逐条卖点列表按本次收口规则执行；CR-20260929-034 将场景／风格参考收敛为当前工具唯一有效参考，预设与上传互斥，编辑快照记录真实有序图源而非数量。 迁移模式：incremental 覆盖页面：P-WORK-MANAGEMENT-VISUAL-SUMMARY、P-VIS-WORKSHOP、P-VIS-MODEL-PRODUCT、P-VIS-TEMPLATE、P-VIS-MODEL、P-VIS-PROMPT。 未覆盖页面：只读
来源与范围
业务规则只在产品 PRD定义。本文件补充数据、组件、状态与调用边界，不复制历史方案或把演示接口当生产接口。验收清单承接测试；旧编号见迁移索引。
页面清单
| 页面 ID | 页面 | 核心任务 |
|---|---|---|
| P-VIS-WORKSHOP | 图片工坊 | 套图输入、预览、生成、编辑、下载 |
| P-VIS-TEMPLATE | 模板中心 | 双组结构、布局、默认规格、版本 |
| P-VIS-MODEL | AI 模特库 | 身份创建／上传、人工确认、共享管理 |
| P-VIS-MODEL-PRODUCT | 模特商品图 | 商品＋模特直接生成、四工具编辑 |
| P-VIS-PROMPT | Prompt 管理 | 唯一源、版本、测试、使用追踪 |
| P-WORK-MANAGEMENT-VISUAL-SUMMARY | 工作管理视觉任务 | 真实输入／输出、状态与继续 |
产品功能覆盖矩阵
覆盖状态表示原型交互范围，不代表后端已接通；旧 F 编号合并映射保留，不删除来源。
| ID | 页面/表面 | PRD 来源 | 已确认产品功能 | 实现目标 | 状态 | 说明 |
|---|---|---|---|---|---|---|
| F-VIS-078 | P-VIS-WORKSHOP | 第1节 | 统一逐条卖点与确认式原文整理 | 商品库直载；AI整理先开草稿弹窗，确认才模拟整理；均可增删改 | 实现 | CR-20260928-029 |
| F-VIS-082 | P-VIS-WORKSHOP | 第2节 | 下一步预览、右侧生成 | 两个动作职责分离，结果平铺 | 实现 | CR-013 |
| F-VIS-076 | P-VIS-WORKSHOP | 第2节／下载 | 同套图双组展示、本次卡片删除撤销与直接下载反馈 | 同一套图 Tab 内上下分组；保护必需白底主图，其余卡片仅在本次预览删卡并撤销；下载直接准备当前采用版本 | 实现 | CR-20260929-036 |
| F-VIS-075 | P-VIS-TEMPLATE | 第3节 TC026 | 双组目录、4＋4默认与版本 | 独立用途/布局/文字；保存重开、预览和历史恢复 | 实现 | CR-20260928-026 |
| F-VIS-095 | P-VIS-WORKSHOP/P-VIS-MODEL-PRODUCT | 第4节 | 单图编辑 | 普通编辑参考先选后确认；仅自定义可框选并独立维护多条标注；场景／风格整图且不得携带局部信息；成功新版普通图片自动采用、模特图仍手动采用 | 实现 | CR-20260929-039；模特四工具保留 |
| F-VIS-081 | P-VIS-MODEL | 第5节 | 身份素材与创建 | 分位上传、人工确认、候选 Prompt 装配快照与真实执行边界；18 位／72 张已验收导入素材独立呈现四视角、来源状态与逐图提示词，旧演示记录隔离 | 实现 | CR-20260930-040；来源原始状态与用户上线授权分开，未记录请求回执不补造 |
| F-VIS-080 | P-VIS-MODEL-PRODUCT | MP025-01～05 | 直接生成及编辑 | 左输入右批次、一个有效整图参考、用户原文直连、四编辑与版本隔离 | 实现 | CR-20261008-041；1.2.3-candidate 固定 Prompt 已整合，B4 单例主要目标人工通过；生产与稳定性另验 |
| F-VIS-098 | P-VIS-WORKSHOP/P-VIS-MODEL-PRODUCT | 第7节 | 模型与规格 | 六模型、两栏规格、真实自定义 | 实现 | 不自动替换 |
| F-VIS-086 | P-VIS-PROMPT | 第8节 | Prompt 管理 | 版本、测试、状态与权限 | 实现 | 唯一源引用 |
| F-VIS-104 | P-WORK-MANAGEMENT-VISUAL-SUMMARY | 第8节 | 继续来源任务 | 完成可调整、生成只读、缺快照禁用 | 实现 | 不新建任务中心 |
页面设计决策
共用 Ant Design Pro ERP 基线：references/ui-review/ant-design-pro-baseline.md、erp-ui-design-system.md。以下描述既有页面，不另设计新布局。
P-VIS-WORKSHOP
- 产品范式：图片生产工作台
- 页面母版：固定双栏 PageContainer
- 页面目标：完成套图生成
- 主用户任务：选模板、维护输入、预览、生成
- 信息优先级：一级预览与结果；二级输入与参数；三级错误及历史
- 主操作：左下一步、右生成／重新生成
- 密度策略：compact
- 视觉强调：decision-first
- 视觉强调对象：预览与结果
- 动效策略：minimal
- 动效说明：加载与结果原位更新，不因状态切换重排
- 推荐组件：Form、Tabs、Image、Progress、Drawer
- 必须避免：重复确认页、结果重排
P-VIS-TEMPLATE
- 产品范式：模板管理
- 页面母版：ProTable + 独立编辑页
- 页面目标：维护可复用模板
- 主用户任务：双组编排、配置与保存
- 信息优先级：一级槽位与当前设置；二级范围与版本；三级历史
- 主操作：新建／保存
- 密度策略：compact
- 视觉强调：form-first
- 视觉强调对象：当前槽位
- 动效策略：minimal
- 动效说明：加载与结果原位更新，不因状态切换重排
- 推荐组件：ProTable、Form、Radio.Group、InputNumber
- 必须避免：配置区沉底、无类型槽位
P-VIS-MODEL
- CR-20260930-040 接入层：只读取正式交付
delivery-manifest.json的 72 个白名单记录及revision-overrides.json，按identityId/lookId/view/file/sha256/status/issue校验并冻结为 18 组四视角。前端详情将各图片 URL 与本批逐图离线提示词、历史复用来源分别展示；原清单状态不覆盖独立的用户上线授权。缺历史完整提示词或请求 ID／参数／用量时显示未保存，不能以离线提示词构造执行回执。 - 当前可选身份集合为本批及后续创建且启用、非旧演示的记录；模特商品图初选、选择器、换模特共用该过滤。3 条旧演示记录在单独列表保留原状态，历史批次快照保持原引用。页面级“新建为原型模拟”不应用来描述本批已有素材。构建产物须包含 72 张图片，线上路径按原型目录相对拼接，不得指向站点根目录或开发机文件。
- 产品范式：共享素材管理
- 页面母版：ProTable + 创建Drawer
- 页面目标：建立共享成人AI身份
- 主用户任务：生成／上传、逐张确认、启停
- 信息优先级：一级身份素材；二级来源与状态；三级配方
- 主操作：创建／确认保存
- 密度策略：compact
- 视觉强调：data-first
- 视觉强调对象：身份图片
- 动效策略：minimal
- 动效说明：加载与结果原位更新，不因状态切换重排
- 推荐组件：Upload、Steps、Image、Drawer
- 必须避免：AI自动验收、配方复用旧身份
P-VIS-MODEL-PRODUCT
- 产品范式：图片生产工作台
- 页面母版：固定双栏 PageContainer
- 页面目标：生成模特商品图
- 主用户任务：商品、身份、参考及结果编辑
- 信息优先级：一级结果；二级生成输入；三级版本
- 主操作：生成／编辑／下载
- 密度策略：compact
- 视觉强调：decision-first
- 视觉强调对象：结果图片
- 动效策略：minimal
- 动效说明：加载与结果原位更新，不因状态切换重排
- 推荐组件：Form、Tabs、Image、Drawer
- 必须避免：聊天步骤、前置AI解析、未成功或未提交时改变采用版；普通图成功编辑自动采用，模特图仍手动采用
P-VIS-PROMPT
- 产品范式：配置管理
- 页面母版：ProTable + 独立编辑页
- 页面目标：治理Prompt版本
- 主用户任务：查看、编辑、测试、恢复
- 信息优先级：一级内容和测试；二级版本状态；三级使用记录
- 主操作：保存／测试
- 密度策略：compact
- 视觉强调：form-first
- 视觉强调对象：Prompt配置
- 动效策略：minimal
- 动效说明：加载与结果原位更新，不因状态切换重排
- 推荐组件：ProTable、Form、Tabs
- 必须避免：普通用户系统Prompt入口
P-WORK-MANAGEMENT-VISUAL-SUMMARY
- 产品范式：共享任务列表
- 页面母版：现有ProTable + 详情Drawer
- 页面目标：定位并继续视觉任务
- 主用户任务：看输入输出与状态、继续来源任务
- 信息优先级：一级任务ID与成品；二级输入和进度；三级历史缺失说明
- 主操作：查看详情／继续调整
- 密度策略：compact
- 视觉强调：data-first
- 视觉强调对象：任务ID及真实图片
- 动效策略：minimal
- 动效说明：加载与结果原位更新，不因状态切换重排
- 推荐组件：ProTable、Image、Badge、Drawer
- 必须避免：用Prompt代替图片、伪造历史映射
页面-区域-组件映射
| 区域 | 实现 |
|---|---|
| 商品输入 | 三个来源按钮＋对应 Modal；商品库来源直接回填逐条卖点；本地无回填时显示待整理原文框和同一份逐条列表；商品资料与目标用户使用可放大文本框 |
| 模板选择 | 单模板单行单选，名称／范围／版本／布局示例，应用后生效 |
| 套图成果 | Tabs 按套图，稳定 key 的图片卡按槽位原序展示，状态原位更新 |
| 模板编辑 | 橱窗／详情切组；槽位列表与选中项配置相邻；窄屏顺排 |
| 单图编辑 | Drawer 内 AI编辑／版本记录；工具、范围、参考与用户要求共用提交 |
| 规格 | 同一触发器的两栏比例／尺寸浮层＋自定义输入；Grok显示比例／档位 |
| 模特素材 | 每个位置独立 Upload 与预览，必需／推荐可辨认；用户描述、完整 Prompt、视角 Prompt、真实执行记录分开显示；仅文字复用 |
普通控件契约
业务字段的必填、权限、默认值以 PRD 为准。切来源只在该来源选择流程内发生；取消不覆盖当前已应用数据。长字段放大约72vw、最大960px、编辑区约70vh，确认回填。卖点编辑器位于来源入口之后、长资料字段之前：三来源均展示可编辑逐条列表；原文仅进入“AI 整理”弹窗草稿，未确认不会写入列表。列表数据仍只有id/title，不另加 description 或 evidence；不裁掉超过22字的原文。
商品和卖点数据
| 字段 | 类型/来源 | 规则 |
|---|---|---|
| source／sourceId | 来源枚举及系统ID | 本地、Listing、产品系统；系统名称留后台，不作前台必填 |
| productImages | 有序资产引用数组 | 保留角色与主参考，不用生成结果当商品真源 |
| productBrief | 字符串 | 可验证资料，人工可编辑 |
| targetAudience／specialRequirements | 字符串 | 可空，原样保存，不补猜 |
| selling_points | {id:string,title:string}[] | 后端直载及AI整理同形；无长描述，保持条目绑定 |
AI整理弹窗以独立草稿保存rawSellingPointText；本地、Listing、产品系统均可打开。输入草稿、取消与关闭均不写正式原文、不改变已有列表或预览；仅“确认并整理”将草稿保存为正式原文并发起整理。该输入不带商品资料、目标用户、模型生成 ID 或历史列表。输出为{selling_points:[{title}]}；调用方为有效结果分配本次草稿 ID 后回填同一份{id,title}列表。格式错误、额外字段、空白条目或过期响应不能覆盖原文或已有列表。旧任务保留旧快照。
AI 整理成功后更新当前卖点列表并使受影响未提交预览刷新；人工仅删除时按卖点ID局部删除对应槽位。处理中防止同一整理重复提交；响应按原文修订号归属，不覆盖用户之后的修改。原型仅演示切句，无真实模型成功率承诺。
规格与模型请求
outputSize 按现有控件契约保存；像素宽高与Grok比例档位是互斥表达，不能同时发送。精确宽高为正整数，比例由最大公约数求得。模型枚举、当前13项尺寸预设和阈值唯一表在 PRD 第7节。UI不自动隐藏候选，但应用与提交均说明不合法原因。切模型不重置槽位。编辑和历史实际尺寸不冒充本次计划值。
资料依据沿用尺寸任务记录：OpenAI、火山方舟、xAI。产品对三个GPT使用统一阈值不等于供应商所有路由已验证。
复杂控件契约
套图批次和预览
previewReady仅为前端未提交状态；左下一步设置可检查预览，右生成才请求后端创建批次。旧“下一步切页签后再确认”删除。- 本次预览
deletedSlots[]只作用于当前套图草稿，删除可撤销；必需白底商品主图禁删，删除其他卡片不修改模板槽位、卖点列表或其他套图。排序重新编号但保留槽位稳定 ID。提交后不提供预览删卡入口。 suiteCount、每套slots[]、每槽slotId/role/layout/layoutSpec/outputSize/sellingPointId分开保存；模板versionId与两组槽位冻结。生成前保持用户确认顺序，后台返回顺序不改变UI排序。- 按事件中的批次／父任务／槽位／执行ID更新对应卡，事件重复或乱序不得回退已完成状态；重连从服务端快照补齐。生成失败保留输入。
- 再次整套生成建立新批次及版本集合；局部编辑只建立目标图新版本；不可只给旧图片递增数字。
编辑请求和版本
| 字段 | 必须行为 |
|---|---|
| operation | 普通 custom/scene/style；模特另有model |
| parentVersionId／parentImage | 来自当前采用版，不能取最近预览版或数组末项 |
| scope／regions | 仅 custom 可为 box，携带有序的多条 {id, region, text}，各条独立有效；scene/style/model 必须为 whole，region=null、regions=[]、mask=null。后端对 scene/style 的 box 或非空区域／遮罩明确拒绝，不以忽略字段替代。生产路由若只能处理单区，提交前说明并保留 custom 全部批注，不静默丢弃 |
| userText／description | 用户原文；不先调用AI改写 |
| selectedReference／editReferences | 场景选择和补充文字独立保存，资产／来源／作用／顺序完整 |
| targetModelImages | 仅换模特，目标身份必需；不同时注入旧身份 |
| selectedGenerationModelRef | 用户选定模型；不提交前台plannerKey，不静默换模型 |
普通换场景／换风格的单一参考先在选择器内以候选状态预览，明确确认后才替换当前有效参考。选择器取消、上传失败或关闭不写入编辑请求；移除参考不清除独立保存的补充文字。仅 custom 可连续框选多处，按绘制顺序编号，每条独立保存、重开、取消和删除；新增不覆盖既有条。未保存草稿不能提交 custom 图片编辑；custom 内切回整图清除本次局部条目，但切换到场景／风格／换模特时保留 custom 已保存草稿以便切回，绝不透传到其他工具。批注“保存”只确认本次输入并关闭浮动操作条，独立提交成功才创建图片版本。custom 快照保留有序多区及原文；scene/style/model 快照仅整图、空区域／遮罩及当前工具有效参考。编辑预览显示该图本次请求的宽×高，Grok 仅显示比例与档位，不伪装实际像素。
局部编辑请求的 regions 是 ERP 内部有序条目，不能未经适配就作为供应商 API 参数。前端只提交父版本、当前工具有效参考、原文、多条选区和选中模型；后端逐条将预览坐标换算为父图原始像素坐标，校验非空、边界与父图尺寸，按配置的 UI 值 → Provider → 模型 ID → 端点/传输格式 决定是否允许本次提交。既有单区能力证据不等于多区生产能力已验证；多区组合不支持时提交前阻止，保留所有输入，不创建执行或成功版本；不能自动切换模型、范围或删除参考。整图请求的区域与历史遮罩必须为空。
| 局部编辑路由／契约状态（2026-09-29） | 供应商公开请求字段与映射 | 项目接入门禁 |
|---|---|---|
OpenAI gpt-image-2、gpt-image-2-5-sunburst、gpt-image-2-5-flare；厂商级字段已核对，项目路由待核对 | 官方 POST /images/edits 列 images（父图第一张，参考图随后）、mask、model、prompt；JSON 图源对象与 SDK multipart 文件是不同传输形式。UI 的 2-5 对应厂商 2.5，不得原样透传。遮罩与父图同尺寸、有 alpha；透明为待编辑区。 | 仅在项目路由确认模型、传输形式、遮罩与参考图组合且通过参数校验后启用；不承诺边界像素级保持。 |
| Seedream 5 Pro；厂商交互编辑已公开，项目映射待验证 | 官方能力包含框选／坐标／箭头交互；公开生成请求列 model、prompt、image，未见独立 mask/region 请求字段。候选方案是带标注的原图副本加标注说明，不是原生 Mask。 | 标注副本、提示词与去标注结果须实测，未通过前阻止局部生产提交。 |
| Seedream 5 Lite；原生选区能力未核实 | Lite 不在 Pro/Flash 的交互编辑声明内；不能把 Pro 的定位能力顺推给 Lite。 | 在可验证路由出现前阻止局部生产提交；整图能力单独核验。 |
| Grok Imagine 2.0；产品仅整图编辑，前端待实施 | xAI POST /v1/images/edits 使用 JSON 图像＋文字，公开示例未列 mask/region，不能套 OpenAI multipart。 | 普通图片与模特商品图均须禁用框选并说明原因；旧选区不自动清除、转整图或产生成功版本，提交前拒绝 box。当前原型尚未实施该限制，刘彬后续处理。 |
官方资料：OpenAI Image Edits、OpenAI mask guide、火山引擎方舟图片生成 API、xAI Image Editing。这些是厂商文档地址，不是本项目生产 API host；鉴权、响应、重试、幂等与错误码尚未在项目路由验证，禁止据此填写已部署地址或自动重试。逐项证据及口径差异见API 证据记录。
模特请求映射使用直接合同：editReferences[].scopes 必传，场景为场景、风格为风格、custom/model为用户文字限定的画面参考；最多4张。普通编辑遵守实际接入能力，不把模特候选4张上限扩大为所有模块。
CR-20261008-041 模特商品图生成参考快照：生成只能冻结一张当前有效的预设或上传参考，沿用现有字段为 reference: { image, source: "preset" | "upload", scopes: ["完整画面"] } | null；source 由实际选择路径写入，不靠地址或名称猜测。“完整画面”是产品意图值，不是模型效果证明或生产 Provider 字段。旧批次仍按旧“构图与背景／人物姿势”值解释，不回写为整图参考。新生成页不展示、也不从候选素材默认值推导旧范围勾选；清除参考置 null，取消选择弹层保留原图，替换只传新图，重新开始清空当前参考和来源。冻结时保留用户画面原文、语言及文案草稿；“无文字”发送空渲染文案并要求移除参考文字但保留便签底／装饰。有参考且没有明确文案要求时，默认保留参考可见文字原文，不因默认语言自动翻译；有明确文案／画面要求时其内容优先。商品图与已确认模特身份不得被参考替换；既有平台标识规则不变，本轮不增加新的识别或阻断流程。图片模型、数量、尺寸仍独立参数。1.2.3-candidate 装配返回的 images[index/ref/role] 为唯一请求图序：新完整画面参考是参考底图→商品→身份；旧范围参考是商品→身份→参考；无参考是商品→身份。前端或 Java 不能按 UI 上传顺序重排。此合同只覆盖生成，不修改上述单图编辑 editReferences[].scopes 和四工具规则；B4 单例主要目标人工通过不等于稳定复刻或生产 API 接入。
版本包含独立结果图 URL、父版本、请求快照、操作、时间和状态。列表逐版显示结果缩略图，点击查看在左侧显示该版成图；对比当前采用版是独立操作，不变更采用关系。普通图片编辑／恢复成功的同一原子状态更新追加新版并设为目标图当前采用版，失败不改变；手动采用旧版只更新目标图下载及下次编辑父图引用。模特商品图保持成功后手动采用。Provider预览帧不算版本。原型模拟也必须生成可显示的独立结果图；技术装配留在契约，不在操作面板堆叠说明。
套图导出按每套的 橱窗图/详情图 文件夹组织；用户可见文件名固定为 顺序_图片类型_相关信息_尺寸.扩展名：精确尺寸写作 宽x高，Grok 档位写作 比例_1K/2K，不把档位伪装为像素。卖点图取对应卖点，其他图取用途或类型说明。原型点击下载后直接反馈模拟准备，必须明确未生成真实 ZIP；不再以弹窗展示内部目录、任务、版本或清洗规则。
模板与模特
模板 showcase/detail 两组分别使用 showcaseSlotConfigs/detailSlotConfigs；旧仅有 slotConfigs 时只迁入橱窗。新建与添加查分组目录，深复制后独立编辑；槽位ID带分组，当前图片保留 compositionGroup。purpose/textEnabled/copy/layout/outputSize 和顺序随槽位保存，关闭文字保留草稿。复制/删除改变该组张数，不触及另一组。新建不继承演示商品的sellingPointId或成品文案。详情逐张输出。
TC026继承既有ProTable列表及双组编辑器，只在槽位相邻设置区补用途与文字设置；不新增页面、审批或模型调用。新建默认与兼容规则见PRD第3节TC026。保存及恢复复制完整结构为新版本，任务引用不回写。合并的slotConfigs保留组标识，预览/任务快照不丢分组；旧槽位在读取边界按其所在数组识别，不改历史内容。
本轮原型是本地模拟。普通生成的“分组×类型”规划映射与水泵/抹茶实图由独立候选实验验证，不能以页面分组或本地构建证明提示词差异已通过。
模特分位素材按 PRD 第5节校验：正脸头肩、正面全身为必需，45°半身、侧脸为推荐；两必需位文件内容不能相同，其余位不作为AI质量验收。来源、人工确认、主参考按实际保存。配方记录拆为creationDescription、identityCreationPrompt、angleExpansionPrompt与executionRecord{modelParams,promptVersion}；缺字段显示“未保存／待接入”，不填演示值。文字复用创建新草稿，不复用旧身份资产；完整配方复制仅在全部真实字段存在时可用。缺历史数据展示空态。
功能调用及外部接入边界
下表是业务调用合同，不是已存在的生产 HTTP API 清单；现有真实接口路径、供应商字段、鉴权和错误码需要后端按接入环境核定，旧示例域名与 /api/visual/* 示例不能直接当已部署接口。
| 功能 | 输入／输出合同 | 调用位置和边界 |
|---|---|---|
| 商品查询 | Item ID/SKU → 商品事实、图片、逐条卖点 | ERP后端；无结果不编造商品 |
| 卖点整理 | 上述输入 → id+title列表 | 用户点击后后端装配唯一Prompt；失败保留列表 |
| 下一步预览 | 当前模板＋输入 → 本地槽位预览 | 无模型、无图片任务 |
| 套图生成 | 冻结批次 → 父任务及逐槽执行／结果 | 后端共用规划师输出完整Prompt并原样透传、模型调用；用户选择模型不被覆盖 |
| 普通编辑 | 父图＋参考＋范围＋原文 → 新执行／独立结果 | 图片编辑接口，不以纯文生图替代 |
| 模特商品图 | 直接合同输入 → 编译Prompt与有序图片 → 执行结果 | Java参考已有确定性编译器；模型输出参数独立传入 |
| 版本采用／恢复 | 指定图和版本 → 新引用／恢复版本 | 后端校验归属及权限，保留历史 |
| 导出 | 当前采用版本清单 → 导出任务／文件 | 幂等建立任务、记录排除项，完成后下载 |
密钥只由后端配置注入，不进入浏览器或交付文档。实际调用记录保留请求关联ID、模型、Prompt/Schema、输入快照、用量和失败原因；不凭HTTP成功就伪造图片成功。超时、限流不自动改模型或新增付费重试；真实传输协议、存储期、费用规则不在本产品文档臆定。
表格与数据展示契约
模板表显示名称、范围、结构、版本、启停；模特表显示身份缩略图、来源、状态；Prompt表按权限显示稳定key、版本、启用状态。工作管理任务ID、输入、成品分列，缩略图最多3张加N，详情完整。当前套图页无任务详情入口，不能误删共享任务详情。
状态与权限矩阵
| 状态 | 前端可操作 |
|---|---|
| 未选模板／必要数据不全 | 可编辑和选模板；下一步提示缺项 |
| 可预览 | 下一步刷新预览；不要求AI整理或确认 |
| 生成中 | 显示真实进度、冻结执行输入、防重；无终止 |
| 完成／部分完成 | 当前结果下载、单图编辑、用户主动新任务 |
| 编辑失败 | 保留父图与输入，不产生成功版本 |
| 模板／模特停用或无权 | 不供新任务选择，历史引用仍可按权限查看 |
| Prompt无权限 | 隐藏菜单与管理行为，不仅禁用按钮 |
完整状态值沿用PRD，不把“采用”“候选”“质量失败”混为执行状态。
交互与反馈
可处理错误就地展示并保留输入；普通查看／切换不重复确认。删除有数据影响、减少已编辑套数、停用或恢复版本按原交互确认。缺历史快照禁用继续且说明。生成与结果保持相同卡片布局，窄屏不能横向溢出或遮挡按钮。
文案
统一“下一步／生成／重新生成套图／AI 整理／正在使用／使用此版本／下载全部套图”。不显示“完整／待完善”模板标签，不使用“质量通过”描述图片返回成功。卖点只有内容，不出现“事实依据或图片表达重点”输入框。
视觉契约
沿用现有 ProLayout、间距、字体和组件基线；本轮不改已验收生成页排版。交付目录改为五个主入口、按需资料及收起历史，不改变业务原型布局。
来源追踪
条款迁移索引记录旧BF／AC／F去向；当前产品规则以PRD各功能章节为准，历史文件不参与运行时拼接。研发变更对照区分本次新增改动与此前已确认纠偏。
前端验收清单
见验收清单。需实际操作后记录结果；静态表中“覆盖”不能代替用户验收或真实后端验证。
待决策
主图外框新版和旧规划硬规则冲突见PRD末节；不扩成当前普通编辑约束。真实服务的字段／路由核验未完成时，不标“已接入”。
CR-20260922-019 提示词调用边界
本地AI整理请求仅为rawSellingPointText；模型响应selling_points:[{title}]，调用方分配ID后回填逐条列表。空结果、非法结果及过期响应不覆盖原文或列表。Planner接收冻结layoutSpec，不硬编码四种布局比例，不新增全局内缩或色温。模特直接合同保持1.0.2候选。
普通套图共用规划师按当前执行单元输出完整生图Prompt，后端原样透传；不实现旧总导演＋逐图＋固定编译链。保留输入／规划输出／实际请求三份记录。
作图规划师模型配置（CR-20260922-024）
作图规划师使用 Luna（模型标识 gpt-6-luna），推理强度为中（medium）。这是规划调用配置，不是图片生成模型；普通单图编辑与模特商品图的直接调用链不因此新增规划调用。gpt-5.6-luna 是 CR-024 的历史配置，2026-09-24 后不再作为当前配置；历史实验与执行记录保留原样。
后端在实际规划请求中设置并记录模型与推理强度；不得只把“中等推理”写入提示词代替请求配置。历史实验中的low、high、max记录保留原样，不作为当前默认值。本文同步用户指定的研发配置，不宣称生产服务已切换或历史验收使用了medium。
CR-20260922-024 · 规划师研发交付包
本次确认的规划师规则、完整正文、装配和输出合同统一以规划师研发交付为准；旧2.6概述不再作为运行正文。Luna/medium，每个槽位一次；五金字体专项仅五金非详情图加载。原型界面不变，生产服务未切换。16份装配对照。
CR-20260922-024 · 最新原型统一收口
本地来源粘贴原文后点击「AI 整理」，收起原文输入区并显示整理中反馈；有效结果回填统一逐条卖点列表。按钮变为「重新整理」，首次点击只展开保留的原文，不立即调用模型；修改后再次点击「AI 整理」才发起新请求。失败保留原文与已有列表，不产生有效回填；Listing／SKU／产品系统继续直载逐条列表。
身份创建已接入1.1.0候选的确定性装配，配方区分用户描述、完整Prompt与执行记录；未执行时明确标记，不伪造模型执行。规划师研发包1.0.0和已上线素材保留。
CR-20261009-045 · 线上原型画面要求示例（F-VIS-080）
用户确认基于当前线上部署 f54bced 增量修改，不采用独立候选页整体布局。仅在模特商品图现有画面要求输入框上方增加引导语及六个通用可编辑示例：突出商品、调整构图、简化背景、调整光线、统一配色、去掉画面文字。删除该输入框原说明，不提供撤销示例或清空要求按钮。空框直接填入；非空显示“追加，还是替换？”弹窗，完整新例句与已有原文摘要分层，两张选择卡直接追加或替换；暂不使用与关闭不改原文。追加换行，超过800字拒绝并保留原文。摘要不参与拼接，最终仍冻结description原文。保持线上商品来源、模特选择、参考、语言、文案、输出参数、开始生成与结果编辑流程，固定Prompt正文与Provider运行时未改，装配合同已同步。现有语言/文案与自由指令冲突仅记走查建议，本轮不改规则。