历史构建记录，仅追溯。

AI 视觉生产中心 · Build Notes

产品 PRD 版本：4.14 前端实施契约版本：4.14 来源变更：CR-20260921-014 迁移覆盖页面：P-WORK-MANAGEMENT-VISUAL-SUMMARY、P-VIS-WORKSHOP、P-VIS-MODEL-PRODUCT、P-VIS-TEMPLATE、P-VIS-MODEL、P-VIS-PROMPT

交付定位

• 01–07 专题均已取得 Freddy 已确认 证据，本轮由 00 总控统一消解术语、权限、状态、版本和上下游契约冲突。
• 在一期 AI 工作台的图片工坊、任务、单图生成与编辑能力上增量实现；一期其他页面保持只读，没有借本轮重构。
• 原 L2 套图 Demo 已升级为 React + TypeScript + antd 6 + ProComponents 正式本地原型，覆盖图片工坊、模板中心、AI 模特库和 Prompt 管理。
• 历史 Session 06 Golden 报告记录了当时范围的静态/联调结论；本轮无法复证其“100%”或生产就绪表述，且不能作为 4.13、直接模特候选或真实效果验收依据。

本次变更覆盖

CR-20260921-013 · 模特素材、槽位就近配置与卖点直载

本地原型新增按位置上传已有 AI 模特、浏览器内容去重、身份素材与生成配方展示/文字复用；不接入分类器、真实数据库、Planner、任务 API、模型或生产 Prompt。模板宽屏配置并列，窄屏按顺序；商品库卖点用明确的模拟结构逐条直载且可编辑，取消 AI 整理/确认和终止按钮。此处仅记录本地可验收原型，不代表上线、合并或用户验收。

CR-20260921-011 · 最终尺寸规则实施

用户已通过尺寸任务确认，覆盖旧候选。新增独立尺寸校验与快照值，双栏控件真实自定义、模型提交校验和Grok档位；不改变已确认双编排、Prompt、发布状态。验收见本次执行记录。

CR-20260921-010 · 总控授权接管双编排

接管仅修改template-composition树，不带fa1a模特代码。两组独立槽位编辑/增删复制排序布局、保存/重开、名称管理分组回写、稳定新模板ID与双组预览已补齐。旧slotConfigs作为橱窗旧数据读取；新数据两组独立保存，并以合并slotConfigs供现有生成消费者读取。生成槽位ID包含源槽位ID，避免同类型复制或跨组时版本串图。

同步补缺：所选模板冻结快照，应用时重新检查授权/启用状态；无模板显示空态。场景ID不再覆盖用户补充文字，选择场景图即可编辑；编辑版本记录父版本/操作/原文/场景/范围，不自动采用。初次生成不虚增v2。套图任务详情入口已不存在，旧AC-VIS-43已改为无详情入口，工作管理详情保留。

补充收尾：类型检查、构建、antd lint、prototype guard、change sync与差异空白检查通过。修复继承的宽屏最小列宽导致1440×900右侧溢出，改为顺序列表下接布局设置；layout-fixed.png复核无水平溢出。恢复v4为v6后重开确认橱窗9/详情0。上述均为本地模拟交互，不代表后台持久化或真实图片编辑。新尺寸来源已由总控更正为任务01a0c2ca-818a-7f60-801d-d9361fc2d165，等待其精确确认规则后继续实施，旧尺寸待确认判断不再作为最终结论。

浏览器已验证新建后橱窗10张、详情3张，详情顺序细节/场景/细节且场景左文右图，保存重开全部保持；截图outputs/template-composition-takeover。最终尺寸原文正在向原责任任务/总控核实，不擅改。真实后端、账号权限服务未接入；未发布。

补充验证：现有日常模板v4详情为空，新增1张详情保存v5、重开保留；历史面板恢复v4生成v6，v4/v5仍留存，未捏造未加载历史版本。模板复制已改为真实独立记录，不再仅弹成功消息。套图生成12张初始均v1；只选暖灰石台且不填文字可编辑，原文仍为空，图1生成v2记录父v1与换场景，其他11图仍v1；采用v2后可恢复v1。结果无任务详情按钮。尺寸证据总控确认缺失，四项新规则待对应任务与用户确认，当前不新增自动能力联动。

2026-09-20 原型验收候选（未同步正式 PRD）

• 参考图仍集中在 AI 编辑，但不再要求或展示用途下拉；上传列表保留缩略图与删除。
• 换场景提供八个仅描述背景方向的示例卡片；换风格提供预设卡片。两者均可继续用自定义文字或参考图补充，三个编辑入口共用范围与提交。
• 尺寸不再展示静态推荐或自动覆盖路径；当前未接入经核验的模型能力清单，原型仅继承模板默认值并明确提示，避免编造可用像素/比例组合。
• 模板可用范围按全局通用、平台通用和店铺专用三级筛选。本段是待用户验收的原型候选，不改变 CR-20260919-001 的正式 PRD/前端契约。

2026-09-20 规格选择候选（未同步正式 PRD）

