V2-01 · 电商视觉转化方法论与作图规划
CR-20260921-014 适用说明：此文保留原专题/候选证据。当前产品与开发范围以prd.md、frontend-contract.md及docs/current-development-alignment.md为准。旧AI卖点整理前置、套图页终止、旧模特Planner/姿势解析不进入现行流程；历史结果不代表新模特直接候选通过真实效果验收。
状态：Freddy 已确认 · 产品语义冻结
确认日期：2026-08-21
真实验证补充：2026-08-25
专题范围：产品方法论、规划服务业务契约、V2-02/V2-03 上游语义
成熟度：规划契约 Candidate；未完成真实 A/B，不代表生产可切换
1. 确认与证据说明
| 项目 | 冻结结论 |
|---|
| 确认来源 | Freddy 在 V2-01 专题中逐项确认购买决策方法、预览/规划时机、单图多结果、多角度、校验状态、plannerKey 边界及 D01–D03 |
| 仓库基线 | 本结论基于当前 AI 视觉生产中心 PRD 包、作图规划规范、Shopee 电锤示例与一期 /Users/freddy/Downloads/ai-workspace 代码真源核对 |
| 当前 PRD 状态 | 当前仓库 PRD 包为 prototype-aligned；三类规划策略仍为 candidate |
| 不代表 | 不代表 Planner/Provider 已实现，不代表真实图片 A/B 已通过，不代表允许切换生产 Prompt |
| 文件边界 | 本文件是 V2-01 独立专题结论；不直接修改共享 PRD、前端契约、知识库、生产 Prompt 或 00 总控状态 |
| 2026-08-25 交互验证 | 电磨微型电钻套装、抹茶工具套装完成 Session 内候选出图与人工逐处反馈；只证明问题可复现并形成候选契约，不是指定 Provider 的真实 A/B，也不构成生产质量结论 |
2. 专题范围与不负责范围
| 类型 | 内容 |
|---|
| V2-01 负责 | 购买决策方法、图片类型定义、证据消费、规则作用域、套图/单图规划边界、结构化计划、计划校验、确定性编译边界、上下游稳定语义 |
| V2-01 不负责 | Provider/API 接入、模型参数、用户主动重生成的执行实现、批量任务状态机、成本、队列、结果保存、下载、Listing 交付、原型和生产发布 |
| V2-02 负责 | 在不改变本结论业务语义的前提下，决定 plannerKey 的内部计算位置、Provider/API、能力适配、请求响应和执行技术方案 |
| V2-03 负责 | 消费冻结计划与校验结果，决定批量任务、异步执行、终止、用户主动重新生成、结果保存和交付状态机；不得把用户主动操作实现成 Planner 内置自动重试 |
3. 第一性原理方法论
3.1 冻结链路
购买决策问题（设计期） → ImageTypeDefinition → 证据消费 → ImageVisualPlan / SuitePlan → 校验 → Final Prompt 编译
| 原则 | 冻结结论 |
|---|
| 购买决策问题 | 是定义图片类型的设计期依据，不是每次运行时重新识别的对象 |
| 图片作用 | 每种图片用于打消对应的购买疑虑；图片角色不绑定固定张数 |
| 运行时输入 | 已选图片类型、事实、证据、平台/模板/类目规则和用户要求 |
| 运行时禁止项 | 不重新生成 decisionRole，不在图片类型之外再做一次角色分类 |
| 计划引用 | 运行时只引用版本化 ImageTypeDefinition，不得重新解释其购买决策目标 |
3.2 Listing 购买决策链与图片类型
| 图片类型 | 设计期要解决的购买问题 | 成立所需的主要证据 |
|---|
商品主图 product_main | 这是什么、是否与需求相关、是否值得继续看 | 商品身份、核心识别特征、当前主卖点、主图规则 |
尺寸/容量/尺码图 dimension_spec | 是否放得下、装得上、穿得下或容量合适 | 已确认尺寸、重量、容量、尺码及标注关系 |
核心卖点图 selling_point | 为什么值得购买 | 已确认卖点及支撑该卖点的商品事实 |
商品细节图 detail_closeup | 材质、结构和做工是否可信 | 可见细节、接口、纹理、工艺和商品参考 |
效果对比图 effect_comparison | 与对照对象相比是否真的有差异 | 对照对象、条件、方法、结果和可成立结论 |
使用场景图 usage_scene | 应该怎么用、是否适合真实场景 | 使用环境、动作、接触关系和适用事实 |
多角度图 multi_angle | 商品整体结构和不同视角是什么样 | 商品身份锚点与图片推理输入 |
场景氛围图 scene_atmosphere | 是否符合期望的生活方式或专业形象 | 商品定位、场景、风格、受众（如有） |
详细规格/参数表 technical_spec | 参数、功能和包装内容是否满足要求 | 已确认参数、功能、数量和包装清单 |
角色不等于固定张数。同一图片类型可在一套图中出现多次，每次使用不同证据焦点或视觉表达；套图不要求九类齐全。
3.3 通用规划与具体案例隔离
| 层级 | 允许内容 | 禁止内容 |
|---|
| 固定 Planner 策略 | 从证据解析商品真实尺度、SKU/变体、场景、人物动作、遮挡和验收关系的通用方法 | 电磨、抹茶、黄色机身、日式茶桌、手掌覆盖 2/3 等任何单一案例值 |
| 当前任务动态输入 | 当前商品事实、参考图、用户明确补充、命中规则、尺度/场景/姿势证据和已解析变体 | 历史案例、其他 SKU、未命中类目/平台规则和常识补造的精确数值 |
ImageVisualPlan | 当前任务专属尺度关系、场景计划、Gesture Plan 与分项验收 | 把本次计划写回全局默认或下一任务自动继承 |
| Golden Case | 记录具体输入、计划、编译 Prompt、缺陷和修订，用于回归与污染断言 | 复制为生产固定 Prompt、类目默认场景或跨品类补值来源 |
“视觉突出”与“物理尺寸”必须是两个独立语义。商品的重要性通过构图、焦点、位置、景别和对比表达；只有证据支持时才能改变相对尺度。具体比例属于当前任务证据，不是同类商品默认值。
4. ImageTypeDefinition 冻结契约
| 字段 | 类型 | 规则 |
|---|
imageTypeDefinitionId | string | 稳定标识 |
imageTypeCode | enum | 九类受控图片类型之一 |
version | string | 内容变化必须升版本 |
status | enum | DRAFT / ACTIVE / INACTIVE；Candidate 与生产验证状态分离 |
displayName | string | 前台业务名称 |
decisionObjective | string | 设计期购买决策目标；运行时不得重识别 |
requiredEvidence | array | 缺少后该图片内容无法成立的证据 |
optionalEvidence | array | 可增强画面但不构成硬前提的证据 |
fieldConsumption | object | 允许消费的商品事实、卖点、受众、尺寸、比较、包装、模特等字段 |
forbiddenClaims | array | 不得出现的功效、参数、比较、认证、附件或其他声明 |
acceptanceChecks | array | 计划校验及正常结果质量检查清单 |
applicablePurposes | array | 允许用途，如主图、详情、广告等 |
createdBy / createdAt | audit | 版本审计信息 |
冻结治理：ImageTypeDefinition 复用现有 Prompt 管理权限、启停、版本、恢复和历史引用机制；不新增菜单、角色或审批流。已被任务引用的版本不可原地覆盖。
5. 单图与套图规划边界
| 维度 | 单图片类型 | 套图 |
|---|
| 用户确认对象 | 商品输入、图片类型、平台/站点/语言、特殊要求、图片模型、生成数量 | 商品输入、模板、套图数量、图片类型、顺序、卖点和允许调整项 |
| 预览阶段 | 无套图预览 | 只由模板、图片类型和确认卖点确定性派生，不调用作图 Planner |
| 冻结时间 | 用户提交生成时 | 用户点击“确认套图预览并生成图片”时 |
| 套图总导演 | 跳过 | 每套冻结蓝图调用一次 |
| 逐图规划 | 按 generationCount 形成 1–5 个独立计划 | 按冻结蓝图执行单元逐图规划 |
| 失败范围 | 单个结果独立返回问题；用户主动操作创建新计划 | 单个执行单元独立阻断并返回问题，不牵连合法单元；用户主动操作创建新计划 |
| 后续修改 | 新输入快照和新任务 | 新蓝图快照和新任务；历史不回写 |
6. plannerKey 产品边界
| 项目 | 冻结结论 |
|---|
| 普通用户 | 不选择、不填写、不查看、不覆盖 plannerKey |
| 普通前端 | 不得任意提交或覆盖 plannerKey |
| 用户可选择 | 业务输入、图片类型/模板、图片生成模型 |
| 系统路由 | 套图任务 → 套图总导演；普通商品图 → 普通商品图规划师；模特商品图 → 模特商品图规划师 |
| 技术实现 | 上游后端填写还是规划服务内部计算，由 V2-02 决定 |
| 审计要求 | 实际路由的策略标识和版本必须与计划、编译及执行快照关联 |
| 禁止推导 | 用户选择的图片生成模型不得替代或反向控制 Planner 策略 |
7. 核心运行对象
7.1 PlannerRequest
这是业务语义契约，不限定 V2-02 的 HTTP/消息传输结构。
| 字段 | 类型 | 规则 |
|---|
requestId | string | 请求稳定标识；幂等实现由 V2-02 决定 |
planningMode | enum | SINGLE / SUITE / MODEL_PRODUCT |
productInputSnapshotRef | string | 冻结商品图片、事实、卖点、受众和特殊要求 |
platformContext | object | platform / site / language / purpose |
templateSnapshotRef | string/null | 套图必填；单图按能力选填 |
blueprintSnapshotRef | string/null | 套图必填且已由用户最终确认 |
executionUnits | array | unitId / order / imageTypeDefinitionRef / sellingPointRef / templateConstraintRef |
generationCount | int/null | 非套图单图片类型为 1–5；套图不得复用 |
selectedGenerationModelRef | string | 用户选择的图片生成模型 |
assetBindings | array | 商品主体、配件、风格、版式、场景和模特等受控素材角色 |
categoryResolution | object/null | 可靠匹配的类目及来源；未匹配时为空 |
modelContextSnapshotRef | string/null | 模特商品图必填 |
authorizationSnapshotRefs | array | 品牌、肖像或内容授权快照 |
variantResolutionSnapshotRef | string/null | 多 SKU、套装或图文冲突时引用已解析变体；无冲突可为空 |
physicalScaleEvidence | array | 当前任务可用的尺寸、人体/场景相对关系与来源；没有证据时不得生成伪精确数值 |
physicalRelationEvidence | array | 当前任务的组件、安装、连接、承重、运动、输出与作用关系证据；无证据不得猜测连接点、朝向、起点或路径 |
sceneContextEvidence | array | 用户场景参考、模板/类目规则或可靠参考图中的环境与使用关系；必须保存作用域 |
requestedBy / requestedAt | audit | 请求审计 |
plannerKey 不属于普通用户业务输入。V2-02 可在内部请求信封中记录系统路由结果，但不能把选择权交给前端。
7.2 ResolvedRuleSnapshot
| 字段 | 类型 | 规则 |
|---|
resolvedRuleSnapshotId | string | 不可变快照标识 |
contractVersionRef | string | 当前规划契约版本 |
platformContext | object | 平台、站点、语言、用途 |
imageTypeDefinitionRef | string | 当前图片类型定义版本 |
templateConstraintRefs | array | 当前执行单元命中的模板约束 |
categoryPolicyRef | string/null | 仅可靠命中时存在 |
appliedRuleRefs | array | 只包含当前执行单元实际命中的规则 |
requiredConstraints | array | 必须满足的确定性约束 |
forbiddenConstraints | array | 当前执行单元实际适用的禁止项 |
evidenceBindings | array | 规则/字段与事实、素材、卖点的绑定 |
fieldProjection | object | 当前图片类型允许进入 Planner 的最小字段集合 |
ruleMaturity | object | 官方核验、团队候选等成熟度 |
skippedRuleAudit | array | 仅用于审计，不渲染到 Planner 上下文 |
contentSignature | string | 内容签名；历史不可覆盖 |
平台规则没有命中时，继续使用通用合规、商品事实、模板和图片类型规则，并记录内部警告；只有当前用途被配置为“必须有平台规则”时才阻断。未命中规则不得以正向或反向措辞进入 Planner 上下文。
7.3 VariantResolutionSnapshot
| 字段 | 类型 | 规则 |
|---|
variantResolutionSnapshotId | string | 不可变快照标识 |
resolutionBasis | enum | USER_CONFIRMED / SYSTEM_SOURCE / VISIBLE_REFERENCE / UNRESOLVED |
selectedVariantRef | string/null | 当前任务唯一 SKU/套装变体；无法可靠选择时为空并阻断依赖变体的单元 |
includedEntityRefs | array | 当前变体允许出现的商品、组件和包装 |
excludedEntityRefs | array | 其他变体、清单外组件或与参考图冲突的实体 |
evidenceRefs | array | 用户确认、系统字段、图片角色与事实引用 |
conflicts | array | 图文颜色、套装数量、规格或组件冲突及处理结果 |
contentSignature | string | 历史不可覆盖；不得把不同变体拼为一个“更完整”商品 |
7.4 SuitePlan
| 字段 | 类型 | 规则 |
|---|
suitePlanId | string | 每套独立计划 |
suiteSnapshotRef | string | 已冻结蓝图引用 |
plannerStrategyRef | string | 系统路由的套图总导演版本 |
narrativeObjective | string | 整套购买说服顺序 |
consistencyAnchors | array | 商品身份、风格、语言和事实写法等一致性锚点 |
objectiveCoverage | array | 各单元引用 ImageTypeDefinition.decisionObjective；不重新分类角色 |
unitDirectives | array | unitId / communicationTask / differenceDirective / evidenceRefs |
forbiddenDuplication | array | 套内不应重复的信息结构、机位或场景 |
blockedUnitRefs | array | 只记录缺少成立证据的受影响单元 |
planVersion / contentSignature | version | 用户修改输入或主动重新生成产生新计划版本，不覆盖旧计划 |
7.5 ImageVisualPlan
| 字段 | 类型 | 规则 |
|---|
imagePlanId | string | 计划稳定标识 |
unitId | string | 对应执行单元 |
imageTypeDefinitionRef | string | 引用已冻结图片类型定义 |
plannerStrategyRef | string | 普通商品图或模特商品图策略版本 |
variant | object | index / count / directive；N=1 不要求人为制造差异 |
evidenceRefs | array | 当前画面实际消费的事实、卖点和素材 |
subject | object | 商品/模特主体和身份锚点 |
scene | object/null | 环境、人物、动作及商品关系 |
physicalScalePlan | object/null | evidenceRefs / relationType / expectedRelation / tolerance / confidence / prominenceMethods；没有适用尺度关系时为空 |
sceneContextPlan | object/null | evidenceRefs / environment / actorRelation / objectPlacement / applicableScope；不得继承其他任务场景 |
physicalRelationPlans | array | 安装、连接、接触、承重、运动、输出或作用关系；逐条冻结“主体—载体—连接—朝向—作用起点—作用路径—作用对象” |
gesturePlans | array | 人物交互存在时逐手/逐动作输出结构化意图；无人物交互时为空 |
cameraFeasibilityPlan | object | requiredVisibleEntities / requiredVisibleRelations / cameraView / perspectiveConstraints / occlusionBudget / feasibilityResult；镜头必须能同时看见需要验收的关系链 |
scaleConstraints | array | subjectEntityId / referenceEntityId / metric / expectedRange / tolerance / evidenceRefs；视觉突出不能替代真实比例 |
functionalEffectConstraints | array | effectType / originRef / pathRef / targetRef / requiredVisibleSigns / forbiddenSigns / evidenceRefs；不得让效果从错误部位出现或走向错误对象 |
composition | object | 布局、镜头、光线、焦点和文字区 |
textPlan | array | 只允许已确认文字和事实引用 |
allowedEntities | array | 有事实或规则支持的实体 |
forbiddenEntities | array | 当前执行单元实际禁止的实体 |
suiteDirectiveRef | string/null | 套图逐图计划引用；单图为空 |
normalQualityChecks | array | 与其他商品图一致的生成结果质量检查 |
interactionAcceptanceChecks | object/null | 分开记录商品身份、比例、安装、朝向、效果起点、效果路径、人体解剖和遮挡，不合并成单一“看起来合理”判断 |
planVersion / contentSignature | version | 不可原地覆盖 |
gesturePlans[] 最小字段冻结为：gestureType / targetComponentId / targetRole / targetRegion / hand / finger / contactMode / directionRule / maxVisualDistance / occlusionRule / physicalConstraint / fallbackGesture。point 的几何语义是“指根→指尖延长射线与目标区域相交”；仅手在目标旁边不算满足。Planner 优先选择 HOLD_SUPPORT / NATURAL_GRIP / OPEN_PALM_PRESENT / LIGHT_TOUCH，只有表达确实需要时才使用 POINT。Fallback 只定义备用意图，不授权 Planner 静默换模型、局部修复或付费重试。
physicalRelationPlans[] 最小字段冻结为：relationId / relationType / subjectEntityId / carrierEntityId / installationMode / connectionPoints / orientation / effectOrigin / effectPath / effectTarget / physicalConstraints / evidenceRefs / cameraVisibilityRequirements / acceptanceChecks。不适用的安装或效果字段显式为 null，不得用含糊自然语言省略关系链。GesturePlan 只负责人物动作；人物以外及跨对象的安装、连接、承重、运动和功能作用由 PhysicalRelationPlan 表达，两者可以引用同一组件但不得互相替代。
7.6 PlanValidationResult
| 字段 | 类型 | 规则 |
|---|
validationId | string | 校验记录标识 |
targetPlanRef | string | SuitePlan 或 ImageVisualPlan |
stage | enum | PLAN / COMPILED_PROMPT / GENERATED_RESULT |
status | enum | 仅 PASS / PASS_WITH_POSTCHECK / BLOCK |
checks | array | Schema、事实引用、规则、物理关系、模板容量、授权和差异化检查 |
issues | array | 只返回具体不合格项：code / dimension / severity / unitId / entityRefs / evidenceRef / expected / observed / message；dimension 至少支持 PRODUCT_IDENTITY / SCALE / INSTALLATION / ORIENTATION / EFFECT_ORIGIN / EFFECT_PATH / HUMAN_ANATOMY / OCCLUSION |
missingEvidence | array | 缺失事实或授权 |
requiredPostChecks | array | OCR、明确文字/数字或已登记确定性关系等确有必要的生成后检查；不得借此建立 AI 审美评分、自动质量修复或自动付费重试 |
compilerEligible | boolean | PASS/PASS_WITH_POSTCHECK 为 true；BLOCK 为 false |
validatedAt / validatorVersion | audit | 校验器版本与时间 |
校验结果是诊断合同，不是执行指令。发现问题后不得自动重试、静默换模型、局部修复或产生任何付费调用；只返回实际失败维度及证据。用户如需重新生成，必须在结果页主动发起新请求并形成新任务/新快照。V2-01 Schema 明确不包含 retryPolicy、retryCount、fallbackProvider、autoRepair 或同义字段。
| 状态 | 是否允许编译生成 | 语义 |
|---|
PASS | 是 | 事实、规则和计划完整 |
PASS_WITH_POSTCHECK | 是 | 结果产生后仍需 OCR 等明确检查；不是通用人工复核状态 |
BLOCK | 否，仅阻断受影响单元 | 缺尺寸、缺比较成立条件、缺授权或存在事实/规则冲突 |
多角度缺少对应角度参考本身不触发 BLOCK，也不触发专门的 PASS_WITH_POSTCHECK。系统继续使用当前图片推理模型生成不同视角，并只执行与其他商品图一致的正常质量检查；不增加人工结构核对或“核对后才能交付”的产品步骤。当前样本表现较准确是采用该方案的产品依据，但不扩大宣称为所有类目、所有角度均已生产验证。
7.7 CompiledPromptSnapshot
| 字段 | 类型 | 规则 |
|---|
compiledPromptId | string | 稳定标识 |
resolvedRuleSnapshotRef | string | 规则快照引用 |
suitePlanRef | string/null | 套图计划引用 |
imagePlanRef | string | 单图计划引用 |
compilerVersion | string | 确定性编译器版本 |
selectedGenerationModelRef | string | 用户选择的图片模型 |
finalPrompt | string | 最终图片 Prompt |
inputSummary | object | 编译输入摘要 |
contentSignature | string | 不可覆盖的内容签名 |
8. 职责分界
| 组件 | 负责 | 不负责 |
|---|
| 图片类型定义 | 固化购买决策目标、证据、字段消费、禁止声明和验收 | 不在运行时重新识别角色 |
| 确定性规则解析器 | 选择当前平台、模板、图片类型、类目和授权适用规则 | 不创作画面；不把未命中规则送入 Planner |
| Planner 路由 | 按任务类型选择三个受控策略 | 不接受普通用户或前端指定策略 |
| 套图总导演 | 分配套内叙事、覆盖、一致性和差异化 | 不改变蓝图，不编写最终 Prompt |
| 逐图规划师 | 根据当前图片类型定义和证据形成结构化画面计划 | 不修改事实、规则、模板或图片类型 |
| 计划校验器 | 校验结构、事实、规则、授权、物理关系和可编译性；结果后检按八个维度返回具体失败项 | 不用“看起来合理”替代证据；不触发重试、换模型、修复或付费调用 |
| 确定性编译器 | 按稳定顺序完整传递适用规则、事实、物理关系、镜头可行性、比例和效果约束 | 不重新发挥创意，不静默补事实，不把结构化关系压缩成泛化自然语言 |
| Provider 适配层 | 把统一执行请求转换为用户所选图片模型的具体 API 请求 | 不改变图片目标、证据、计划和 Prompt 语义 |
9. 单图 1–5 个结果
| 规则 | 冻结结论 |
|---|
| N=1 | 只形成一个计划和一个结果，不额外设计五套创意 |
| N>1 | 形成 N 个独立计划和子执行，共享相同事实、规则和商品身份 |
| 差异轴 | 从合法的构图、景别、场景关系、动作、信息结构或证据焦点中选择，不预设第1～5张固定含义 |
| 规划阶段 | 尽量产生有意义差异，但不因差异程度不足而擅自减少或阻止用户数量 |
| 结果阶段 | 近重复主要由结果质量检查识别，只处理受影响结果；已合格结果不重跑 |
10. 正向流程
10.1 单图
| 顺序 | 动作 | 产物 |
|---|
| 1 | 用户选择商品输入、图片类型、平台/站点/语言、特殊要求、图片模型和数量1–5 | 业务请求 |
| 2 | 提交时冻结商品输入和图片类型定义版本 | 输入快照 |
| 3 | 按 N 创建 N 个独立计划变体 | 变体引用 |
| 4 | 解析当前执行单元适用规则 | ResolvedRuleSnapshot |
| 5 | 系统路由普通商品图或模特商品图规划师 | ImageVisualPlan[] |
| 6 | 校验每个计划 | PlanValidationResult[] |
| 7 | 对可编译计划确定性编译 | CompiledPromptSnapshot[] |
| 8 | 向 V2-02/V2-03 交付冻结契约 | 待执行单元 |
10.2 套图
| 顺序 | 动作 | 产物 |
|---|
| 1 | 用户整理并确认卖点 | 确认卖点集合 |
| 2 | 点击“确认卖点并生成套图预览” | 确定性预览；无 Planner 调用 |
| 3 | 用户调整模板允许的图片类型、顺序、卖点和版式 | 未提交蓝图 |
| 4 | 点击“确认套图预览并生成图片” | 冻结商品、模板和蓝图 |
| 5 | 解析每套、每单元适用规则 | 规则快照 |
| 6 | 每套调用一次套图总导演 | SuitePlan |
| 7 | 每个执行单元调用对应逐图规划策略 | ImageVisualPlan[] |
| 8 | 逐单元校验；缺事实只阻断对应单元 | 校验结果 |
| 9 | 编译其余可执行单元 | 编译快照 |
| 10 | 向下游交付可执行、需后检和阻断范围 | 冻结执行集合 |
11. 逆向流程、异常与历史
| 场景 | 处理 | 历史要求 |
|---|
| 预览阶段修改卖点或模板 | 重新确定性派生预览 | 不产生 Planner 历史，不存在计划失效 |
| 提交后修改商品事实 | 创建新输入快照和新任务 | 旧计划、Prompt 和结果不回写 |
| 模板、规则或图片类型定义升级 | 新任务引用新版本 | 历史继续引用原版本 |
| 图文对应多个 SKU/套装变体 | 先形成 VariantResolutionSnapshot；只消费当前已确认变体 | 不把 4/5/7 件套或不同颜色拼成一个商品 |
| 用户提供真实尺度关系 | 写入当前任务 physicalScaleEvidence 并据此规划 | 具体比例不升级为类目或全局默认 |
| 缺少精确尺寸但有参考关系 | 使用可追溯的相对关系并保持不确定性，结果执行正常质量检查 | 不编造厘米数；不因“商品要突出”放大实物 |
| 用户提供场景/操作参考 | 只抽取环境与动作方法并按当前任务作用域消费 | 不复制参考人物、其他商品、服装或受保护元素 |
| 高风险人物动作 | 规划阶段优先使用更稳健动作；fallback 只作为用户主动新任务的候选意图 | 当前生成失败后不自动采用 fallback，不改变商品事实，不静默换模型或触发付费调用 |
| Planner 输出缺字段或虚构事实 | 当前计划 BLOCK，只返回具体不合格项 | 用户修正输入或主动重新生成时创建新任务/新快照 |
| 总导演改变类型、数量、顺序或卖点绑定 | 拒绝导演计划 | 冻结蓝图不变 |
| 尺寸缺失 | 只阻断尺寸单元 | 补事实后形成新计划版本 |
| 对比依据缺失 | 只阻断对比单元 | 不制造比较结论 |
| 多角度参考不足 | 正常使用图片推理模型规划和生成 | 不增加专门人工核对门禁 |
| 多结果近重复 | 只返回受影响结果的具体提示 | 不自动重跑；用户决定是否主动重新生成 |
| 类目未可靠匹配 | 跳过类目策略 | 保存跳过审计 |
| 平台规则未命中 | 使用通用合规、事实、模板和图片类型规则；内部告警 | 未命中规则不进入 Planner |
| 核心策略不可用 | 当前调用返回配置异常 | 发布版本回滚属于治理操作，不属于当前任务自动 fallback；不以空 Prompt 调用 Provider |
12. 规划状态
本状态机只描述 V2-01 规划过程，不替代 V2-03 任务/交付状态。
| 当前状态 | 触发条件 | 下一状态 |
|---|
RECEIVED | 请求可读取 | INPUT_FROZEN |
INPUT_FROZEN | 快照完整 | RULE_RESOLVED |
RULE_RESOLVED | 套图任务 | SUITE_PLANNED |
RULE_RESOLVED | 单图任务 | IMAGE_PLANNED |
SUITE_PLANNED | 逐单元规划完成 | IMAGE_PLANNED |
IMAGE_PLANNED | 校验完成 | VALIDATED |
VALIDATED | PASS/PASS_WITH_POSTCHECK | COMPILED |
VALIDATED | BLOCK | 当前单元 BLOCKED |
| 任一规划阶段 | 技术异常或不合规输出 | PLANNING_FAILED |
COMPILED | 契约交付完成 | HANDED_OFF |
套图不新增“部分通过”校验枚举，只统计可编译、需后检和阻断执行单元数量。
13. 权限
| 角色 | 允许 | 不允许 |
|---|
| 店铺运营 | 提交业务输入、选择图片类型/模板/模特、选择图片生成模型、确认蓝图、查看需补充的事实 | 选择 Planner、修改系统规则、查看系统 Prompt、伪造授权 |
| 模板管理者 | 在既有权限内维护模板对图片类型定义版本的引用 | 修改历史任务快照 |
| Prompt/策略管理者 | 查看、测试、启停和恢复候选定义及规划策略版本 | 未经门禁宣称生产已验证 |
| 系统服务 | 自动路由、解析规则、校验和编译 | 静默改变用户确认事实或蓝图 |
| 审计权限用户 | 查看版本、引用、失败原因和历史链路 | 编辑历史记录 |
V2-01 不新增普通用户菜单、角色或审批流。
14. 一期 10 个接口迁移边界
| 一期接口/字段 | V2-01 冻结处理 |
|---|
main | 映射商品主图 |
detail | 按实际 detail_modules 映射具体图片类型，不能继续以模糊“详情图”覆盖全部目标 |
dimension | 映射尺寸/容量/尺码图 |
closeup | 映射商品细节图 |
scene | 根据明确用途映射使用场景图或场景氛围图，不能只凭接口名猜测 |
composite | 只有明确映射到某个图片类型并具备套装、配件或安装关系证据后才进入 V2-01 |
replaceScene / replaceStyle / edit | 属于生成后编辑，不重新定义为 V2-01 图片类型 |
free | 暂不进入“图片类型定义→证据消费→规划”链路 |
一期 n=1–10 | 新受控单图片类型固定为1–5，不继承上限10 |
| 一期自由中文参考角色 | 新契约使用受控素材角色和版本引用 |
| 一期前端传图片模型 | 保留用户选择图片生成模型；Planner 策略由系统路由 |
| 一期主图默认白底 | 由模板和当前命中的平台规则决定 |
| 一期自动猜类目 | 无可靠匹配时跳过类目策略 |
| 一期返回完整 Prompt | 普通运营不展示；受控管理和审计权限按现有治理使用 |
| 一期历史任务 | 不反向补造 Visual Plan；保留 legacy contract、原输入和结果 |
一期源码注释称“9个接口”，实际路由为上述10个接口；冻结与迁移按实际代码，不按错误注释。
15. Shopee 马来西亚电锤示例
15.1 商品主图
| 项目 | 规划结果 |
|---|
| 平台/站点/语言 | Shopee / Malaysia / English |
| 图片模型 | GPT-Image-2 示例快照；不代表生产资格 |
| 图片类型 | product_main；解决首屏识别、点击和价值理解 |
| 商品事实 | ABS+合金、1400W、0–1200rpm、0–5100bpm、锤/钻/凿三功能 |
| 商品身份 | 蓝黑机身、红色开关、模式旋钮、夹头、副手柄、散热口、电源线 |
| 目标用户 | 未提供；不进入 Planner，不推测 |
| 特殊要求 | 强施工现场感；专业、整洁、安全；不得添加清单外附件 |
| 规则上下文 | 只传当前命中的 Shopee Malaysia、通用合规和商品主图规则；不传 Amazon 或其他未命中规则 |
| 系统路由 | 普通商品图规划师 |
| 画面计划 | 三分之四近景；商品第一视觉焦点；成年操作人员正确握持；钻头与混凝土真实接触；少量受控碎屑；不堆全部参数 |
| 文字计划 | 若使用，只允许已确认英文事实并在生成后执行 OCR |
| 校验 | 无文字且其余完整可 PASS；存在图片文字时 PASS_WITH_POSTCHECK（OCR） |
15.2 “详情模块全选”14单元
| 单元 | 类型/内容 | V2-01 结果 |
|---|
| 01 | 商品主图 | PASS 或文字 OCR 后检 |
| 02 | 尺寸/容量/尺码图 | BLOCK：缺尺寸事实 |
| 03 | 1400W 卖点 | PASS |
| 04 | 三功能卖点 | PASS |
| 05 | 精钢夹头卖点 | PASS |
| 06 | 360°副手柄卖点 | PASS |
| 07 | 散热卖点 | PASS |
| 08 | 多材质应用卖点 | PASS |
| 09 | 商品细节图 | PASS |
| 10 | 效果对比图 | BLOCK：缺对照对象、条件和结果 |
| 11 | 使用场景图 | PASS |
| 12 | 多角度图 | PASS；图片推理模型正常生成，不增加专门人工核对门禁 |
| 13 | 场景氛围图 | PASS |
| 14 | 详细规格/参数表 | PASS_WITH_POSTCHECK：英文和数字 OCR |
端到端结果：预览阶段无 SuitePlan；最终点击生成后冻结14个单元；02和10不编译、不调用图片模型；其余12个单元形成逐图计划并可编译生成。多角度不因缺少对应角度参考而阻断或进入专门人工复核。
16. V2-02 稳定契约
| V2-02 必须消费 | 语义 |
|---|
selectedGenerationModelRef | 用户选择的图片生成模型 |
ProductInputSnapshotRef | 冻结商品输入 |
ImageTypeDefinitionRef | 当前图片类型定义版本 |
ResolvedRuleSnapshotRef | 只包含适用规则的不可变快照 |
SuitePlanRef | 套图时存在 |
ImageVisualPlanRef | 每个可执行单元或单图变体的计划 |
PhysicalRelationPlan[] | 安装、连接、朝向、起点、路径和作用对象的完整关系链 |
cameraFeasibilityPlan / scaleConstraints / functionalEffectConstraints | 相机可见性、比例和功能效果的结构化约束 |
PlanValidationResultRef | PASS/PASS_WITH_POSTCHECK/BLOCK |
CompiledPromptSnapshotRef | 已通过确定性编译的最终 Prompt |
V2-02 可决定 plannerKey 在上游后端填写还是规划服务内部计算，也可决定 Provider/API、参数映射、能力探测和错误适配；不得重新定义以下语义：
| 不得重定义项 | 冻结语义 |
|---|
| plannerKey | 用户和普通前端无选择权，系统按任务类型路由 |
| 图片模型 | 用户选择图片生成模型，但不能控制 Planner 策略 |
| 图片类型 | 购买决策目标、证据和字段消费固定在版本定义中 |
| 套图预览 | 不调用 Planner |
| 平台规则 | 未命中规则不进入 Planner |
| 单图数量 | generationCount=1–5，每个结果独立计划 |
| 校验 | BLOCK 不得调用图片模型；PASS_WITH_POSTCHECK 可生成 |
| 多角度 | 缺少对应角度参考不阻断、不增加专门人工核对门禁 |
| 编译完整性 | PhysicalRelationPlan 及相机/比例/效果字段不得被丢弃或泛化；能力不兼容时返回错误，不静默降级 |
| 失败处理 | 只返回具体不合格项；不自动重试、换模型、局部修复或产生付费调用 |
17. V2-03 稳定契约
| V2-03 必须消费 | 语义 |
|---|
| 冻结蓝图和执行单元 | 决定套图实际图片类型、数量和顺序 |
| 单图结果变体 | N个独立计划和执行 |
| SuitePlan/ImageVisualPlan | 任务历史可追溯 |
| 编译 Prompt 与图片模型 | 每次执行的固定输入 |
| 校验结果 | 决定可执行、需后检或阻断 |
| blockedUnitRefs | 只影响对应执行单元 |
V2-03 不得重定义图片类型证据消费、套图总导演边界、三种校验语义、历史快照不可覆盖、近重复只返回受影响结果问题，以及多角度无专门人工核对门禁。V2-03 自行决定批量任务、异步执行、终止、用户主动重新生成、交付状态、下载和 Listing 交接状态机，但不得增加 Planner 内置重试次数或自动付费调用。
17.1 Legacy 兼容边界
| 历史数据情况 | 兼容处理 | 禁止行为 |
|---|
v2.4 及以前只有 scene.productRelation 自然语言 | 原样只读展示并标记 legacy_without_physical_relation_plan | 不反推或伪造主体、载体、连接点、朝向、起点和路径 |
历史存在 physicalScalePlan | 保留原字段与快照；只有字段和值一一对应时才可在读取层映射为 scaleConstraints 展示 | 不把模糊“比例自然”升级为精确范围 |
历史 interactionAcceptanceChecks 只有商品身份/人体/动作等旧维度 | 原样保留，标记 legacy_validation_dimensions | 不宣称已完成八维后检，不回写历史结果 |
| 新任务依赖安装、连接或功能效果，但消费者仅支持旧 Schema | 返回 PLAN_CONTRACT_VERSION_UNSUPPORTED 并阻断调用 | 不删除新字段后继续编译，不用泛化自然语言降级 |
| 用户主动重新生成历史任务 | 读取用户确认后的当前输入，创建 v2.5 新任务和新快照；旧任务保持不变 | 不复用隐式 retryCount，不覆盖旧 Prompt 或结果 |
Legacy 兼容只保证历史可读和可追溯，不保证旧结果自动获得新契约的质量结论。
18. 与现有材料的差异分类
18.1 当前共享文档待由总控整合的表述
| 当前表述 | V2-01 冻结覆盖 |
|---|
ready / blocked / needs_review | 统一为 PASS/PASS_WITH_POSTCHECK/BLOCK |
| 多角度参考不足需人工核对、核对前不得交付 | 删除；正常使用图片推理模型和通用结果质量检查 |
| 多结果必须在规划阶段证明足够差异 | 规划尽量差异化，近重复主要由结果检查处理 |
| Shopee 示例把 Amazon 规则以反向禁止形式送入上下文 | 未命中平台规则不得进入 Planner |
| Shopee 示例引用旧规划规范 | 当前 V2-01 候选规范为 v2.5-candidate，后续由总控统一共享版本引用 |
PlannerRequest 示例含 plannerKey | 字段存在不等于普通前端可控；内部计算位置由 V2-02 决定 |
| 物理关系只写在 scene/action 自然语言 | 增加 PhysicalRelationPlan；安装、连接、朝向、作用起点、作用路径和作用对象必须结构化并由编译器完整传递 |
| 规划/结果失败可自动定向重试或局部修复 | 删除；只返回具体不合格项，用户主动重新生成创建新任务 |
18.2 本轮早期候选方案中已废弃的表述
| 已废弃候选 | 冻结结论 |
|---|
| 购买决策问题→图片角色→图片类型→执行单元的运行时四层识别 | 购买决策目标只在设计期固化到图片类型定义 |
| 套图预览先产生可能失效的候选计划 | 预览不调用 Planner，最终生成时才冻结和规划 |
| 缺对应角度参考直接阻断多角度 | 不阻断，使用图片推理模型正常生成 |
| 差异不足时限制用户生成数量 | 按用户 N 执行，近重复在结果阶段处理 |
18.3 一期代码迁移差异
| 一期事实 | V2-01 处理 |
|---|
| 注释9个接口，实际10个 | 以实际路由为准 |
n=1–10 | 新受控单图为1–5 |
| 主图默认白底 | 模板/命中平台规则决定 |
| 自动猜类目 | 无可靠匹配时跳过 |
| 自由中文参考角色 | 受控角色和版本引用 |
| 返回完整 Prompt | 普通运营不展示 |
19. 验收标准
| 编号 | 验收场景 | 预期结果 |
|---|
| AC01 | 同一图片类型重复执行 | 不重新识别购买决策角色 |
| AC02 | 套图预览 | 无 Planner 调用或计划记录 |
| AC03 | 最终确认套图 | 冻结输入、模板和蓝图后才规划 |
| AC04 | 总导演修改类型、数量、顺序或卖点绑定 | 计划拒绝，蓝图不变 |
| AC05 | 单图数量为1 | 只生成一个计划和子执行 |
| AC06 | 单图数量为5 | 生成5个独立计划，不预设固定第1～5张含义 |
| AC07 | 5张结果出现近重复 | 只返回重复结果的具体提示，不自动重跑；用户决定是否主动重新生成 |
| AC08 | 缺尺寸 | 只阻断尺寸单元 |
| AC09 | 缺比较依据 | 只阻断对比单元 |
| AC10 | 多角度缺少对应角度参考 | 正常规划生成，不触发阻断或专门人工核对 |
| AC11 | 目标用户为空 | Planner 不推测受众 |
| AC12 | 类目未可靠命中 | 不注入类目策略并留审计 |
| AC13 | Shopee Malaysia 任务 | Planner 不包含 Amazon 或其他未命中规则 |
| AC14 | 用户选择图片模型 | 下游收到模型引用；用户和前端不能指定 Planner |
| AC15 | Planner 引用不存在事实 | BLOCK，不进入编译 |
| AC16 | 文字计划存在 | 文字带事实引用并生成 OCR 检查 |
| AC17 | 历史模板、规则或定义升级 | 已提交任务继续引用原版本 |
| AC18 | 策略只通过静态 Schema | 继续保持 Candidate，不宣称生产通过 |
| AC19 | Shopee 电锤详情模块全选 | 12个单元可编译，尺寸和对比2个单元阻断 |
| AC20 | V2-02/V2-03 接入 | 下游消费契约，不重定义 V2-01 业务语义 |
| AC21 | 小型手持工具要求商品突出 | 通过构图和焦点突出；真实尺度来自证据，不能把商品放大成大型工具 |
| AC22 | 用户确认“成年手掌覆盖机身约 2/3” | 比例只进入当前 physicalScalePlan，替换商品后不得残留 |
| AC23 | 商品文字同时描述多种颜色或 4/5/7 件套，参考图只支持一个变体 | 只生成已解析变体，其他颜色和组件进入排除集合 |
| AC24 | 用户提供低桌茶席作为场景参考 | 当前任务优先消费低桌/茶席和操作方法，不复制参考人物与其他器具，也不写成全部茶具默认 |
| AC25 | 模特商品图包含双手交互 | 两只手分别输出 Gesture Plan；结果按商品身份、比例、安装、朝向、效果起点、效果路径、人物解剖和遮挡独立检查 |
| AC26 | 规划选择 POINT | 指根到指尖延长射线必须与目标区域相交；只靠近目标判定不通过，非指向型 fallback 只供用户主动新任务选择 |
| AC27 | Golden Case 文本扫描 | 固定 Planner 策略不得包含电磨、抹茶、日式茶桌、1400W、施工或任一案例专属比例/场景 |
| AC28 | 商品依赖支架安装或管线连接 | PhysicalRelationPlan 同时给出主体、载体、安装方式、双方连接点和朝向 |
| AC29 | 商品存在喷射、流动、切削、照明、加热或运动效果 | 明确效果起点、路径与作用对象；生成结果不得从错误区域出发或越过目标 |
| AC30 | 镜头遮挡关键安装点或效果起点 | 返回相机不可行的具体关系，不删除关系约束换取计划通过 |
| AC31 | 编译 PhysicalRelationPlan | 每个实体、连接点、轴线、方向、起点、路径、目标、阈值和禁止项完整保留，不压缩成泛化自然语言 |
| AC32 | 结果仅朝向和效果路径失败 | 只返回 ORIENTATION / EFFECT_PATH 问题；不自动重试、换模型、局部修复或付费调用 |
| AC33 | 扫描 Planner/校验 Schema | 不存在 retryPolicy / retryCount / fallbackProvider / autoRepair 或同义字段；用户重新生成产生新任务/新快照 |
20. 最终决策状态
| 决策 | 结果 |
|---|
| D01 · composite/free 边界 | Freddy 同意推荐方案 |
| D02 · 平台规则未命中 | Freddy 同意推荐方案 |
| D03 · ImageTypeDefinition 治理 | Freddy 同意推荐方案 |
| plannerKey 产品边界 | Freddy 已确认 |
| 多角度生成边界 | Freddy 已确认使用图片推理模型正常生成，无专门人工核对门禁 |
| 尺度与视觉突出边界 | Freddy 已确认商品按真实物理尺度表现；具体比例来自当前商品证据，不写成通用默认 |
| 跨品类污染边界 | Freddy 已确认生产设计遵循第一性原理；具体商品 Prompt 只作为当前任务编译结果和 Golden Case |
| 抹茶场景证据 | Freddy 已确认当前抹茶工具使用低矮木质日式茶桌/茶席；只在当前任务作用域消费 |
| PhysicalRelationPlan | Freddy 已确认增加通用物理关系对象，覆盖安装、连接、朝向、作用起点和作用路径 |
| 校验与重新生成 | Freddy 已确认结果只返回具体不合格项；不自动重试、换模型、局部修复或付费调用，重新生成由用户主动发起 |
| Schema 禁止字段 | Freddy 已确认不加入 retryPolicy / retryCount / fallbackProvider / autoRepair 或同义字段 |
| V2-01 产品待确认项 | 0 |
21. 生产门禁与下一步
| 项目 | 冻结要求 |
|---|
| 当前状态 | V2-01 产品语义已冻结，可作为 V2-02/V2-03 前置契约 |
| 已新增候选证据 | 电磨、抹茶两个 Session 内交互出图，以及侧边任务对安装、比例、手部与作用路径失败的反馈，支持新增结构化关系与八维后检；未形成受控 Provider/模型对照，不能计为真实 A/B |
| 仍未完成 | 真实 Planner 实现、Provider 适配、可复现实验数据集、同输入多模型 A/B、质量/成本/失败率验证 |
| 禁止事项 | 未完成真实 A/B 前不得宣称三类策略可切换生产，不得以静态 Schema 或示例替代真实质量证据 |
| 下游动作 | V2-02、V2-03 分别在本结论边界内完成技术与执行交付方案，不得重定义本文件冻结语义 |