历史快照：v4.14，基线63a6532。仅追溯，不作为当前研发要求；现行规格见交付首页。

AI 视觉生产中心前端实施契约

产品 PRD 版本：4.14 前端实施契约版本：4.14 来源变更：CR-20260921-014 确认依据：严格同步 V2-01、V2-02、V2-03 与 Session 00~06 冻结结论。彻底消除陈旧“AI 质检门禁阻断”与“AI 评分不合格禁止下载”，近重复仅作非阻断式浮层气泡提示；用户在确认生成前选择一次图片生成模型并固化快照；普通界面严禁暴露 plannerKey 或 Provider 调度细节；现行页面以本次已验收原型与覆盖清单为准；三层规划工作台与旧API示例仅作历史参考，不作为已实现能力。 迁移模式：incremental 覆盖页面：P-VIS-WORKSHOP 图片工坊、P-VIS-MODEL-PRODUCT 模特商品图、P-VIS-TEMPLATE 模板中心、P-VIS-MODEL AI 模特库、P-VIS-PROMPT Prompt 管理

CR-20260921-014 · 研发交付一致性修正

用户已确认CR-013原型。当前版本清除已被替代的卖点AI整理、套图终止、模特Planner与旧三分组要求；补齐model-product-direct候选编译器及原型映射联测，修正参考scopes与语言透传。普通编辑三入口、模特四入口，换模特仅整图。未变更已验收布局，未切生产或宣称真实接口已完成。

研发入口：[当前对照清单](docs/current-development-alignment.md)；旧开发手册已归档，当前开发手册按三条调用链路组织。外框新方案仍待确认，不随本次修正改变。

CR-20260921-013 · F-ML-013 / F-WKS-013 / F-TPL-013

ModelPage 以位置键保存上传文件列表；必需 face/full 至少各一张、浏览器以 SHA-256 比较文件内容去重，threeQuarter/profile 为非阻断推荐位，extra 最多两张。原型不调用分类器。保存后的 identityMaterials 明确来源；recipe 只含可呈现的创建文字、角度、参数、版本和人工确认状态。配方复用只预填文字表单。

TemplatePage 的 .template-structure-editor 在 ≥1120px 为槽位列表/当前配置并列网格，小屏降为顺序单列。WorkshopPage 使用 directSellingPoints：结构化模拟商品库卖点直入 SellingPoint[]，不触发 onOrganize 或确认状态。生成态只显示禁用按钮以防重复；本地计时模拟不对应 Planner、任务 API 或生产后端。

CR-20260921-012 · F-MP-011 / AC-MP-012

ModelProductPage 接收共享模特库状态；结果版本以 model-product:<图片索引> 隔离，下载动作显式传入图索引并读取该图 current。编辑快照通过 model-product-state.ts 固定父版本、编辑范围、框选、参考图和目标模特身份；仅换模特强制 scope=whole / selection=null。候选引用为 model-product-direct-v1-candidate@1.0.2-candidate，浏览器不持有固定 Prompt 正文，也不发出网络生成请求。

范围控件在换模特时禁用并清空选区；自定义、场景、风格仍可框选。版本列表保留“使用此版本”和“恢复”，恢复生成新版本；卡片下载不打开编辑器。009 帮助内容和上传规则未随本节接入。

CR-20260921-011 · 尺寸与比例最终确认

已确认来源：尺寸任务 01a0c2ca-818a-7f60-801d-d9361fc2d165 的用户确认及完整回传；总控指定当前任务唯一实施。本节覆盖旧尺寸候选中自动能力联动、预设重选式自定义及独立槽位比例字段。

• 沿用模型下拉和一个两栏级联规格控件，左栏比例、右栏尺寸；不新增页面。套图按选模板→商品与设置→左侧下一步预览→右侧生成，每张预览图下设置本次 outputSize；比例从精确宽高派生，不额外保存槽位比例。不按平台/槽位推荐、过滤、锁定尺寸，也不自动隐藏、禁用或替换已选尺寸。
• 六模型保留 GPT-Image-2、Seedream-5.0-lite、Seedream-5.0-pro、GPT-Image-2.5-Sunburst、GPT-Image-2.5-Flare、grok-imagine-image-2.0。套图语言沿用 English/中文/无文字，不扩充枚举。
• 真实自定义允许预设以外的正整数宽×高，仅写本次执行快照；失败保留输入并就地说明原因。提交生成前再次按当前模型校验，不自动裁切、拉伸、补齐、四舍五入或改写。模型切换不重置槽位配置。Grok 用同一控件的比例+1K/2K档位，不开放像素自定义、不承诺精确像素；其 outputSize 为比例/档位联合值，不能伪造宽高。

固定20项资产（原样保留，不以模型自动删减）：1024x1024、1600x1600、2048x2048、2880x2880、2240x1680、3200x2400、1680x2240、2400x3200、2400x1600、3360x2240、1600x2400、2240x3360、2560x1440、3840x2160、1440x2560、2160x3840、1680x1040、1920x640、1952x800、1280x720。特殊横幅真实比例分别21:13、3:1、61:25，其余按宽高最大公约数计算。

能力证据：OpenAI官方、火山方舟官方、xAI官方。本轮按来源任务交接的确认阈值实现本地校验，未调用模型验证；精确证据复核记录见构建说明。Seedream同时提供互斥的档位模式（Pro 1K/1.5K/2K、Lite 2K/3K/4K），当前20项及自定义界面使用精确像素模式，不将档位推算为像素。

AC-SIZE-011：预设外合法尺寸可应用；非法/小数/空值保留输入显示具体原因；切模型不改尺寸且提交重新校验；特殊横幅比例真实；Grok无宽高输入且仅比例档位；单槽位修改不影响其他槽位/模板，语言与规格冻结本次执行；不得新增模型调用。

CR-20260921-004 · 模板入口与预览

• P-VIS-WORKSHOP 首步不渲染店铺范围 Select，仅通过“选择模板”按钮打开 Modal。弹窗列表展示模板适用范围、有序槽位及布局示例；模板详情中的套图顺序使用抽象槽位示例图，不能复用商品样式图。

CR-20260921-003 · 已确认单图编辑规则整合

• 单张编辑只保留自定义修改、换场景、换风格；范围仅整张图片/框选局部。参考上传归入AI编辑，不要求用户另填用途分类；版本记录保留。
• 图1为当前父版本、图2为所选参考原图，调用图片编辑接口；Java按固定规则拼接，不调用前置AI、Planner或整套重生成。
• 预设换场景：将图1的背景换成图2所示场景，保持图1的商品和文字内容不变。
• 预设换风格：参考图2的视觉风格修改图1，可调整字体样式和排版，保持图1的商品和文字内容不变。
• 用户补充原样追加；无参考图的自定义场景直接使用用户原话。选区只追加必要范围说明；商品快照留服务端，不传locked_context。不支持组合时提示，不静默换模型或丢输入。
• 六风格同父图样本及已有换场景样本获得用户认可；不代表跨品类/跨模型稳定通过，不承诺未经验证的框外像素不变。当前产品原型为模拟，真实编辑后端尚未接入。

CR-20260919-001 · 图片编辑与模板布局收敛

跨模块覆盖：P-WORK-MANAGEMENT-VISUAL-SUMMARY 工作管理视觉任务摘要（补充任务单元格、输入/结果摘要、详情与返回来源模块的继续操作契约，不重做通用任务生命周期） 未覆盖页面：只读

• P-VIS-WORKSHOP 与 P-VIS-MODEL-PRODUCT 的单图编辑范围只用 Segmented 呈现“整张图片 / 框选局部”；选择框选后，指针拖拽形成区域，区域过小就地提示且不创建任务。编辑参考图集中在 AI 编辑面板，可上传、移除缩略图；用途由操作上下文确定；不再渲染独立参考素材 Tab、重复上传器或第二次提交。
• P-VIS-TEMPLATE 的列表移除 完整 / 待完善 状态标签，保留启用/停用 Badge。模板编辑器将当前槽位的布局预览、比例和尺寸输入放在同一栏；保存写入模板新版本默认值。图片工坊创建任务前展示本次槽位的尺寸/比例覆盖，覆盖仅写当前快照；能力适配器返回实际尺寸后才可在结果中显示，不把计划值标为实际输出。
• P-VIS-WORKSHOP 的生成中与结果继续在同一右侧画布，以原有卡片网格、槽位顺序和套图 Tab 展示。移除该页面的任务详情入口与专用 Drawer；卡片保留编辑、下载和失败提示；重新生成仅在套图批次区域，不进入单图编辑器。