• 套图沿用“模板/店铺 → 确认 → 预览”路径；每张预览卡片下方出现本次规格控件，模型下拉保持原位，并新增图片语言。模板仍定义槽位与版式。
• 单图页面沿用既有生成设置；比例和输出尺寸合并成双栏浮层，左侧选画幅、右侧选尺寸。六个指定模型和固定 20 项尺寸枚举均作为原型候选登记。
• 自定义尺寸只写入本次任务；目前以登记枚举校验，规格不合法时就地提示且不自动裁切、拉伸、替换。模型切换提示用户重新确认，原型不静默改规格。规格入口只在套图预览呈现后显示，不新增独立设置流程。
• 本段只供原型验收，未声称能力组合已接入真实运行时，也未更新正式 PRD。

2026-09-20 原型体验修订（未同步正式 PRD）

• 已移除模特商品图中未被业务流程消费的“输出质量”字段。
• 画面设置与模特姿势的简化方案已交由模特库专题整理，等待用户确认后再改动页面或正式 PRD。

• 产品层：统一 01–07 的对象、正逆向流程、状态、权限、异常、历史/迁移、验收与上下游契约。
• 页面层：P-VIS-WORKSHOP、P-VIS-MODEL-PRODUCT、P-VIS-TEMPLATE、P-VIS-MODEL、P-VIS-PROMPT。
• 功能层：F-VIS-001–117；F-VIS-003 按当前范围标记不适用，F-VIS-089/091 是后台契约且不新增普通用户结构。
• 实现层：正式 Pro 原型源码、构建产物、原型规格和构建说明。
• 知识层：AI 工作台模块长期规则；未覆盖的一期页面保持只读。

本轮实现

• CR-20260919-001：本轮只调整已确认的原型交互与模板编辑表达。产品 PRD、前端契约、原型规格和源码同步；不修改生产 Prompt、Planner、Provider 或业务模型。知识库影响：这些是当前原型的交互收敛，不形成可跨模块复用的新业务规则，因此不新增长期知识条目。

• CR-20260825-005 将图片工坊拆为三个明确动作：卖点整理结果“下一步”只确认卖点并切到“模板与店铺”；模板页底部“确认”按当前配置派生右侧未提交套图操作预览；预览右上角“生成”才冻结快照并创建任务。右侧预览使用真实槽位卡片，展示布局缩略图、卖点绑定、排序、复制和删除；店铺、模板、图片模型、套数或卖点变化会使旧预览失效并要求重新确认。
• CR-20260825-003 以图片类型而不是全局通用列表约束布局：效果对比默认左右 50/50，多角度默认主视图约 64% + 三个辅助角度约 36%，允许自由规划的类型可保存 planner-led。六张预览均为独立确定性 SVG，说明和快照读取同一 layoutSpecs，不再使用上一版带两侧白边的通用图。
• 图片工坊默认 1 套；蓝图卡删除“换此版式”，复制槽位和多套计划均继承模板布局。标准模特姿势由 4 种扩展到 8 种。
• 本地模型验证目录 prototype-local/model-product-pump-ab/ 保存 PlannerRequest、ImageVisualPlan、CompiledPromptSnapshot、最终 Prompt、两次模型响应和两张结果图。GPT Image 2 与 Seedream 均成功返回；逐处复核未发现足以支持 GPT Image 2 顶部提手/线缆被重构的差异，两者均较好保留商品身份，但两者均未满足“另一只手指向右侧出水接头”的姿势约束。商品身份与人物交互独立验收，生产运行时未切换。
• CR-20260825-002 将模板比例与模型成图验收分层：模板预览仍准确展示 80%、40/60、30/70；图片模型只需呈现正确的左右/上下关系、准确可读文字、无明显图文遮挡和与模板一致的整体观感，少量边界漂移不判失败。本次不改可见原型，候选作图规划规范升级为 v2.4-candidate，生产 Prompt 未切换。
• 带文字复测使用固定三行英文，对 gpt-image-2 与 doubao-seedream-5-0-pro-260628 各执行商品主视觉、左文右图、上文下图一次，共 6/6 成功且文字正确。Freddy 视觉确认两张上文下图观感均可接受；该单轮单品结果不代表跨品类、中文文字或稳定性放行。
• CR-20260825-001 将槽位选项改为“左侧定稿布局图、右侧文字说明”。三张预览从 1440×320 的确定性总图按三个 480×320 固定视区切出；总图源文件直接以 368/460、184/460 和 90/300 的几何值表达 80%、40/60、30/70。生成模型仅用于探索柔和紫蓝风格，不作为比例真值。产品 PRD v3.5 不变，因为本次没有修改槽位业务语义、对象、权限或验收比例。
• CR-20260824-005 将三种布局改为结构化比例：商品主视觉为居中 80% 主体区且不预留文字区；左文右图为 40% / 60%；上文下图为 30% / 70%。layoutSpecs 继续生成说明文案和保存快照，避免业务比例与模板版本各自维护。
• 真实布局验证使用同一潜水泵输入与同一布局参考，分别调用 gpt-image-2 和 doubao-seedream-5-0-pro-260628，每种布局分别计划 3 次独立调用，不自动重试。18 次计划取得 15 张成图、2 次网络失败、1 次悬挂超时；结果仅作为单一工具商品布局遵循证据，不替代跨品类 A/B 或生产 Prompt 切换评审。

