--- name: links-reference-workflow description: 将授权产品、人物和场景素材整理为本地参考包,并用真实 inputs/bindings 与计划 continuity 约束跨镜头一致性。 --- 先读 [共用执行规则](../../resources/execution-rules.md)。参考包使用计划中的 production 步骤,经 `links_validate_generation_plan` 预检、`links_generate_media` 提交。 1. 用 `links_list_assets` 按 canvasId/cursor/limit 分页读取资产,核实参考授权、主体、造型版本与缺失视角。新增素材通过 `links_prepare_upload` 绑定同一 canvasId,再用 `links_complete_upload` 登记。不要从产品名推断不可见背面或包装文字。 2. 建立 subjects:id、label、kind(product/character/scene/prop)、variantId、sourceRefs、immutableFeatures(至少一条)、variableFeatures、missingViews;scenes 用 id、label、subjectIds。主体引用属于总 sourceRefs,ID 唯一,场景主体存在;缺失视角如实记录。 3. 加 production `reference_pack` 请求 `{mode,title,sourceRefs,subjects,scenes}`,静态参考只在 request.sourceRefs/sourceRef 声明,不设置 production step.inputs。固定槽 0 doc、1 text,模型费 0;它整理可审阅文档,不生成“已验证一致”的新视角。 ```json { "steps": [ { "id": "reference", "category": "production", "request": { "mode": "reference_pack", "title": "产品参考锁定表", "sourceRefs": ["asset:11"], "subjects": [{ "id": "product", "label": "主产品", "kind": "product", "variantId": "v1", "sourceRefs": ["asset:11"], "immutableFeatures": ["保持轮廓和品牌标识位置"], "variableFeatures": ["背景照明"], "missingViews": ["背面"] }], "scenes": [{ "id": "studio", "label": "摄影棚", "subjectIds": ["product"] }] } } ] } ``` 4. 示例 asset:11 仅表示运行前查询到的授权图像,必须用真实 ID 替换。跨镜头制作时,可在计划外层加以下 continuity;它与音乐广告请求内部 continuity 的 shape 不同。先从实时模型 schema 选择实际图像/视频步骤;下例 shot_front/shot_side 必须真的存在,两个步骤的 inputs 都带 assetId 11。shot_side 还需 dependsOn shot_front,并在实际模型字段放 image/video URL binding(例如 images[0] 或 frames[0].url),绑定 shot_front 的真实输出槽与 kind。不能把参考包 doc 槽当图像。 ```json { "continuity": { "version": 1, "subjects": [{ "id": "product", "label": "主产品", "kind": "product", "variantId": "v1", "sourceRefs": ["asset:11"], "immutableFeatures": ["保持轮廓和品牌标识位置"], "variableFeatures": ["背景照明"], "missingViews": ["背面"] }], "scenes": [{ "id": "studio", "label": "摄影棚", "subjectIds": ["product"] }], "shots": [ { "stepId": "shot_front", "sceneId": "studio", "variants": { "product": "v1" } }, { "stepId": "shot_side", "sceneId": "studio", "variants": { "product": "v1" } } ], "viewDependencies": [{ "stepId": "shot_side", "sourceStepId": "shot_front" }] } } ``` 5. 每个图像/视频生成步骤都有对应 shot;subject 的每个静态引用都存在于该步骤 inputs,上游参考使用真实 bindings。viewDependencies 声明不代替 binding;immutableFeatures 文字不代替参考素材。造型版本变化应更新计划和参考,不能一边写 v1 一边换外观。 6. `links_validate_generation_plan` 冻结引用、依赖和约束,`links_generate_media` 提交后用 `links_get_job` 查询真实状态,复用成功步骤。交付参考包 doc/text、缺失视角、连续性声明及实际媒体引用,按证据分别报告产品身份与视觉检查;文字约束或技术成功不能作为一致性 passed。 7. 若接预演,白模非产品拟真,当前任务 Blender 渲染须独立验收;程序合成音非 ZenPiano,节拍估计非语义乐句;公开分发/native Codex 未验。LibTV 仅比较,不运行其脚本。