CR-20260920-002 · 场景与风格参考图选择

• P-VIS-WORKSHOP 的“换场景”初始不预选。场景和风格选择区只显示当前选择摘要与打开按钮；点击后分别在 Modal 中浏览带名称、分类和完整缩略图的参考图卡片，不在 Drawer 内压缩平铺全部卡片。
• 选中场景或风格参考图后，图片编辑以当前图片版本为父图创建新版本；不触发套图规划、不重生成整套图片、不新增 AI 整理或前台用途选择。用户补充要求原样追加，框选时只附加当前选区。
• 场景/风格参考素材随原型直接打包，禁止依赖不可用的运行时公共路径；已接入的风格图仅为极简棚拍、酷炫科技风、自然生活、高端质感、清晰卖点、柔和治愈。

CR-20260921-001 · 套图模板先行与结果排版一致

CR-20260921-002 · 图片规格统一控件

• 模型保持 Select：GPT-Image-2、Seedream-5.0-lite、Seedream-5.0-pro、GPT-Image-2.5-Sunburst、GPT-Image-2.5-Flare、grok-imagine-image-2.0。
• OutputSpecPicker 是唯一规格控件：Popover 两栏级联，左栏比例、右栏该比例可用尺寸；20 个平台尺寸枚举不得删除或改写。自定义宽×高写入当前快照，校验失败就地说明且不静默改写。套图在槽位卡片下使用同一控件，单图复用，不增加独立生成设置页。
• 规格可用性是规则/能力表判断；本原型不宣称未接入路由的组合可调用，也不含 Planner 自主推荐尺寸。

• P-VIS-WORKSHOP 的一级流程调整为“1. 选择模板 → 2. 商品与要求”。首次进入不预置模板；模板选择使用 Modal，每个选项展示模板名称、适用范围、缩略排版预览、槽位数与版本。选定后进入商品资料填写，本次任务不再提供“更换模板”入口；已选模板仅可打开只读详情预览，查看排版和各槽位细节。
• 商品库卖点逐条直载并可编辑；左侧“下一步”派生右侧预览，右上角“生成”才创建普通套图任务。
• P-VIS-WORKSHOP 的结果复用确认预览的套图 Tab、槽位顺序和卡片网格；不再按图片类型重新分组，点击结果图片仍打开统一编辑器。

来源与范围

CR-20260921-010 · 双编排编辑

补齐既有规则：模板应用须再检验可用性，选择时深拷贝版本以免管理修改回写当前任务；无匹配/无授权模板分别显示空态。初次生成仅v1；编辑记录冻结父版本、动作、用户原文、场景ID/风格、范围和参考数量；只更新目标槽位latest，不自动采用。场景仅选参考图即可提交，补充文字独立不被图名替换。稳定槽位ID包含模板源槽位ID，避免跨组同类型碰撞。

继承TemplatePage现有基础信息+槽位列表/布局编辑母版，仅在槽位卡增加橱窗图/详情图Tabs，当前组的增删、复制、排序、布局独立。数量以独立图片槽位体现，按组复制一张；删除仅影响当前草稿。详情为空显示添加提示。打开/新建统一初始化两组，保存复制新快照，旧slotConfigs兼容为橱窗组。预览同时展示两组抽象布局图。名称/管理分组为受控字段。AC-TPL-010与产品规则对应，尺寸按CR-20260921-011同步。

本契约把已确认的 01–07 专题结论与本次模特商品图增量细化为五个正式页面和对应弹层。一期 AI 工作台的“AI 工作台、智能体中心、工作管理、Listing 优化”保留名称与业务边界，不借本次改造重画。

正式原型以已走查的套图 Demo 为交互基线，但必须按正式 PRD 纠正三处早期假设：不保存到独立图片资产、不暴露完整 Prompt 自由编辑、不使用“候选/采用”状态。

页面清单

正式文案中的导航分组统一为“视觉生产”。当前版本不提供“参考图解析与模板重建”入口；05 历史专题结论保留。任务详情继续在工作管理中可回看，不新建“套图任务”平行入口。

产品功能覆盖矩阵

页面设计决策

页面画像在正式 Pro 基线、本地 ERP 画像候选和已确认业务结构上完成。候选建议只作为页型依据；本契约通过功能覆盖矩阵解决后才形成实施决策。

P-WORK-MANAGEMENT-VISUAL-SUMMARY

• 产品范式：共享任务运营列表
• 页面母版：现有工作管理 ProTable + 视觉任务摘要单元格 + 任务详情 Drawer
• 页面目标：让用户先用任务 ID 精确定位，再从实际成品图片直观识别使用了哪个任务，并可用输入图片核对来源
• 主用户任务：扫描任务状态，核对输入与输出映射，查看 2–5 个独立子结果，并按来源模块进入原任务继续调整或查看执行进度
• 信息优先级：一级任务 ID→成品图片与完成数量；二级输入图片、任务类型、状态和创建时间；三级历史兼容说明和执行证据
• 主操作：行内“查看详情”保持只读核对；可追溯任务并列提供“继续调整/进入任务”。历史缺来源或快照时继续入口禁用，避免伪造可恢复状态
• 密度策略：compact
• 视觉强调：data-first
• 视觉强调对象：任务 ID、真实成品缩略图、完成 N/M、输入缩略图和失败占位，不强调截断 Prompt 或工作名称
• 动效策略：minimal
• 动效说明：生成中缩略图使用固定尺寸 Skeleton，完成或失败原位更新，避免行高与列宽跳动
• 推荐组件：ProTable、Image.PreviewGroup、Skeleton.Image、Progress、Badge、Tag、Tooltip、Drawer、ProDescriptions
• 必须避免：按任务名称猜测图片内容、一个子结果拆成一行、无限堆叠缩略图、用文件名或视觉相似度补造历史映射、为视觉任务另建平行任务中心

P-VIS-WORKSHOP 图片工坊

• 商品资料后展示可选“目标用户”，无可靠来源时允许留空；按一期基线进入商品主图和使用场景，尺寸/容量/尺码与详细规格/参数图继续隔离。
• 套图预览中的内容编排沿用一期详情图的说服顺序，但二期执行单元不是一期单图限制。确认前可按卖点和模板开放边界调整，确认后不静默改变冻结单元。
• 商品主图如选择“按平台规则”，右侧预览和任务快照必须显示已解析的平台规则包版本；不得把 Amazon 白底文案带入其他平台。

• 产品范式：AI 人机协作工作台
• 页面母版：ProLayout + PageContainer + 固定双栏 的结果优先套图生产台
• 页面目标：让运营在模板边界内完成套图装配、确认、执行、版本判断与交付
• 主用户任务：从初始空态选择一期三类商品来源，确认商品事实，校对 AI 提取的卖点，选择店铺/模板与套图数量，逐套编排蓝图，确认后直达生成，逐张对比原图和结果并下载
• 信息优先级：一级商品信息完整度、当前套图阶段/主操作/阻断；二级卖点、店铺、模板和有序图片；三级历史版本和任务证据
• 主操作：商品页签使用内联“下一步”；模板页签底部使用“确认”；套图预览右上角使用“生成”；结果阶段页面顶部使用“下载全部套图（N 套·M 张）”。同一阶段只突出当前动作，不增加重复只读页面或 Listing 动作
• 密度策略：standard
• 视觉强调：decision-first
• 视觉强调对象：当前阶段、当前版本、确定性阻断/不完整风险和交付动作
• 动效策略：standard
• 动效说明：阶段切换、真实进度、逐图揭示、Drawer 进出和版本切换可感知，不演示思考链
• 推荐组件：PageContainer、Tabs、Form、Input.Search、Select、InputNumber、Progress、Skeleton、Descriptions、Drawer、Modal、Radio.Group、Segmented、Upload.Dragger、Alert
• 必须避免：多主操作、重复蓝图确认页、自动选模板、系统替用户选图片模型、无类型新增槽位、参考图解析入口、向运营展示 Prompt/执行链路/内部成功门禁、AI 视觉质量评分/硬门禁/自动重跑、“候选/采用”状态、虚假资产入库

P-VIS-PLANNER-WORKBENCH 规划工作台（三位一体高保真工作台）