• CR-20260824-004 将图片工坊左侧从三个一级页签收敛为“商品与要求 / 模板与店铺”；图片模型、套图数量和规模摘要均在第二页签完成，不再渲染独立“生成设置”。
• 店铺范围增加“不关联店铺（系统通用模板）”。该状态只展示完整、启用的系统通用模板，不要求店铺权限；店铺模板仍按有权范围过滤。
• 模板中心删除“配置边界”按钮及运营调整 Modal。模板编辑页改为槽位列表与布局详情同屏，当前槽位可在商品主视觉、左文右图、上文下图三种受控布局间单选，边界字段只读展示并继续进入模板版本快照。

• CR-20260821-002 将工作管理列表重排为任务 ID、本次输入和成品图片三列。任务 ID 作为主文本，成品图片独立高亮并显示已完成 N/M；详情抽屉补充任务 ID 和完整成品图片映射。图片工坊本次不新增业务规则，继续复用已冻结的输入、模型、套图预览、逐图结果、人工编辑和下载契约。
• CR-20260821-001 已同步 V2 三专题冻结口径：图片生成模型由用户选择，Provider 与 Planner 策略由服务端内部解析；套图批次确认后模型冻结。结果侧不建设 AI 视觉质量评分、后台质量门禁、自动质量修复或近重复自动重跑，保留生成前确定性校验、明确结果技术/规则检查和用户手动处理。
• 图片工坊移除基于抽象槽位签名的“重复规划”提交阻断，按用户确认数量创建执行；模特商品图移除“模特身份一致”等未经验证成功声明。两页均展示用户选择的图片模型和任务快照，普通页面不提供 Provider 或 plannerKey。
• CR-20260819-001 已进入正式 Pro 原型：工作管理以缩略图直接展示本次输入、完成数量和输出结果，多图收敛为“最多 3 张 +N”，详情抽屉展示完整映射；历史任务缺少输入/结果关联时明确提示“历史映射缺失”，不再从工作名称或 Prompt 猜测。
• 图片工坊与模特商品图继续使用同一商品输入母版。本地来源支持一次选择多张和拖拽追加，Listing/产品系统来源支持复选；已选素材以托盘展示，可删除、排序并标记主参考。输入素材上限、单图片类型生成数量 1–5、套图数量 1–5 分域处理，互不代替。
• 单图结果编辑器保留整图、点选局部、框选局部三种范围，并为自定义修改、换场景、换风格和重新生成统一提供可选参考图；选区与参考图共同进入编辑任务快照，Provider 不支持组合能力时应在创建任务前阻止。
• 商品资料、核心卖点、特殊要求和图片修改要求保留原页面内编辑，同时提供 960px 放大编辑 Modal；保存回填同一字段，不新增第二份业务事实。
• 第三方品牌视觉资产继续执行默认禁止：Apple、Windows、Chrome、Edge、Opera 等官方 Logo/图标只有命中授权白名单才允许生成；普通兼容关系只输出中性文字。
• PRD 包已在本次产品变化实施期间退回 draft；源码、构建产物、机械检查、真实交互和 1355×848 同视口截图通过后恢复 prototype-aligned，用户视觉确认仍单独登记。
• ENG-20260818-002 / ENG-20260819-001 / ENG-20260819-002 完善服务端开发契约：visual-planner-prompt-spec.md 升级为 v2.1-candidate，完整定义字段注册表、通用限制、平台政策、图片类型矩阵、三个规划策略 Prompt、结构化输出、单图多结果差异化指令、第三方品牌资产授权快照和确定性最终编译；prompt-example-shopee-rotary-hammer-suite.md 以 14 个执行单元演示可生成、缺事实阻断、待人工核对和逐图编译。CR-20260819-001 的可见交互变化已同步产品 PRD、前端契约、正式原型源码和构建产物，真实交互与同视口视觉验收仍待补。
• 作图规划服务仍属于服务端候选契约；本轮原型没有伪造真实规划模型、计划快照或 A/B 结果。开发接入后仍须在 Prompt 管理和任务审计数据中补充真实追踪证据。
• Prompt 管理尚未呈现三个真实 planner_key 的 Schema、测试、使用追踪和回退证据；该管理能力和真实 A/B 未完成前，不切换生产有效 Prompt 版本，也不发布正式交付包。
• 导航归并为“视觉生产”：图片工坊、模板中心、AI 模特库、Prompt 管理；当前版本不提供参考图解析入口，任务仍由工作管理承接。
• 图片工坊闭环覆盖一期三来源商品/图片选择、店铺/已授权模板、蓝图编排、确认后直达父子任务、逐图揭示、终止未完成生成、单图参考素材、版本切换、确定性结果检查和显式交付；当前版本不提供参考图解析入口。
• 模板中心覆盖查询、新建、复制、独立编辑、有序槽位、预览、版本恢复、启停和按模板版本汇总的任务满意度。
• AI 模特库覆盖共享模特发现、成人模特创建/上传、推荐语、权限和启用/停用/归档的历史影响。
• Prompt 管理覆盖四类稳定 prompt_key、组合预览、Schema/模型适配、测试、不可变版本、恢复、在用保护和兜底。
• 可见实现由 data-requirement-id 追踪 F-VIS-001–111（F-VIS-003 当前范围不适用）；CR-20260825-003 新增图片类型感知布局、默认一套、运营布局只读和八种姿势。当前布局使用六张独立确定性 SVG，不复用、翻转或旋转同一图片近似表达。

CR-20260814-002 增量实现

• 卖点区将“确认整理结果并生成蓝图”改为“确认卖点并生成套图预览”；右侧成果标题统一为“套图预览”，说明需要检查图片类型、数量和卖点图。
• 固定底部生成主操作改为“确认套图预览并生成图片”，与前一步形成明确阶段差异；不新增重复只读确认页。
• 已确认卖点的删除事件以稳定卖点 ID 同步过滤所有套图中的对应核心卖点图，保留其他槽位、排序、版式和人工调整，也不重新调用 AI。
• 被删除预览槽位的未提交版本状态同时清理；若当前选中项被删，自动回落到当前套第一张图。模板要求卖点图且卖点被删空时，保留其他预览但阻止生成并提示补充卖点。

CR-20260814-001 增量实现

• 图片工坊与模特商品图的三个商品图片来源入口分别打开来源专属 Modal；本地上传弹层不再重复显示 Listing/产品系统来源，Listing 与产品系统查询同理。
• 核心卖点原文继续由用户输入且不设业务条数上限；彩色菱形“AI 整理”显式触发，整理结果在原输入框下方可增删改并确认，原文用 Collapse 折叠保留。确认前不派生蓝图，修改原文后确认状态失效。
• 图片工坊把主操作改为“下载全部套图（N 套·M 张）”，统计当前任务全部已生成且允许下载的套图和图片；部分完成时说明排除范围。
• 模特商品图左侧拆成“商品信息 / 画面设置 / 模特姿势”三个一级分组；画面描述含姿势时只提示采用到姿势或保留当前姿势，不自动覆盖姿势，也不删除原文。
• AI 模特创建增加选填身份参考多图、主参考和 AI/真人来源；参考范围仅限人物身份特征，真人参考未勾选肖像授权时阻止进入候选生成。

CR-20260813-005 增量实现

• 模特商品图外层页签由三组减为“商品信息 / 画面与姿势”两组；删除独立“生成设置”页签，不改变生成字段、任务快照或服务端校验语义。
• 第一组按统一商品入口、AI 模特、生成设置的用户决策顺序连续排列，数量、比例、语言、文案与质量仍在创建任务前可编辑。
• 页签切换继续使用不销毁隐藏面板的受控状态；右侧空态、蓝图、渐进结果、完成图、当前选中图与版本均不因左侧切换而改变。

CR-20260813-004 增量实现

• 左侧来源切换收敛为小尺寸图片入口，点击“从本地上传 / 从 Listing 选择 / 从产品系统选择”后打开统一来源 Modal；商品资料、核心卖点和特殊要求仍在左侧连续编辑。
• 移除前台商品名称字段与生成门禁；Listing/SKU 的来源名称只进入后台快照，本地上传以图片、资料和原始核心卖点构成本次商品输入。
• 核心卖点不再走逐条提取、编辑、确认和槽位绑定。用户直接输入原始内容，AI 自动总结为图片方向；模板含核心卖点图时每个摘要独立生成一张，摘要失败保留原始输入降级执行。
• 套图数量 1–5 在商品空态也可编辑；减少已调整方案仍要求确认。模板切换、数量变化和卖点重新总结均按当前模板版本重新派生蓝图。
• 模板中心采用九类稳定图片目录；商品主图可配置白底/模板背景和无外框/细线外框/阴影卡片；蓝图及结果分组只读取已选模板的 slotRoles 顺序。

CR-20260813-003 增量实现

• 图片工坊与模特商品图共用固定双栏和同一个商品输入组件：三来源、商品名称、商品资料、本次特殊要求、应用动作的顺序与反馈一致；右侧成果区不随左侧分组切换消失。
• 图片工坊商品选择、商品资料维护和卖点校对全部移入左侧；不再使用商品选择、商品编辑或卖点校对大弹层。卖点池不设固定业务数量上限，模板仅消费绑定到卖点槽位的条目。
• 套图运营侧输出设置只保留套图数量。图片比例、文案区、语言和图片类型来自具体模板槽位，并进入批次/槽位快照。
• 套图生成完成后按图片类型分区展示，同类型复制图片进入同一分区；结果卡移除目的说明和“模板必需”，卖点图只显示实际对应卖点。
• 单图编辑器移除“商品真实性”等无操作价值的标签/成功文案；后台商品约束、任务快照和真实阻断不变。

CR-20260813-002 增量实现

• 模特商品图由全页 Steps 改为结果优先固定双栏：左侧约 30%–38% 集中设置，右侧成果画布占主要空间；仅小于 760px 时上下堆叠。
• 左侧设置按商品与要求、画面与姿势、生成设置分组，内容独立滚动，唯一“开始生成 / 重新生成”在底部固定可见。
• 右侧画布不随设置切换消失，连续表达未选商品、蓝图预览、渐进生成和完成结果；生成行为不再导航至另一页面。
• 完成态优先展示图片：单结果不显示冗余缩略条；多结果保留切换缩略条；身份一致性、商品关系和当前版本收敛为轻量底栏。
• 真实交互验收覆盖 Listing 商品带入、直接生成、渐进揭示、完成结果、左侧分组切换后结果保持、单图编辑入口；1280×720 同视口无横向溢出。

CR-20260811-001 增量实现