• 产品范式：专业级 AI 视觉规划与编排工作台
• 页面母版：ProLayout + PageContainer + 三位一体工作台模式
• 页面目标：交付“单图规划工坊模式”、“套图 5~8 张画卷叙事模式”、“模特姿势库微调与穿戴模式”以及“八维质量走查与对比检视器”的一体化生产环境，通过物理人机工程学与确定性事实锁消除买家疑虑。
• 交互三层架构落地：

1. 第一层：画布与时序流 (Storyline Canvas)：在套图模式下，以卡片时间线（Slot 1~5+）展示各张规划意图（Hero Main, Exploded / Core Tech, In-Use / Gesture, Physical Scale Anchor, Spec / Compatibility），支持拖拽换序与一键补全缺失角色。视觉近重复仅以浮层气泡提示（如“检测到机位接近，建议更换角度”），用户主动点击重生成，绝不阻断。
2. 第二层：规划单结构化检视器 (Plan Inspector)：点击任意图片槽位，侧边抽屉展示机位焦距 (CameraShotPlan)、比例尺参照物标签 (PhysicalScalePlan)、手势与接触点提示 (GesturePlan)、留白安全框遮罩预览 (NegativeSpacePlan)。
3. 第三层：对比与版本回溯 (Inspection & Diff Hub with Eight-Dimensional Defect Marker)：三联分屏比对（左原图 vs 中规划单 vs 右生成结果），多版本回溯（v1, v2, v3...）与“使用此版本”切换。集成八维缺陷标记组件（PRODUCT_IDENTITY, SCALE, INSTALLATION, ORIENTATION, EFFECT_ORIGIN, EFFECT_PATH, HUMAN_ANATOMY, OCCLUSION），结构化展示缺陷并提供“用户主动重新生成”入口。

• 生图模型选择：用户在生成前单选图片生成模型（如 FLUX 1.1 Pro / Midjourney v6.1 / GPT Image 2 / Seedream 5.0 Pro），前端固化快照并在任务中留存；普通界面严禁暴露 plannerKey 或底层 Provider 调度细节。
• 准入门禁与下载自由：彻底消除“AI 质检门禁阻断”、“AI 评分不合格禁止下载”等陈旧概念。生成成功即产生版本，用户拥有最终交付决策权。

P-VIS-TEMPLATE 模板中心

• 产品范式：ERP 规则配置与版本治理
• 页面母版：ProTable 列表 + PageContainer/ProForm/EditableProTable 独立编辑页
• 页面目标：让管理者理解模板作用域并安全维护有序套图结构、运营边界和版本
• 主用户任务：查询模板，新建/复制，从图片类型目录配置结构和单套数量边界，预览影响，保存新版本并启停
• 信息优先级：一级启用状态/适用范围/当前版本；二级槽位结构和锁定/开放项；三级满意度汇总、变更差异和操作日志
• 主操作：列表“新建模板”；编辑页“保存新版本”
• 密度策略：standard
• 视觉强调：form-first
• 视觉强调对象：槽位顺序、作用域、锁定/开放项和停用/恢复影响
• 动效策略：minimal
• 动效说明：查询、抽屉、表单校验和保存反馈；拖拽顺序更改给出清晰落点
• 推荐组件：ProTable、QueryFilter、ProForm、EditableProTable、Drawer、ProDescriptions、Alert
• 必须避免：窗口内表单墙、修改立即覆盖历史、自动启用草稿、把满意度误写成模板评分、多个重复保存按钮

P-VIS-MODEL AI 模特库

• 产品范式：共享资源运营列表
• 页面母版：ProTable 封面列 + ProDescriptions 详情 Drawer + 分步创建 Drawer
• 页面目标：让成员快速理解启用共享 AI 模特的适用场景，并在权限内创建或治理
• 主用户任务：查看模特与推荐语、描述或上传成人 AI 模特、选择身份候选、检查多视角一致性、启用、停用/归档
• 信息优先级：一级展示图/启用状态/推荐语；二级创建者、模板兼容和参考完整度；三级操作日志与历史任务影响
• 主操作：“创建 AI 模特”
• 密度策略：compact
• 视觉强调：data-first
• 视觉强调对象：模特展示图、推荐语和当前可用性，不用多色标签模拟能力评分
• 动效策略：standard
• 动效说明：Drawer 创建/详情、身份候选生成、选择与一致性结果反馈可感知
• 推荐组件：ProTable、Image、ProDescriptions、Drawer、Steps、Segmented、Upload、Skeleton、Tag、Alert
• 必须避免：性别/体型/市场风格筛选器、团队审核、真人授权字段、儿童模特、用风格相似替代同人身份

P-VIS-MODEL-PRODUCT 模特商品图

• 产品范式：AI 人机协作生产页
• 页面母版：PageContainer + 固定双栏 的结果优先生产工作台
• 页面目标：让运营使用商品图、启用共享 AI 模特和可控画面方案生成模特商品展示图，并进入下载/编辑/套图回填
• 主用户任务：在左侧通过统一三来源入口维护商品，选择共享模特、画面、姿势和生成设置；右侧持续查看蓝图、生成进度和当前结果
• 信息优先级：一级当前画布/生成结果和唯一主操作；二级商品、模特、画面、姿势与阻断；三级版本和任务证据
• 主操作：左侧底部唯一“开始生成 / 重新生成”；结果底栏提供编辑、下载和套图回填，不制造第二个页面主操作
• 密度策略：standard
• 视觉强调：decision-first
• 视觉强调对象：右侧当前结果、生成进度、商品/模特身份锁定和真实阻断
• 动效策略：standard
• 动效说明：左侧分组切换不影响右侧；生成阶段在同一画布使用 Progress/Skeleton，完成后逐张揭示，不增加装饰动效
• 推荐组件：PageContainer、Tabs、Segmented、Radio.Group、Modal、Upload.Dragger、InputNumber、Progress、Skeleton
• 必须避免：新增顶层领域、把模特创建混入生成页、承诺参考图 1:1 复制、暴露 Prompt/骨骼点/坐标/模型参数、自动发布 Listing

P-VIS-PROMPT Prompt 管理

• 组合预览按规则解析、画面规划和最终编译三段追溯：规则段包含一期基线、平台规则包、模板快照、图片类型、用户输入和类目规则；规划段包含套图计划（如有）、逐图计划和校验记录；编译段展示最终 Prompt 与 Provider 请求引用。完整 Prompt 仅管理者可见。
• 平台规则包必须显示版本、成熟度和核验状态；team-candidate 只能用于验证和提醒，不渲染为“官方已核验”或发布硬阻断。
• 普通套图的总导演与商品规划师归现有Prompt治理；旧模特Planner仅供历史追溯，当前模特直接候选独立登记；可按实际受管资产测试与回退，不能把九类图片复制为九个独立规划师，也不能把三类策略合并成无 Schema 的万能 Prompt。

• 产品范式：ERP 规则配置与运行治理
• 页面母版：ProTable 列表 + PageContainer/ProForm 独立编辑测试页
• 页面目标：让有权用户通过稳定编码和版本安全维护四类 Prompt，并理解对运行任务的影响
• 主用户任务：查询 Prompt，编辑模块/Schema，组合预览与测试，保存新版本，恢复或受保护删除
• 信息优先级：一级 prompt_key/类型/启用状态/当前版本；二级适用场景、模型、Schema 和兜底状态；三级任务引用、差异与操作日志
• 主操作：列表“新建 Prompt”；编辑页“保存新版本”
• 密度策略：standard
• 视觉强调：form-first
• 视觉强调对象：稳定编码、组合来源、Schema 校验、在用保护和兜底可用性
• 动效策略：minimal
• 动效说明：编辑区分组展开、Schema 校验、测试返回和保存反馈
• 推荐组件：ProTable、ProForm、Tabs、Collapse、Alert、Drawer、ProDescriptions
• 必须避免：稳定编码可编辑、空 Prompt 测试/运行、在用 Prompt 物理删除、草稿→审批→发布的伪复杂生命周期、弹窗内编辑整套配置

页面-区域-组件映射

普通控件契约

复杂控件契约

套图装配台