• 左侧输出设置只保留“生成套图数量”1–5；右侧按数量建立套图 Tab，每套从同一模板版本派生独立稳定槽位。
• 单套槽位支持拖拽、前后移动、换版式、复制一张和删除运营新增槽位；基础槽位、最大张数和固定顺序由模板边界控制。
• 模板中心可配置槽位是否必需、单套最大数量和是否允许移动；保存仍形成不可变新版本。
• 提交前显示全批次差异化规划状态，结果阶段显示完全/视觉/语义重复门禁；具体阈值与重试次数仍留给真实模型评测。
• 任务详情按“生成批次 → 套图父任务 → 图片子执行”分层；五套方案完成后进入统一结果与显式交付。
• 修正模板选择交互：店铺变化不自动替用户选择；Modal 采用“选中待应用 → 应用模板”的提交方式。

CR-20260811-002 增量实现

• 运营侧取消无业务语义的通用“新增槽位”。模板管理端改为从稳定图片类型目录添加未包含类型；同一类型需要多张时，由模板的单套最大数量和套图内“复制一张”共同约束。
• 当前演示模板初始蓝图补齐白底主图和尺寸规格图，共七个图片类型；是否必需、顺序和最大数量仍由模板配置，不把演示结构写成跨平台硬规则。
• 左侧新增商品名称、商品资料、商品图片和“提取商品信息”，提取后展示可确认的商品卖点；修改资料会使事实快照失效，确认前不能创建生成批次。
• 核心卖点图展示并绑定具体商品卖点；复制卖点图默认分配同套内尚未使用的卖点，卖点不足时就地阻止，不生成语义重复卖点图。
• 运营界面移除“按需查看本图执行说明”、Prompt/内部执行链路和无冲突时的重复检查成功信息；只在出现真实冲突时展示可操作异常。
• 生成结果的卖点图明确展示“对应卖点”，便于运营核对图片表达与商品信息是否一致。

CR-20260811-003 增量实现

• 主商品卡改为已选商品摘要，“更换商品与图片”打开与一期一致的本地上传、Listing 图片、产品系统图片三来源 Modal；Item ID/SKU 查询后带出商品信息、图片与卖点，本地上传时在同一页补录商品资料。
• 移除孤立“补充商品图”按钮，以及当前版本的“参考图解析与模板重建”入口/Drawer；单图编辑中的本次参考素材 Tab 保持不变。
• 套图数量改为标准 Form.Item + InputNumber，显示“套”单位和说明；不再使用自造灰底组合字段。
• 修复拖拽落点：前→后插入目标之后，后→前插入目标之前；固定首图、稳定槽位 ID 和仅影响当前套图的边界不变，前后移动按钮继续作为可访问替代。
• 删除重复只读蓝图阶段；当时的唯一蓝图提交动作直接冻结快照、创建批次并进入生成中；CR-20260814-002 将其业务文案进一步明确为“确认套图预览并生成图片”。
• 生成页在套图 Tabs 内逐槽位显示已完成、生成中和排队中；子执行完成一张即展示一张。原型模拟任务事件，未把所有 Provider 支持像素级预览帧写成事实。

CR-20260811-004 增量实现

• 已选商品摘要并列“编辑商品信息”和“更换商品与图片”：前者打开预填 Modal，保留当前来源与商品图片；后者继续进入一期三来源选择，两个动作不再混用。
• 商品信息 Modal 可修正商品名称、可验证资料和可确认卖点；保存时模拟重新提取，按钮显示 loading，成功后形成新的本次商品输入快照，历史批次不回写。
• 单图编辑 Drawer 扩展为 66% 视口宽度，左侧固定目标图、当前/最新版本、对应卖点和锁定项，右侧承载 AI 编辑、裁剪与文字、参考素材和版本记录，避免大图挤压操作区。
• AI 编辑复用一期能力：自定义修改、换场景、换风格、重新生成。运营只填写业务化修改要求；完整执行 Prompt、Provider/模型参数及锁定指令继续隐藏。
• 换场景默认保留商品结构、比例、颜色、材质、Logo 和核心细节；换风格复用一期风格枚举；重新生成沿用当前商品、店铺、模板和槽位约束。
• 四类 AI 操作、参考素材编辑和裁剪/文字保存成功均追加新版本，不自动切换当前版本；版本记录继续支持显式“设为当前”。

CR-20260811-005 增量实现

• 图片工坊首次进入改为真实商品空态；模板、套图数量和蓝图在商品卖点确认前保持不可操作，取消预置商品冒充用户选择结果。
• 商品来源只带出图片、名称和可验证资料；AI 进入分析态后输出带事实依据的核心卖点，用户可在独立 Modal 中修改标题/依据、删除错误项和补充遗漏项，再确认进入蓝图。
• 每套蓝图增加确认卖点池摘要。卖点多于模板卖点图槽位时，剩余项标记“未用于本套图”；可替换当前绑定或在模板上限内复制卖点图，卖点修改后自动重整失效绑定。
• 单图编辑中的换场景、换风格均增加本次参考图；“裁剪与文字”改为“画布与文案”，明确其用于平台比例、构图裁切和结构化文案，栅格文字重绘仍走 AI 编辑。
• 结果检查并列输入商品原图和生成结果，并固定同尺寸预览；页面只保留一个任务详情入口与“下载当前套图”，删除“交付当前结果”和当前页面 Listing 动作。
• 图片版本按钮改为“正在使用 / 使用此版本”，说明仅决定下载采用的版本，底层不可变版本与当前引用语义不变。
• AI 模特列表和详情改用真实成人 AI 合成模特演示资产；创建流程重构为定义身份/上传 → 选择身份候选 → 多视角一致性确认 → 推荐语保存启用三步，不新增性别、体型或市场筛选。