• 页面与模特商品图共享固定双栏母版。左侧只放当前输入和决策：商品与要求、模板与店铺、套图数量；右侧始终保留蓝图、生成进度或结果。“套图数量”是唯一运营侧批量输出字段。
• 商品输入在左侧展示小尺寸三来源入口；每个入口打开对应来源专属 Modal，完成上传或 Item ID/SKU 查询后回到左侧填写商品资料、原始核心卖点和特殊要求，不显示商品名称字段。数据库卖点按原文逐条可编辑，点击左侧下一步派生预览；不设AI整理/确认门禁。商品空态只阻止蓝图和生成，不阻止套图数量在 1–5 内调整。
• 套图图片类型与文案区来自模板；图片语言在现有生成参数中设置，各预览槽位下配置本次outputSize。任务快照冻结本次语言与输出规格，比例由精确尺寸派生。
• 右侧用 Tabs 表示套图 1…N；每个 Tab 只编辑自身槽位，切换 Tab 不丢失其他套图调整。
• 蓝图槽位卡展示模板图片类型和抽象版式；核心卖点卡只读展示对应摘要。结果阶段按当前模板版本的实际图片类型分组，组内并排展示同类型图片；结果卡不重复目的说明、“模板必需”或锁定标签。
• 拖拽前→后时插入目标之后，后→前时插入目标之前；前后方向都必须真实换位。必需槽位不显示删除；固定槽位不允许拖拽。越界动作保留当前蓝图并用 message/Tooltip 说明原因。
• 阶段为配置待确认、套图操作预览、生成中、结果。配置确认后在同一成果区显示可操作预览；点击预览右上角“生成”进入生成中，不插入重复只读预览页；阶段改变时保留当前套图 Tab、槽位顺序与选中项。

多套去重与批次

• Tab 是可见编排手段，不作为“已去重”证据。确认前对所有槽位执行全批次签名校验，签名至少覆盖角色、内容焦点、版式、场景关系、镜头/景别和信息表达。
• 差异规划和生成后相似度检查在后台持续执行；无冲突时不展示成功说明，冲突时才在蓝图区标记对象、禁用主操作并给出减少套图、减少复制或更换模板的具体建议。
• 生成阶段第一层展示批次进度，第二层用套图 Tab 展示每套已完成/总数，第三层在当前 Tab 内展示全部槽位的已完成、生成中、排队中状态；单张完成事件到达后立即以真实图片替换 Skeleton。
• 事件流重连按批次/父任务/子执行 ID 和版本幂等恢复；已完成图片不退回等待态。前端不得把逐图揭示描述成所有 Provider 均支持像素级图片流。
• 完全相同内容可按确定性指纹标记；视觉近重复只在受影响结果上低强调提示，由用户保留、编辑或手动重新生成。前端不得自动提交重跑、减少数量或改变父任务状态。

单图编辑 Drawer

• 使用约 2/3 视口宽度的 Drawer。左侧固定展示目标图、当前/最新版本、对应卖点与本图锁定项；右侧承载操作，避免大图把编辑控件挤出首屏。
• 一级 Tabs 只保留“AI 编辑、版本记录”两组；图片比例与结构化文案已前置到生成设置，不在结果编辑中重复出现。AI 编辑内部用 Segmented 切换自定义修改、换场景和换风格；结果/历史任务层的“重新生成（新任务）”不属于该编辑工具组。
• AI 编辑再以独立 Segmented 选择“整张图片、框选局部”。框选模式必须按住拖动并实时绘制区域边界，过小区域作废。未标记时主按钮禁用，切换范围清空旧选区。
• 自定义修改字段标为“修改要求”，允许提示词式自然语言；换场景初始不预选，使用“当前选择摘要 + 场景参考图 Modal”浏览和选择，未选择时可填写补充场景要求；换风格使用同样的风格参考图 Modal，并可补充要求。两者以当前版本为父图创建新版本；重新生成沿用当前商品/模板/槽位快照并允许补充要求。
• 前端不出现完整执行 Prompt、Provider/模型参数、坐标/Mask 实现或可改写的系统锁定指令；后台约束默认不以前台 Tag 或成功声明暴露。
• “商品真实性”等无直接操作动作的系统约束不再以 Tag 或成功声明展示；商品事实、授权、安全、模板和已核验平台硬规则进入生成前确定性校验，结果不执行 AI 视觉质量门禁。
• 前端提交edit_scope（whole/box）、父版本、可选参考图/选区、所选模型与user_edit_requirement_raw原字符序列。服务端按本次固定编辑规则拼接，商品快照不注入图片模型；运行中不静默切换模型。
• 当前生成结果固定作为编辑基础图；整图和框选两种范围均可附加参考图。参考图显示缩略图；选择预设后可直接提交，无需重复填写要求；动态上限在上传区说明，超限立即阻止。
• 提交前用真实能力快照校验“基础图 + 选区 + 参考图”组合。不支持时在 Drawer 内原位提示，主按钮禁用并保留选区、参考素材、角色和文本，不静默丢弃输入或改成整图编辑。
• AI 编辑、换场景、换风格用“生成新版本”。成功后版本数增加，“正在使用”的版本不自动改变。
• 若能力快照声明支持渐进预览，临时预览覆盖同一预览位且不写入版本列表；不支持时使用按钮 loading 和生成中反馈，最终成功后一次追加版本。失败恢复当前版本、表单与选区；用户点击重新生成后创建新任务与新输入快照。

历史设想：结果检查与对比检视器（不在当前交付）

以下不是本轮已实现界面或新增研发要求；当前结果按已验收网格及版本抽屉。

• 三联分屏对比架构：检视器支持横向三联分屏（左侧【原始素材图】 vs 中间【作图规划单】 vs 右侧【AI 生成结果】）。
• 左侧展示所选原始商品图或参考素材，标注物理事实（尺寸标注、关键部件、颜色材质）；
• 中间展示结构化作图规划单（CameraShotPlan 焦距视角、PhysicalScalePlan 比例尺参照物标签、GesturePlan 握持接触点、NegativeSpacePlan 安全留白网格遮罩）；
• 右侧展示当前采用的生成结果，支持历史版本回溯切换（v1, v2, v3...）与“使用此版本”操作。
• 八维缺陷标记与交互：
• 后检覆盖八个独立物理/视觉维度：PRODUCT_IDENTITY (商品身份)、SCALE (比例尺)、INSTALLATION (装配关系)、ORIENTATION (朝向视角)、EFFECT_ORIGIN (作用起点)、EFFECT_PATH (作用路径)、HUMAN_ANATOMY (人体/手势)、OCCLUSION (遮挡穿模)。
• 右侧画面支持缺陷标记图层（Defect Overlays），点击锚点气泡展示：缺陷维度、严重度（info/warning/error）、预期规范（Expected）与观察结果（Observed）。
• 绝对无阻断与下载自由：严禁引入“AI 质检门禁阻断”或“AI 评分不合格禁止下载”。八维问题仅作为给用户的结构化质量决策参考；所有生成成功图片均可自由下载与采用。
• 近重复非阻断浮层提示：当检测到视觉近重复时，系统仅在对应卡片上展示低饱和 Warning 气泡提示（如“检测到机位接近，建议更换角度”），不自动重跑，不禁用下载；由用户主动点击“重新生成当前槽位”或保留使用。
• 结果页唯一主操作为“下载全部套图（N 套·M 张）”，打包当前任务所有已生成套图及采用版本，并说明生成中/失败图片不在本次包内；不出现“交付当前结果”或“用于 Listing”。

AI 模特创建 Drawer

• 使用 840px Drawer 和三步 Steps。第一步以 Segmented 选择“描述要求，AI 生成”或“上传已有 AI 模特”；生成方式可选上传多张“模特参考图”并指定主参考，上传已有 AI 模特仍至少需要 2 张成人 AI 模特参考。
• 可选模特参考图只约束脸型、发型、肤色、体型和气质，不采纳图中商品、背景或姿势。来源为真人照片时必须勾选已取得肖像授权，否则阻止进入候选生成；来源为 AI 合成人物时仍执行成人与敏感穿戴限制。
• 第二步展示真实人物身份候选卡，允许主动选择和换一组；候选加载使用 Skeleton，不把候选直接保存。
• 第三步并列身份主参考与多视角一致性样例，允许自然语言微调，并展示可修改的 AI 推荐语；保存并启用后返回列表。
• 不新增性别、体型、市场风格前台筛选；儿童和三类敏感穿戴在第一步直接告知并阻止。

模特商品图结果优先工作台

• 沿用已验收左侧集中配置、右侧按生成批次Tabs和结果卡片的布局，不增加旧三分组姿势解析步骤。
• 商品三来源与共享模特库复用；画面参考与自由描述共同输入，不先解析参考图或改写原话。参考预设/上传只保存一个有效生成参考和实际选定范围。
• 模型、数量、语言、文案、outputSize在本次任务冻结；语言受控为English/中文/无文字，不能固定传无文字。
• 四工具与版本规则见CR-012；编辑参考scopes按工具确定性生成，父图必须当前采用版本。对照清单明确演示资产与真实业务资产的区别。
• 左侧生成/重新生成属于模特批次动作；套图左侧下一步仅预览。单图编辑不提供重新生成按钮。

统一商品输入组件

• 图片工坊和模特商品图沿用同一紧凑三来源入口：从本地上传、从 Listing 选择、从产品系统选择。入口位于左侧控制栏；点击后打开对应来源专属 Modal，弹层内不再展示来源 Tabs，不另造模块专属入口。
• Listing 使用平台 + Item ID 查询，产品系统使用 SKU 查询；查询结果以 Checkbox 支持多选，点击一次“确认选择”后同步资料与来源标识，系统商品名称只进入后台快照，不作为前台字段。
• 本地来源专属 Modal 使用 Upload.Dragger multiple 并允许用户在首次选择后继续拖拽追加。三种来源共用已选图片托盘：显示缩略图、顺序、主参考标记和删除；输入数量上限由当前模块与 Provider 能力快照返回，不得复用“生成数量最多 5 张”作为上传限制。
• 返回左侧后填写可验证资料、原始核心卖点与本次特殊要求；缺少必要商品输入时说明原因并保留输入，不提供AI整理/确认门禁；已有卖点直接加载，缺失可手工补充。
• 商品资料、核心卖点、特殊要求、自由画面描述和编辑修改要求等长 TextArea 右上提供“放大编辑”。Modal 宽度约 72vw、最大 960px，编辑区约 70vh；显示字段名称、字数和当前校验，确认回填，取消不覆盖，关闭后滚动位置和草稿状态可恢复。放大层不展示编译 Prompt。
• 当前版本不展示参考图解析与模板重建入口或 Drawer；单图编辑里的本次参考素材保持原能力。

工作管理视觉任务摘要（跨模块契约）

• 不新增视觉任务中心；通用工作管理的 ProTable 接收视觉父任务摘要。视觉任务的主识别单元为“输入图片 → 生成结果”，任务名称缩成次信息，不允许把 Prompt 截断后当任务名。
• 列表单元左侧显示输入缩略图，右侧显示结果缩略图，中间显示箭头或“已完成 N/M”。输入和结果各最多直接展示 3 张，其余使用 +N；排队/生成中使用固定尺寸 Skeleton，失败使用同尺寸失败占位，避免行高随图片数量失控。
• 一个视觉父任务只占一行；生成 2–5 个结果时不拆成多行。点击缩略图组或“查看”进入任务 Drawer，完整展示全部输入、角色、图片类型、结果子执行、当前版本和实际失败问题；重新生成创建新任务。
• 历史数据缺少绑定时，缩略图区显示“历史任务未记录输入/输出映射”，仍保留原状态、时间和查看入口；前端不得从任务名、文件顺序或视觉相似度补造绑定。

单图片类型多结果

• 非套图图片功能使用独立“生成数量”InputNumber，范围 1–5；它与套图数量、槽位数量和上传图片数量分开命名、分开状态保存。
• 创建任务后右侧保留结果主画布，1 张时不显示冗余缩略条；2–5 张时显示固定尺寸缩略条和“已完成 N/M”。每个结果卡绑定独立 execution_id、状态、差异化指令摘要和版本。
• 单个子执行失败不清空其他结果；“重试失败项”只提交失败对象。后台未能形成足够差异化计划时在生成前阻止，不得让前端循环提交同一 Prompt。

模板/Prompt 独立编辑页

• 从列表进入时保留查询参数；取消/保存后返回原列表上下文。
• 页面只有一个固定主操作“保存新版本”；预览/测试是次级操作。
• 保存前给出就地校验和影响摘要；只有停用/恢复/受保护删除才另行确认。

表格与数据展示契约

模板列表

AI 模特列表

列为展示图/名称、AI 推荐语、创建人、当前状态、最后修改时间和操作。不出现性别呈现、体型、市场风格、适用品类筛选列；内部兼容能力只在详情中作为机器校验摘要。

Prompt 列表

列为 prompt_key、名称/四类型、策略角色、适用场景、适用模型、输入/输出 Schema、启用状态、当前版本、兜底可用性、最后修改人/时间和操作。规划策略行以“套图总导演 / 普通商品图 / 模特商品图”显示业务角色。prompt_key 始终只读且可复制；使用中/已引用对象不显示物理删除。

状态与权限矩阵

交互与反馈