CR-20260811-006 增量实现

• 模板选择 Modal 不再用固定高度 Button 承载多行内容，改为纵向 Radio.Group。每个模板由内容撑开完整行高，结构缩略图、名称、来源、作用域和版本互不覆盖；选中后仍需点击“应用模板”。
• 单图 AI 编辑增加“整张图片 / 点选局部 / 框选局部”。点选和框选使左侧目标图进入十字标记模式，未标记时禁用生成动作，切换范围会清空旧选区。
• 原型只展示业务化编辑范围、参考图和修改要求；GPT Image 2 / Seedream 5.0 Pro 的路由、坐标/Mask 转换和请求参数留在能力适配层，并记录实际调用快照。
• 图片编辑按钮使用真实 loading。Provider 支持渐进预览时可逐步揭示，不支持时等待最终结果；预览帧不形成版本，失败不改当前版本并保留输入；用户重新生成创建新任务。

CR-20260812-001 增量实现

• 在“视觉生产”下新增“模特商品图”，不新增顶层业务域。页面使用商品与模特、画面方案、生成设置、生成与结果四步结构。
• 商品输入支持 1–5 张同一商品/同一 SKU 变体图；共享 AI 模特仅列启用项，生成快照锁定人物身份和商品真实性。
• 画面方案和姿势方案拆为两层：画面可选已授权模板、自由描述或画面参考图；姿势可选标准姿势库、姿势参考图或自定义描述。
• 标准姿势卡用真实人物缩略图与自然语言说明，并展示景别、朝向、商品关系和另一只手动作；切换姿势即时更新蓝图摘要。
• 画面参考与姿势参考各自上传、解析和校验；只复用结构关系，不复用参考人物、服装、商品、Logo、原文案或受保护视觉元素。
• 一次生成 1–5 张并逐张揭示；结果可下载、复用一期单图编辑或返回套图“模特商品展示图”槽位，不提供 Listing 发布。

CR-20260812-002 增量实现

• 点选局部改为在目标图直接点击创建可见锚点；再次点击替换位置，页面同步显示“已点选”状态，未点选前不能创建编辑任务。
• 框选局部改为真实 Pointer 拖拽：按下开始、移动实时更新区域、松开确认。过小区域清空并提示重新框选，不再用一次点击自动生成固定方框。
• 移除生成结果编辑 Drawer 的“画布与文案”Tab；一级仅保留 AI 编辑、参考素材和版本记录，避免把生成规格与后置图片编辑混为一体。
• 图片工坊生成前的输出设置增加图片比例与可选文案要求；模特商品图生成设置同步增加文案要求，比例/文案进入生成快照。

CR-20260813-001 增量实现

• 模特商品图首步不再另造上传表单，复用图片工坊“选择商品与图片”空态与本地上传、Listing 图片、产品系统图片三来源 Modal；应用后展示商品摘要、编辑/更换入口和本次特殊要求。
• 主流程由四步收敛为商品输入 → 画面、模特与生成设置 → 生成结果。数量、比例、语言、文案和质量与模块方案同屏，唯一主操作直接创建图片子任务。
• 自由画面描述只负责主题、背景、留白和布局。检测到姿势语句时，必须由用户“采用为姿势”或“从画面描述移除”；未消解前主操作禁用。
• 画面参考图解析结果回填为可编辑结构描述；识别出的姿势单列为待确认草稿，不覆盖当前标准/自定义姿势。
• 生成过程按图片子任务逐张揭示；结果页固定卡片尺寸，并排对比输入商品原图和生成结果。单图编辑复用自定义修改、换场景、换风格、重新生成、整图/点选/框选、参考素材和版本记录。

总控冲突决议

• “候选/采用”不再作为图片业务状态；每个成功结果直接形成不可变版本，用户通过“使用此版本”切换下载引用，采用版本标记为“正在使用”。
• “候选数量”统一解释为本次计划生成的结果版本数，不改变套图槽位数和顺序。
• 任务结果保留在任务和版本体系，不自动进入独立图片资产中心，也不显示虚假的“保存到图片资产”成功。
• 普通运营只查看业务输入、可调项、结果、卖点对应关系和需处理异常；Prompt、业务执行说明、完整系统指令、内部成功门禁和 Provider 参数不可见、不可编辑。

规格同步

• 产品 PRD、前端实施契约、PRD 包、原型和模块知识库已同步至 CR-20260819-001 / ENG-20260819-002；本轮新增 F-VIS-092–097。
• CR-20260814-002 明确卖点提炼、套图预览和图片生成三阶段，并新增已确认卖点删除后按稳定 ID 即时联动所有未提交预览。新增 F-VIS-082–083，五个覆盖页面与既有能力继续保留。
• Seedream 5.0 Pro 的生产模型 ID、局部编辑参数、参考图上限与渐进预览能力，以及两类 Provider 的质量/成本优先级、并发与错误码仍待真实环境验证，不写成前端固定事实。