1. 切换店铺导致当前模板不可用时，保留商品与其他合法配置，就地提示重选模板，不自动切到“最相似”模板。
2. 运营微调超出模板边界时在当前字段下说明锁定依据或允许范围，不等提交后统一报错。
3. 以下仅限历史取消回执或未改造模块，不是当前套图入口：终止确认必须说明“已成功结果保留、只终止未完成执行、费用以 Provider 真实回执为准”。
4. “使用此版本”不使用破坏性确认；操作后“正在使用”标记立即切换，版本数量不变。
5. AI 视觉质量判断和近重复提示不禁用“使用此版本/下载”；只有明确授权、安全、技术文件或已核验平台硬规则冲突才按对应确定性契约限制操作并给出原因。
6. 模板/Prompt 保存成功后提示新版本号；无审批状态，启用是另一个有权动作。
7. 无权操作不仅是 disabled：不属于用户能力的菜单/主操作不显示；对已可见对象的受限动作才使用 disabled + 原因。
8. 套图数量增加时仅新增缺少的 Tab；减少且将移除已编辑方案时用 Modal.confirm 明确列出影响，已保留 Tab 不重置。
9. 模板切换采用“选中待应用→点击应用模板”的 Modal 提交方式；店铺变化导致模板失效时要求用户手动重选，不能自动替换。
10. 拖拽只改变当前套图允许移动槽位的顺序，前→后和后→前均按落点真实换位；复制/删除后重新编号，但稳定槽位 ID 不变。
11. 左栏商品三来源单层直达；已有逐条卖点自动加载并允许人工修改，必要输入不足时就地提示。
12. 套图左侧下一步直接生成可操作预览，无AI整理与确认。右侧生成才提交任务。
13. 普通运营页面不提供执行说明、Prompt 查看入口或内部检查成功摘要；技术快照只在有权管理页面和审计数据中保留。
14. “下一步”只切换至模板页签；“确认”只生成套图操作预览；右侧“生成”是预览阶段唯一任务创建动作。若批次创建失败则停留当前预览并显示可恢复错误。
15. 图片子执行完成事件到达后立即揭示对应图片；当前执行使用 active Skeleton/processing，后续使用静态排队态。事件中断时保留已完成图片并显示重连状态，不清空进度。
16. 当前版本不展示参考图解析与模板重建入口；不得用隐藏按钮、空 Drawer 或“更多设置”占位保留。
17. “编辑商品信息”与“更换商品与图片”不得合并：前者打开预填的 640px Modal 并保留当前图片，只编辑名称与资料；后者打开三来源 Modal。保存商品信息时按钮 loading，成功后进入 AI 卖点分析与人工校对，失败则保留草稿。
18. 打开单图编辑时目标图、当前/最新版本和锁定项始终可见；切换 AI 编辑工具或一级 Tab 不改变目标槽位、当前版本或已选参考图角色。
19. 自定义需有明确修改要求；场景/风格可仅选预设参考并使用固定规则。成功追加新版本，正在使用版本不自动改变。
20. 结果页原图/生成图保持同尺寸；单图或窄内容状态不能放大成整行巨幅图片。任务详情只出现一次，结果页不出现 Listing/交付动作。
21. AI 模特创建严格按三步前进/返回；候选生成、候选选择、多视角一致性样例和推荐语均可真实操作。可选身份参考图支持多图和主参考，只影响人物身份特征；真人照片未确认肖像授权时不能继续。
22. 模板选择 Modal 使用纵向单选列表，每项都由内容撑开并保持完整边框；选中只改变待应用模板，不立即关闭弹层或重置蓝图。
23. 单图编辑只选择整图或框选局部。框选时左侧图片显示拖动选区反馈，未标记前主按钮禁用；重新框选更新当前选区，切换范围清空旧选区。
24. 图片编辑提交时按钮使用真实 loading。若调用能力支持预览帧则更新同一临时预览，不创建中间版本；否则保持生成中直到最终结果。成功追加版本且不切换当前，失败恢复表单与选区并允许重试。
25. 模特商品图第一步未上传商品图时不能继续；共享模特只展示启用项，选择后生成快照锁定人物身份，不静默换人。
26. 画面来源和姿势来源分别校验，并分别位于“画面设置”“模特姿势”分组。切换标准姿势时预览摘要即时更新；画面描述含姿势时必须选择采用或保留，但不得自动改写画面原文或覆盖当前姿势。
27. 模特商品图进入生成后逐张显示完成、生成中和排队中；停止只终止未完成图片，已完成结果保留。结果返回套图只建立槽位引用，不自动发布或覆盖 Listing。
28. 模特商品图不使用全页 Steps。左侧设置分组独立滚动，底部唯一主操作固定可见；右侧画布从空态、蓝图、生成中到完成结果始终存在。切换左侧分组或编辑设置不重置当前结果、选中图片和版本。
29. 套图数量 InputNumber 在初始空态也可编辑。模板切换、卖点重新总结和套图数量变化都从当前模板版本重新派生蓝图；前端不得保留旧模板角色或固定七类结果。
30. 模板编辑器显示九类稳定图片目录；槽位列表与布局详情同屏，布局通过带抽象缩略图的单选项维护。商品主图固定显示六种策略，按目标平台将不可用项禁用并解释；详细规格/参数表默认选中上图下文 62/38。商品主图背景、必需性、数量与顺序边界只读展示并进入版本快照，不提供“配置边界”按钮或运营调整弹窗。核心卖点图的张数展示为“按 AI 摘要自动展开”，不显示固定最大张数控件。
31. 完成结果在右侧使用最大可用画布；只有结果数大于 1 时显示缩略条。身份、商品关系和当前版本使用轻量底栏，不得用大块检查卡压缩图片首屏面积。
32. “下载全部套图”按当前任务统计可打包的套图与图片数量；全部未完成时禁用。点击先打开导出 Modal，展示包含/排除范围、当前使用版本、ZIP 名、suite-NN 目录、图片文件名以及 manifest.csv/json；用户确认后创建后台任务并返回任务 ID，不伪造即时下载完成。
33. 作图规划发生在后台，不增加一级 Tab、Steps、弹层确认或普通运营 Prompt 入口。规划中沿用右侧成果区生成方案状态；失败只提示受影响对象和可重试动作。
34. 套图结构变化只使当前受影响套图计划失效；卖点删除继续即时移除对应未提交卖点图与逐图计划，不重新规划其他图片。套图总导演不得通过前端状态反向增删或改序蓝图。
35. Prompt 管理测试规划策略时必须同时展示结构化计划、事实/规则引用和校验结果；只有校验通过才允许预览最终编译 Prompt，不允许以自然语言“看起来正确”代替 Schema 通过。
36. 模特商品图右侧预览由 plan 唯一决定：template 渲染固定模板区域，reference 渲染上传原图与解析状态，free 渲染描述摘要或 Empty；禁止参考图/自由描述分支复用模板人物区和商品区 DOM。
37. 工作管理视觉任务行必须优先展示输入/结果缩略图和完成数；任务名称不得承载完整 Prompt。多图折叠为 3 张 +N，详情 Drawer 才展开全部。
38. 图片来源专属 Modal 支持多选、拖拽追加、删除、排序与主参考标记；关闭未确认时不应用临时选择，确认后一次回填。
39. 单图片类型生成数量为 1–5，每个结果独立揭示和返回实际失败问题；用户重新生成时创建新任务。不得与上传数量、套图数量或槽位数量共用状态字段。
40. 框选局部后仍可上传参考图；能力预检失败时主按钮禁用且所有编辑输入保持。任何自动清空选区或丢弃参考图均为硬性失败。
41. 长业务字段的放大编辑 Modal 只在确认时回填；取消、Esc 或关闭不得覆盖原值。放大层不出现完整系统 Prompt。
42. 无第三方品牌资产授权时，结果和 Prompt 预览不得出现 Apple、Windows、浏览器等第三方官方 Logo/图标；有兼容事实时只显示中性文字，授权命中必须可追溯。

文案

视觉契约

• 正式源码必须是 React + TypeScript + antd 6 + ProComponents；页面壳使用真实 ProLayout + PageContainer。
• 使用官方 Token 和项目 ANT-PRO-ERP-1.1；不设置紫粉渐变、玻璃态、大面积彩色卡片或独立 AI 色板。
• 布局背景、白色内容面和 Drawer/Modal 形成三层表面；只有真实浮层使用阴影。
• 任务状态、当前版本和确定性阻断是唯一允许获得明显语义强调的对象；近重复提示、模板分类和参考结构使用低饱和表达。
• 1440×900 默认视口下，图片工坊必须同时显示当前阶段、主操作、左侧主输入、套图 Tab 和右侧至少一排套图缩略图；1280px 时允许内容区纵向排列，但不删功能、Tab 或操作。
• 抽象版式使用低饱和紫蓝、柔化信息块和白色内框表达布局关系，不带具体商品、场景名称或工程标注；选项左侧使用从同一确定性总图切出的三张布局预览，右侧展示布局名称和比例说明。总图必须按 80%、40/60、30/70 固定几何绘制，不得翻转、旋转或复用同一切片近似表达。实际商品图仅用于输入、生成过程和结果预览。
• 列表页查询与表格为独立白色容器；使用 ProTable.search/QueryFilter 标签模式，不手写重复 label 筛选器。
• 模板选择 Modal 的结构缩略图固定为独立首列，名称/来源/作用域/版本在第二列自然换行；单选控件不占用内容行高，不使用固定高度 Button 承载多行卡片。

来源追踪

前端验收清单