检查结果

CR-20260817-005 定向检查补充：Prompt 静态基线覆盖 12 个平台/站点，Shopee 商品主图不再包含 Amazon/默认纯白指令；目标用户只进入卖点、对比、使用场景与氛围等相关图片，主图、尺寸和参数图保持隔离。PRD ready、Pro check/build、antd lint、prototype guard、change sync 与 project check 已通过。Chrome 同视口真实点击因本机尚未批准 Remote Debugging 而待补，不将机械检查替代为视觉验收。历史模块按规则不追溯新增 delivery-publication.json，delivery:check 因缺少该声明不适用；本地 staging 资源检查通过且未发布。

CR-20260817-006 质量审计补充：CR-20260817-005 对“目标用户不进入主图”的处理与一期真源冲突，已由本变更覆盖。当前主图恢复核心卖点、目标用户与特殊要求；特写图保留核心卖点但不带目标用户；尺寸/参数图继续隔离营销字段。槽位仅表示二期执行单元，不是一期单图能力限制。当前方案只标记为开发前候选，真实图片生产放行仍需平台来源、跨类目样本、模型对照和复杂空间关系门禁。

知识库影响

• CR-20260825-002 已更新 knowledge-vault/modules/ai-workspace.md：模板说明、预览和版本快照继续读取同一结构化比例；模型 Prompt 将比例表达为目标视觉关系，带文字成图按方向、可读性、无明显遮挡和整体观感验收，不做像素级卡线。
• CR-20260824-003 是现有套图总导演跨品类边界的显式化与 Golden Case 纠偏，不新增长期业务对象或运营交互；权威规则已进入产品 PRD 与 Prompt 契约，本次不改原型或知识库。
• CR-20260821-003 只调整现有菜单信息架构和已有任务快照的继续入口，不新增业务对象、状态、Prompt 或长期生产规则，因此不修改知识库。
• CR-20260821-002 只调整已确认视觉任务信息的页面优先级与呈现结构，不新增跨模块业务对象、状态或长期 Prompt 规则，因此本次不修改知识库。
• 已更新 knowledge-vault/modules/ai-workspace.md，记录 01–07 确认后的视觉生产长期规则、术语、权限和历史边界。
• 已追加商品输入快照、图片类型目录、卖点绑定与前台信息暴露边界；相似度阈值、重试次数和商品解析准确率仍标为待真实验证。
• 已追加双图片编辑引擎的后台路由、调用快照、局部选区和版本边界；本轮已核对具体模型的布局小样，但局部编辑、参考图上限、渐进预览、跨品类稳定性和生产容量仍待真实环境验证。
• 已追加模特商品图、画面/姿势分层、标准姿势结构和参考图合规复用边界；不建设模特身份一致性 AI 阈值或结果硬门禁。
• 已追加三来源单层直达、前台无商品名称、原始卖点显式 AI 整理和人工确认、一卖点一图及完整模板版本跨页面同源规则；旧自动只读摘要与弹层重复来源仅作为历史说明保留。
• 已追加任务级全部套图下载范围、画面/姿势独立分组与冲突消解、AI 模特身份参考图的允许特征及真人肖像授权门禁。

交付边界

2026-09-20 场景与风格参考接入（待原型验收）

• 图片编辑中的“换场景”改为参考图库选择：以当前父图为基础替换背景，不重新规划或生成整套图片。
• 图片编辑中的“换风格”只接入用户确认的六张风格参考图：极简棚拍、酷炫科技风、自然生活、高端质感、清晰卖点、柔和治愈。
• 选区时仅把范围附加到本次图片编辑；用户的补充文字原样追加，不进入 AI 整理流程。
• 场景素材已补齐为 58 项，新增窗边梳妆台、木工工作台和林间营地的原始认可图片；未重画素材。
• 场景与风格选择改为“当前选择摘要 + 参考图弹窗”：编辑面板不再压缩展示全部卡片，弹窗中以完整图片卡片浏览并选择。

CR-20260920-002 变更覆盖

本变更已由用户完成原型走查；没有新增长期知识对象或术语，故不改知识库。

2026-09-20 单图编辑工具收敛

• 已移除单图编辑面板中的“重新生成”；AI 编辑仅保留自定义修改、换场景和换风格。
• 结果/历史任务层的“重新生成（新任务）”保持原有独立任务语义，不属于单图编辑工具组。

• 本期产品、前端、Prompt 工程、规划契约、原型与验收材料允许发布给开发和测试；公开交付目录由 delivery-publication.json 生成。
• 不接真实模型、接口、数据库或生产权限系统；交互数据为契约验证数据。
• 作图规划策略仍为 candidate；真实 A/B 与管理追踪完成前不切换生产有效 Prompt。

CR-20260921-003 · 总控整合

复制02 v4.6源码和资源，不覆盖原工作区；PRD/契约4.8统一已确认编辑规则。包暂为draft，待整合检查与视觉验收证据。未发布、未改生产运行时。

整合核验与本次发布授权