• [ ] 工作管理保持共享一级入口；“视觉生产”包含图片工坊/模特商品图，“视觉管理”包含模板中心/AI 模特库/Prompt 管理；Prompt 管理受权限控制。
• [ ] 功能覆盖矩阵中除 F-VIS-003 当前不适用、F-VIS-089/091 为后台契约且无新增普通用户结构外，其余 F-VIS-001–104 实现项均有可见、跨模块或管理追溯证据。
• [ ] 工作管理已完成/部分完成任务可从列表或详情点击“继续调整”恢复来源页面及任务上下文；生成中任务显示“进入任务”且冻结输入；历史缺来源/快照时不提供假恢复。
• [ ] 图片工坊的左侧三个紧凑图片入口、三个来源专属 Modal、模板 Modal、单图 Drawer、任务 Drawer可通过真实点击操作；任一来源弹层内不重复三个来源 Tabs。
• [ ] 卖点“下一步”→模板与店铺“确认”→右侧可操作套图预览→右上角“生成”→逐图揭示→结果可真实切换；没有重复只读确认页；终止保留已成功结果。
• [ ] 套图数量 1–5 可真实增减 Tab；套图 2 复制细节槽位、前→后/后→前拖拽和换版式后，其他套图不变；必需槽位删除被阻止。
• [ ] 模板 Modal 支持先选中再应用；每个模板单独一行且缩略图/文本无重叠；切换无专属规范店铺不会自动替用户选择系统模板。
• [ ] 首次进入显示商品空态，套图数量仍可编辑；本地上传、Listing 图片、产品系统图片通过各自紧凑入口直达专属 Modal，Item ID/SKU 查询后带出图片和资料，商品名称不作为前台字段。
• [ ] 卖点从数据库逐条直载，可增删改；左下一步预览、右生成，不出现AI整理/确认或套图终止。
• [ ] 模板编辑器包含九类稳定图片目录且不出现“新增槽位”；商品主图可配置白底/模板背景与三种外框；添加图片类型只列未包含类型。
• [ ] 商品主图同屏可见六种独立策略；Amazon 美国站不可用项保持可见但禁用并解释，系统通用模板不提前伪造站点放行；规格参数默认上图下文且预览为 62/38。
• [ ] 模板中心保存新版本后，图片工坊无需刷新数据源即可选择同一新版本；主图背景/外框、必需性、数量边界、类型与顺序均随版本快照传递。
• [ ] 同一模板含核心卖点图且摘要有四项时，每套自动展开四张互不合并的卖点图；换到不含该类型的模板后蓝图和结果均不残留卖点图。
• [ ] 批次→套图父任务→图片子执行层级可见；单张完成后立即揭示，当前/排队状态清晰；完全相同内容指纹可追溯，近重复只提示且不自动重跑。
• [ ] 成功结果是新版本，页面不使用“候选/采用”状态；“使用此版本”后版本数不变并标记“正在使用”。
• [ ] 套图结果沿预览槽位顺序平铺，同类型图片并列展示；卡片无目的说明/“模板必需”或任务详情入口，保留“下载全部套图（N 套·M 张）”，部分完成时范围提示准确。
• [ ] 点击下载全部套图先打开导出 Modal；命名、目录、清单和当前版本范围可见，确认后只提示已创建导出任务及任务 ID，不提示已即时下载。
• [ ] 换场景与换风格在同一 AI 编辑中上传、预览删除并标记参考图用途；模板槽位保存默认尺寸/比例，图片工坊可在生成前选择本次输出覆盖，结果编辑中无“画布与文案”。
• [ ] 单图 AI 编辑可切换整图和框选局部；框选能真实拖动并拒绝过小区域；局部未标记时不能提交；前台可选择图片模型，但无 Provider、plannerKey、坐标或 Mask 选择器。
• [ ] 图片工坊与模特商品图复用紧凑三来源；套图逐条卖点直载，模特生成不依赖AI整理；各自任务快照独立。
• [ ] 模特商品图保持已验收左配置/右批次结果布局，画面参考和自由描述直接传入，不做AI姿势解析。
• [ ] 模特商品图的模板、参考图、自由描述三种画面来源在右侧呈现对应预览；参考图与自由描述不出现模板人物区/商品区框。
• [ ] 模特商品图使用左侧集中设置、右侧持续成果画布；开始生成后不切页，完成态让结果占据主视觉并能进入统一单图编辑。
• [ ] 用户可在 GPT Image 2/Seedream 5.0 Pro 已登记选项中选择图片模型；用户选择、内部 Provider 路由、能力快照和请求格式在调用数据中可追溯；预览能力按真实响应降级，失败不产生版本且保留输入。
• [ ] AI 模特创建可真实完成定义身份/上传、选择候选、多视角一致性确认和推荐语保存三步；可选身份参考图支持多图、主参考和真人肖像授权门禁，范围说明排除商品、背景与姿势。
• [ ] 模特商品图可在固定双栏内完成商品输入、画面/姿势/共享模特与生成前设置、结果处理；切换左侧分组不丢输入，不隐藏或重置右侧结果。
• [ ] 标准姿势可切换并更新景别/朝向/商品关系摘要；画面参考与姿势参考独立上传解析；自定义姿势为空时不能继续。
• [ ] 模特商品图 1–5 张逐张揭示；结果可独立下载、进入单图编辑或返回套图“模特商品展示图”槽位，页面没有 Listing 发布动作。
• [ ] 单张完成结果不显示冗余缩略条；2–5 张显示可切换缩略条。1280×720 与 1440×900 下成果区宽于设置区且无横向溢出。
• [ ] 图片工坊不显示 Prompt、业务执行说明或模型链路；多参考图角色可操作且不自动继承下次请求。
• [ ] 工作管理的新视觉任务行可直接识别输入和结果；4 张输入/5 张结果压缩为 3 张 +N，详情可展开全部；历史缺失映射显示真实空态且不从任务名猜测。
• [ ] 三个来源专属 Modal 均支持多选；本地可继续拖拽追加，已选托盘可删除、排序和标记主参考。输入上限读取能力快照，不被“生成最多 5 张”错误限制。
• [ ] 单图片类型生成数量 1–5 可真实编辑并创建独立子执行；2–5 张结果逐张揭示、失败项单独重试且已成功结果不重跑。
• [ ] 整图和框选编辑都能在同一编辑页附加参考图与用途；不支持的 Provider 组合在提交前阻止，选区、素材和输入均不丢失。
• [ ] 商品资料、核心卖点、特殊要求、画面描述和修改要求可放大编辑；确认回填、取消不覆盖，普通运营仍看不到完整编译 Prompt。
• [ ] 未授权第三方 Logo/图标在生成前规划校验中被阻止；结果侧明确授权/安全冲突按确定性规则处理。兼容性默认使用已核实的中性文字，授权白名单命中可从任务快照追溯。
• [ ] 单图编辑器不展示“商品真实性”“模特身份一致”等无证据成功声明，不出现 AI 质量评分、后台质量门禁或自动质量修复；确定性规则真实冲突才阻断并给出业务处理动作。
• [ ] 套图批次确认前只选择一次图片模型，确认后全部父任务/子执行显示同一只读模型；执行中不静默切换，普通请求无 plannerKey。
• [ ] 视觉近重复只在受影响结果提示；不禁用下载、不自动重跑、不减少用户确认数量，用户显式操作才新建重生成任务。
• [ ] 模板列表、编辑、预览、版本恢复、启停可真实触发；保存形成新版本。
• [ ] AI 模特页无禁用筛选器/审核状态；创建和详情 Drawer 可见，敏感品类/儿童范围有明确阻止。
• [ ] Prompt 列表、编辑/测试、版本/使用追踪、在用保护和兜底状态可见；无空 Prompt 成功。
• [ ] 普通用户页面没有新增“作图规划师”步骤、Prompt 或计划详情；相同输入流程能进入规则解析、规划、校验和最终编译链路。
• [ ] 普通套图Planner与模特直接候选路由分开，编辑不调用前置AI，候选资产版本可追溯。
• [ ] 套图结构、商品事实或规则冲突会阻断 Provider 调用并定位失败计划；成功调用可追溯规则、套图/逐图计划、校验和最终编译快照。
• [ ] 执行 prototype:pro:check、prototype:pro:build、antd lint --format json、prototype:guard、change:sync。
• [ ] 在 1440×900 及 1280 宽视口做真实交互和截图走查；与已走查 Demo 同视口对照信息层级，不因改名或整合丢失主任务。

完整前端 API 与 DTO 契约 (RESTful Interfaces & Schema)

本节正式冻结与前端工作台交互相关的全套 RESTful API 契约与 DTO 强类型声明。前端严格依据本契约进行数据交互、表单序列化与错误渲染。

1. API 端点清单

2. 详细接口契约与 DTO 规范

2.1 规划单编译接口 (POST /api/visual/planner/compile)

• 用途：在提交生成前，根据商品事实、卖点诉求、所选模板与槽位角色，调用作图规划引擎编译出结构化 VisualPlan。
• 请求体 (Request DTO)：

{
  "productContext": {
    "productId": "prod_drill_001",
    "title": "20V 无刷冲击电钻工业级",
    "category": "Power Tools",
    "rawImages": ["https://assets.erp.com/products/drill_main.jpg"],
    "specFacts": [
      { "label": "额定电压", "value": "20V", "isLocked": true },
      { "label": "夹头规格", "value": "13mm 无钥匙自紧夹头", "isLocked": true },
      { "label": "最大扭矩", "value": "65 N·m", "isLocked": true }
    ],
    "sellingPoints": ["大扭矩高效钻孔", "人机工效防滑包胶手柄", "双速可调双轴承系统"]
  },
  "targetSlot": {
    "slotIndex": 1,
    "slotRole": "HERO_MAIN",
    "requiredLayout": "visual-center-80",
    "aspectRatio": "1:1"
  },
  "selectedModelRef": "flux-1.1-pro"
}

• 响应体 (Response DTO)：

{
  "code": 0,
  "message": "success",
  "data": {
    "planId": "plan_slot1_001",
    "slotIndex": 1,
    "slotRole": "HERO_MAIN",
    "visualPlan": {
      "cameraShot": {
        "angle": "eye-level-45",
        "shotType": "medium-close-up",
        "focalLength": "50mm",
        "depthOfField": "shallow-f2.8",
        "lighting": "commercial-5600k-clean-diffuse"
      },
      "physicalScale": {
        "anchorObject": "adult-male-hand",
        "anchorDescription": "成人男性手掌握持对比，真实表达 21cm 机身长度",
        "dimensionOverlay": { "enabled": true, "metric": "210mm × 185mm" }
      },
      "gesture": {
        "interactionMode": "single-hand-firm-grip",
        "contactPoints": ["palm-to-handle", "index-finger-on-trigger"],
        "ergonomicPosture": "power-tool-grip-natural",
        "antiPenetrationStrict": true
      },
      "negativeSpace": {
        "layoutType": "visual-center-80",
        "subjectOccupancyRatio": 0.82,
        "safeZoneMargin": { "top": "10%", "bottom": "10%", "left": "10%", "right": "10%" },
        "copywritingArea": "top-banner"
      }
    },
    "factLocks": [
      { "factKey": "chuck-type", "status": "LOCKED", "enforcedRule": "严禁改变13mm金属自紧夹头外观结构" }
    ],
    "validation": {
      "status": "PASS",
      "checkedRulesCount": 14,
      "conflicts": []
    }
  }
}