2026-09-21：用户明确要求更新现有线上地址，并授权提交、合并和发布。原型源码/构建复用02已检查版本，总控类型检查、Prompt来源检查、差异检查、原型守卫通过；浏览器实际打开1710×813首屏并点击模板选择，核验初始未选模板与三范围列表。其他既有交互检查沿用02记录，本轮未重新宣称完整浏览器回归。PRD已统一三编辑入口、整图/框选、参考上传及生成后规划语义。将包标记prototype-aligned表示本次文档/交互原型对齐，不代表用户整页视觉验收或真实后端已完成，后续体验反馈继续登记。

仓库无远端；用户表示不了解远端并明确要求更新既有Cloudflare地址。本次不配置虚假远端、不宣称远端同步。沿既有发布脚本的无origin警告路径执行本机main发布；原主工作区保留到独立分支，所有未提交内容保留。模特新版与待定外框方案不纳入。

CR-20260921-010/011 本地验收与交接证据（2026-09-21）

• 模板A（验收样例）v1=橱窗10/详情3，删除一张详情保存v2=10/2；从v1恢复为v3，重开=10/3，顺序与布局保持。模板B（日常）v4=9/0，加一张详情保存v5=9/1，从v4恢复为v6=9/0。两个测试对象不可混为一次恢复。截图restored-three-details.png与template-history.png。
• 套图页面：自定义1232×1040（不属于20预设）可应用，比例派生77:65，其他11槽位保持1024×1024；1233×1040校验失败保留原输入，显示16倍数原因。Seedream Lite下1024×1024逐槽显示像素下限错误，点击生成仍留预览。Grok切换保留原像素值提示手动调整；第一槽位手选16:9+2K，仅该槽位改变，其他11个值未替换，浮层无自定义入口。
• 图像编辑实测：场景参考ID与补充文字独立；只选参考可提交，用户文本保持空；首图v2记录父v1/换场景，其他11图仍v1，可采用v2再恢复v1。套图无任务详情入口。
• 证据目录：outputs/template-composition-takeover。浏览器通过Browser Harness真实点击/输入；为避免后台页动画冻结，测试页启用CDP焦点模拟。测试无真实图片调用。截图为操作证据，不代表真实生成质量。
• 尺寸确认更新：用户已明确 GPT-Image-2 与 Sunburst/Flare 使用同一组限制：16倍数、1:3~3:1、单边≤3840、总像素655360~8294400（含边界）；超过2560×1440仅作实验性提示。失败保留输入说明原因，不自动改值。Seedream与Grok规则不变。
• 本地类型检查、构建、antd lint、prototype guard通过；output-size.test.mjs通过（20项与13/14有效集、边界、预设外自定义、档位、真实比例、旧快照不变）。构建现有大包体提醒保留，不影响成功。change sync与阅读版一致性检查结果另见最后收尾。
• 边界：模板/版本仍为本地内存模拟；后端持久化、真实权限校验、实际生成回执、GPT-Image-2路由限制均未完成，不宣称真实任务历史持久保存。无Prompt改动，无付费调用，无合并/推送/发布。

收尾状态：change:sync已通过；首次delivery:check因包仍为ready-for-prototype（未生成目录）失败。当前源/契约/本次覆盖已对齐，按工作流提升prototype-aligned供走查，未标review-passed；重新生成本地阅读版并执行一致性检查。单图现页同一控件已点击验证1232×1040真实自定义，未新增设置页面。 产品 PRD 版本：4.12 前端实施契约版本：4.12 来源变更：CR-20260921-012

CR-20260921-012 · 已验收模特商品图定向整合

• 合并 008/v4.9 的已验收交互，不覆盖当前模板、图片工坊或 009 候选内容：四入口、换模特整图限定、按图片独立版本和按当前采用版本下载。
• 本地 model-product-state.ts 只冻结请求形态并引用 model-product-direct-v1-candidate@1.0.2-candidate；不复制 Prompt 正文、不接入真实 Planner、任务 API 或图片模型，也不宣称已切生产。
• GPT-Image-2、Sunburst 与 Flare 的 655360–8294400 总像素规则（含边界）由独立校验覆盖；超过 2560×1440 为提示性实验声明，不是额外阻断阈值。
• 008 的用户布局与交互验收已记录；本次跨树接入仍需在最终整合版本执行浏览器走查。009素材帮助与“正脸/全身必需”等未确认建议没有写入。

CR-20260921-014 · 总控一致性修正

新02于2026-09-21明确停写后，总控独占完成剩余交付清理。用户已接受CR-013布局。新02修复语言受控与scopes映射，总控补canonical四文件、原映射到真实编译器的联测及当前研发手册。业务Prompt正文保持源候选原样，不切生产。原型真实DB/API和独立输出图片仍未接入，候选真实效果未验证。旧Golden声明不可作为当前通过证据。主图外框新版待定。

CR-014本地验证：canonical四文件与源候选逐字一致；原20项装配+19项实际映射联测39/39通过；尺寸合同测试、类型检查/构建、antd lint（0问题）、prototype guard（0错误0警告）、prd:ready、change:sync、prompt治理通过。浏览器本轮因Chrome调试授权未完成，沿用用户对CR-013布局验收；本次无布局变更，语言/范围映射由真实装配测试验证，不假称新增截图验收。

线上浏览器复核已连接，正式域名PRD4.14与原型891a388已确认。另发现套图空态仍写“确认卖点”，已改为“完善商品资料后点击下一步”，预览标签改“本次卖点”；仅文案，不改变流程。