2.2 批量任务生成提交 (POST /api/visual/batch/generate)

• 用途：确认蓝图后，冻结当前套图蓝图快照并正式启动批量异步生图。
• 请求体 (Request DTO)：

{
  "batchName": "工业级冲击钻_Shopee首发_5套蓝图批次",
  "selectedGenerationModelRef": "flux-1.1-pro",
  "suiteCount": 1,
  "suites": [
    {
      "suiteIndex": 1,
      "templateId": "tpl_hardware_standard_5slots",
      "templateVersion": "v2.1",
      "slots": [
        { "slotIndex": 1, "planId": "plan_slot1_001", "role": "HERO_MAIN" },
        { "slotIndex": 2, "planId": "plan_slot2_001", "role": "EXPLODED_TECH" },
        { "slotIndex": 3, "planId": "plan_slot3_001", "role": "IN_USE_GESTURE" },
        { "slotIndex": 4, "planId": "plan_slot4_001", "role": "PHYSICAL_SCALE" },
        { "slotIndex": 5, "planId": "plan_slot5_001", "role": "SPEC_COMPATIBILITY" }
      ]
    }
  ]
}

• 响应体 (Response DTO)：

{
  "code": 0,
  "message": "Batch task created",
  "data": {
    "batchId": "batch_20260911_0091",
    "status": "IN_PROGRESS",
    "totalSuites": 1,
    "totalUnits": 5,
    "frozenModel": "flux-1.1-pro",
    "createdAt": "2026-09-11T11:30:00Z"
  }
}

2.3 批量状态查询接口 (GET /api/visual/batch/:batchId)

• 响应体 (Response DTO)：

{
  "code": 0,
  "data": {
    "batchId": "batch_20260911_0091",
    "status": "COMPLETED",
    "progressPercent": 100,
    "selectedGenerationModelRef": "flux-1.1-pro",
    "suites": [
      {
        "suiteIndex": 1,
        "status": "COMPLETED",
        "completedUnits": 5,
        "totalUnits": 5,
        "units": [
          {
            "unitId": "unit_001",
            "slotIndex": 1,
            "role": "HERO_MAIN",
            "status": "SUCCESS",
            "currentVersion": "v1",
            "imageUrl": "https://assets.erp.com/visual/res_drill_01_v1.jpg",
            "nearDuplicateWarning": null,
            "historyVersions": [
              { "version": "v1", "imageUrl": "https://assets.erp.com/visual/res_drill_01_v1.jpg", "isCurrent": true }
            ]
          },
          {
            "unitId": "unit_003",
            "slotIndex": 3,
            "role": "IN_USE_GESTURE",
            "status": "SUCCESS",
            "currentVersion": "v1",
            "imageUrl": "https://assets.erp.com/visual/res_drill_03_v1.jpg",
            "nearDuplicateWarning": {
              "code": "NEAR_DUPLICATE_CAMERA_ANGLE",
              "message": "检测到与 Slot 1 机位接近 (均偏向45°右侧)，建议在需要时微调机位重新生成",
              "severity": "info"
            },
            "historyVersions": [
              { "version": "v1", "imageUrl": "https://assets.erp.com/visual/res_drill_03_v1.jpg", "isCurrent": true }
            ]
          }
        ]
      }
    ]
  }
}

2.4 历史重新生成接口（非当前单图编辑合同）

当前单图编辑使用父图及操作/参考/范围形成新版本；不得把下述旧接口作为重新生成按钮加回编辑器。套图重新生成是批次新任务。

• 用途：针对单张图片发起微调与重新生成。支持微调机位、修改要求与局部标记。
• 请求体 (Request DTO)：

{
  "unitId": "unit_003",
  "reason": "USER_MANUAL_TUNING",
  "tuningDirectives": {
    "cameraAngleDelta": "rotate-clockwise-30deg",
    "customPromptRequirement": "手部握持更加突出防滑包胶材质纹理，镜头稍微俯视30度",
    "gestureRefinement": "强化食指按压扳机的第一视角动态感"
  }
}

• 响应体 (Response DTO)：

{
  "code": 0,
  "message": "Regeneration task queued",
  "data": {
    "newUnitExecutionId": "exec_unit_003_v2",
    "newVersion": "v2",
    "status": "RUNNING"
  }
}

2.5 八维缺陷后检分析接口 (POST /api/visual/inspect/eight-dimension)

• 用途：调用确定性物理/视觉缺陷后检引擎，对生成图对比作图规划单进行八维逐项分析。
• 请求体 (Request DTO)：

{
  "unitId": "unit_003",
  "planId": "plan_slot3_001",
  "generatedImageUrl": "https://assets.erp.com/visual/res_drill_03_v1.jpg"
}

• 响应体 (Response DTO)：

{
  "code": 0,
  "data": {
    "validationId": "val_eight_dim_0098",
    "overallStatus": "PASS_WITH_POSTCHECK",
    "dimensions": [
      { "dimension": "PRODUCT_IDENTITY", "status": "PASS", "score": 98, "summary": "商品核心特征、金属夹头与双色包胶100%忠实一致" },
      { "dimension": "SCALE", "status": "PASS", "score": 95, "summary": "手掌尺寸与电钻机身比例符合真实物理尺度 (约1:1.15)" },
      { "dimension": "INSTALLATION", "status": "PASS", "score": 100, "summary": "电池仓卡扣装配状态稳固，无浮空与断层" },
      { "dimension": "ORIENTATION", "status": "PASS", "score": 92, "summary": "45度侧俯视角符合规划" },
      { "dimension": "EFFECT_ORIGIN", "status": "PASS", "score": 90, "summary": "钻头作业受力点明确指向作业基质表面" },
      { "dimension": "EFFECT_PATH", "status": "PASS", "score": 90, "summary": "钻孔碎屑自然向外飞溅，路径真实" },
      { "dimension": "HUMAN_ANATOMY", "status": "PASS_WITH_WARNING", "score": 82, "summary": "手腕肌肉稍显平滑，手指生理骨骼关节完整无畸变" },
      { "dimension": "OCCLUSION", "status": "PASS", "score": 94, "summary": "手掌握持未遮挡关键功能调节环与品牌标识" }
    ],
    "issues": [
      {
        "code": "ANATOMY_WRIST_TENSION_LOW",
        "dimension": "HUMAN_ANATOMY",
        "severity": "info",
        "anchorCoordinates": { "x": 0.42, "y": 0.68 },
        "expected": "大扭矩作业下手腕肌肉应呈现轻微紧绷张力",
        "observed": "手腕线条较为放松",
        "message": "手腕生理发力感稍显不足，但无解剖畸变，可正常采用"
      }
    ],
    "nextAction": "USER_MAY_REGENERATE",
    "downloadAllowed": true
  }
}

3. 契约防腐蚀法则

1. 零阻断原则：后端返回的缺陷列表 (issues) 和近重复提示 (nearDuplicateWarning) 仅作为用户决策信息呈现，downloadAllowed 始终为 true。前端不得以任何理由禁用“下载”或“使用此版本”。
2. 唯一模型快照：前端发起的批次请求必须显式携带 selectedGenerationModelRef，任务确认后该值在批次中只读固化。
3. 隐藏 Provider：底层 Provider、API Key、以及 plannerKey 严禁出现在前端输入控件或请求体中。

待决策

当前没有阻塞 PRD 收敛的产品决策。各模块输入参考图上限、Provider 是否支持“选区 + 多参考图”的实际组合能力、三类作图规划策略的具体模型/参数与跨品类真实 A/B 收益，以及 Seedream 5.0 Pro 的生产模型 ID、局部编辑参数形式、渐进预览能力、两类图片 Provider 的取消能力、并发数、质量/成本优先级、存储期和接口错误码，继续留在接入环境真实验证；原型不得把这些能力写死为统一事实。Planner/校验/编译禁止自动重规划、自动重试、静默换模型和自动修复。

2026-09-21 用户确认的发布边界

预览阶段仅展示模板槽位与本次参数，不调用规划师。用户点击生成后才调用规划师并执行后续生成。仅发布图片工坊、尺寸及已确认单张编辑规则；模特新版不纳入本次。主图外框新方案待用户与04任务讨论，本次不覆盖旧规则，也不宣称新版外框已实现。