@xiaohhhh1/canvas-agent 0.4.72 → 0.4.74

package/agent-instructions.md

@@ -17,11 +17,14 @@
 - 用户要求打开带货任务时，调用 `open_flow_c_website`，不要输出或询问 Local URL、连接令牌。
 - 网站把脚本任务交给本机 Codex 后，使用 `flow_c_get_script_task` 读取完整、服务器持久化的任务，再用 `flow_c_submit_script_chunk` 每次回传 1–30 条。不要要求用户复制 JSON、选择交接文件或把短期令牌发到聊天中。
 - 大批量脚本按本机助手指定的序号分段创作；批量大小不能成为降低质量、缩短脚本或套用模板的理由。每条都必须独立构思、符合目标市场自然语言习惯、保持紧凑但清晰可说完的 10 秒节奏。
+- 三种制作方式 `storyboard`、`visual-storyboard`、`first-frame-chain` 共用完全相同、与媒体模式无关的脚本层：同一套爆款蓝图/带货形式库选择、商品适配、目标地区当地化、口播、完整脚本和局部 0–10 秒段。制作方式及分镜布局不得进入脚本创作提示，不得据此重写、过滤、重选或简化脚本。
 - 10 秒仍走原有单段结构。只有任务明确给出 20 或 30 秒时，才先写一份完整总脚本，再拆成 2 或 3 个各自从 0–10 秒计时、可独立生成的段落；同人物同场景用 `continue` 并固定人物、服装、音色身份、场景、光线与商品状态，明确换人物或场景才用 `reset`。音色身份需详细到年龄、音高、音质、语速、口音、停连和说话习惯，情绪随剧情变化，整体仍保持快节奏。
 - 写脚本和回传草案不创建付费任务。只有客户在网站审阅并确认费用后，中心服务才可开始故事板和视频生成。
 
 - 用户明确选择流程 C 时，必须新建独立画布、清单和归档目录，不得混用流程 A 或 B 的资产。
-- 先使用原始同 SKU 商品图和完整脚本生成 9:16、10 秒导演分镜板；每镜必须包含时长、画面/镜头、对应配音、音效/BGM 节奏和情绪，并附专业技术规格栏。
+- 脚本定稿后才按已持久化制作方式分流媒体控制：`storyboard` 使用同一局部脚本和原始同 SKU 商品图生成 9:16 `director-table-scripted-v1` 导演总表；`first-frame-chain` 使用同一局部脚本生成干净 9:16 首帧，并按既有首帧/尾帧连续控制执行。
+- 新 `visual-storyboard` 使用同一局部脚本和原始同 SKU 商品图生成原生横向 16:9 `visual-storyboard-landscape-v2` 纯视觉分镜图。镜头按时间行优先排列（从左到右，再到下一排）：1–4 镜单排；5–8 镜为 3+2、3+3、4+3、4+4 的平衡两排。每排铺满且每格都是真实镜头，不得添加空白、占位格、连续性小块、元数据栏、技术块、脚本、标签、时间码或字幕；镜头景别、镜头、运镜、动作和切点保持原脚本不变，关键内容放在竖屏安全核心。已持久化 `visual-storyboard-adaptive-v1` 仍按原 9:16 历史合同恢复，不得升级或重解释为 v2。
+- Omni 成片在三种制作方式下始终是单一全屏竖向 9:16。纯视觉 v2 按同一行优先顺序把横板每格重建为完整动态镜头，禁止把横板、网格、接缝、边框、空白、分屏、画中画、联系表或幻灯片渲染进成片；20/30 秒仍逐段生成后只做 stream-copy 无损拼接。
 - 原始商品图是唯一商品标准：每一格都必须保持颜色、外形、文字或 Logo、比例、部件和数量一致。分镜通过逐格检查前，严禁提交视频任务。
-- 视频阶段必须同时提供已通过的分镜板和原始商品图。技术失败、超时、明显商品不一致或明显分镜错误时自动重做；提示词、参考图或平台合规问题才暂停等待用户修改。
+- 视频阶段必须按已持久化制作方式提供控制图和原始商品图：导演总表与纯视觉分镜图固定为 `[当前故事板, ...原商品图]`；首帧模式沿用其首帧/尾帧引用合同。技术失败、超时、明显商品不一致或明显分镜错误时按中心既有有界策略处理；提示词、参考图或平台合规问题才暂停等待用户修改。
 - 未配置流程 C 的第三方视频接口时，只能完成分镜准备和验收，明确说明“待管理员配置视频接口”，不得假装已提交或产生扣费。

package/dist/workflow/manager.d.ts

@@ -54,7 +54,7 @@ type ReferenceStyleCard = {
         categories?: unknown;
     };
 };
-type StoryboardLayoutVersion = "director-table-scripted-v1" | "visual-storyboard-adaptive-v1" | "hybrid-three-anchor-v1" | "legacy-five-row-v1";
+type StoryboardLayoutVersion = "director-table-scripted-v1" | "visual-storyboard-landscape-v2" | "visual-storyboard-adaptive-v1" | "hybrid-three-anchor-v1" | "legacy-five-row-v1";
 type FlowCProductionMode = "storyboard" | "visual-storyboard" | "first-frame-chain";
 type ProductInput = {
     productIndex: number;

package/dist/workflow/manager.js

@@ -958,11 +958,11 @@ ${compactJson(selectedBlueprintPromptPayload([...selected.values()], duration),
 ${rewriteInstruction}
 ${durationRules}
 写作要求：
-1. visualHook、conflict、escalation/turn、productIntervention、visibleProof、purchaseReason、callbackMotivation 与所有 shots 必须执行选中卡的 visualPremise、firstFrame、spectacleEscalation、productProofAction、purchaseReason、truthBoundary 以及七项视觉执行字段；保留所选蓝图的因果时间线、节拍比例、镜头/剪辑节奏、动作压力、证明方式和购买逻辑，只替换当前商品、人物、场景与当地口播槽位，不得稀释构图或换成普通模板。爆款来源的旧商品身份/动作必须替换；形式卡只提供抽象创意结构，绝不能反向改变现有首帧、分段、Omni或参考图制作方式。若 productAdaptation.templateMatch.actionCompatibility 的 openingAction、proofAction 或 spectacleAction 为 false，对应 productAdaptation 的 firstFrame、productProofAction 或 spectacleEscalation 对商品动作内容具有绝对优先级，必须删除其旧商品动作，不得折中混用。productProofAction 必须同时写清一个真实动作及其镜头内可见结果；purchaseReason 只解释该结果为何值得目标用户购买，不能变成泛泛 CTA。
+1. visualHook、conflict、escalation/turn、productIntervention、visibleProof、purchaseReason、callbackMotivation 与所有 shots 必须执行选中卡的 visualPremise、firstFrame、spectacleEscalation、productProofAction、purchaseReason、truthBoundary 以及七项视觉执行字段；保留所选蓝图的因果时间线、节拍比例、镜头/剪辑节奏、动作压力、证明方式和购买逻辑，只替换当前商品、人物、场景与当地口播槽位，不得稀释构图或换成普通模板。爆款来源的旧商品身份/动作必须替换；形式卡只提供抽象创意结构，绝不能反向改变现有首帧、分段、Omni或参考图制作方式。形式库中的工厂、仓库、街访、使用者体验、主理人、探店、补货、对比、促销和耐用形式都可以用 AI 人物与场景正常演绎；缺少现实素材或事实证据不是脚本失败条件，必须按 executionBlueprint.executionAdaptation 保留所选形式，同时不把演绎的角色、地点、订单、库存、销量、价格、身份或经历写成已核验的现实事实。若 productAdaptation.templateMatch.actionCompatibility 的 openingAction、proofAction 或 spectacleAction 为 false，对应 productAdaptation 的 firstFrame、productProofAction 或 spectacleEscalation 对商品动作内容具有绝对优先级，必须删除其旧商品动作，不得折中混用。productProofAction 必须同时写清一个商品图或执行档案能支持的可见动作及其镜头内可见结果；purchaseReason 只解释该结果为何值得目标用户购买，不能变成泛泛 CTA。
 2. 严格执行 executionBlueprints 中的 sourceDurationSeconds → targetDurationSeconds 和 retimingMode：expand 只增加有用的证明停留、使用语境与购买理由，compress 只压缩重复、冗余铺垫和转场，same 保持原节拍比例；三种模式都必须保留 Hook、证明和购买因果，禁止整体拉伸、截断或机械加速。
 3. 每条生成一份稳定 voiceProfile；每段只写简短 voiceCue。口播必须使用${targetVoiceLanguage}，并执行 creatorVoiceStyle/ctaStyle；未提供 creatorVoiceStyle 时使用当地 TikTok 带货创作者真实会说的口吻。不是逐字翻译，整条内容按 Hook → Body/visible proof → Close 组织，短句口语化且与当前镜头可见动作同步，结尾只给一个简短自然 CTA。只使用少量可信的 localSceneProfile/audienceContext 日常细节；presenterContext 没填写时使用普通创作者，不得把国家代码、语言或地区自动等同于人物族群。商品事实没有提供时不得编造价格、折扣、销量、库存或稀缺性。商品标题只用于理解商品类型与事实，所有输出不得主动写出或念出品牌名、品牌广告语、包装文案，也不得要求模型把品牌字样变得更清晰；商品外观与已有标识的位置、比例、颜色和版式只服从第1张产品参考图。TikTok/TikTok Shop 只用于定义这条写作规则，不得把平台名写入 voiceover、onScreenText、visual、soundBgm、emotionalNote、openingState、endingState 或任何会进入故事板/视频的导演字段。导演说明统一用简洁制作英文；这里只做写作指令，不做语言检测字段。
 4. 每段永远是独立 0–10 秒，含 1–8 个按剧情需要决定的 shots、准确 voiceover、onScreenText、evidence、soundBgm、emotionalNote 与 endingState；模型不要输出 continuity 或 continuityMode。
-5. shot.visual 要直接写出主体位置、景别、光线、材质、动作峰值和当地自然环境，并保留真实皮肤、细发、布料/商品微纹理和实景混合光；禁止塑料蜡感、静态举产品、品牌广告片、电视购物或伪造工厂/销量/来源。
+5. shot.visual 要直接写出主体位置、景别、光线、材质、动作峰值和当地自然环境，并保留真实皮肤、细发、布料/商品微纹理和实景混合光；禁止塑料蜡感、静态举产品、品牌广告片或电视购物。允许执行所选形式的 AI 工厂/仓库/零售/人物场景，但不得声称它们是该商家真实工厂、产地、生产档案、订单、库存、销量、实名客户证言或线下价格。
 6. 20/30 秒的后一段剧情承接前段 endingState，但每段仍只使用自己的局部 0–10 秒执行内容。
 7. 不要输出 creativePlan、executionBindings 或 masterScript；这些字段由 Agent 从选中蓝图确定性回填/合成，避免重复 token 和脆弱的文字绑定校验。若 selectionMode=user-framework，用户原框架的开头、事件顺序、核心剧情和结尾仍是最高权威。
 8. 商品身份以按顺序提供的原商品图为最高权威：第1张是主SKU身份图，当前商品标题和大概类目只补充商品用途与事实，后续图片只是同一SKU补充视角。任何爆款源商品、首帧、故事板或上一段尾帧都不得改变商品颜色、款式、结构、比例、材质、包装、标识位置、部件、配件和实际套装数量；修正身份时不得降低动作、运镜、节奏、景深、真实感或画质。商品本体或包装表面的印花、图案、微纹理、已印文字/字符、图标、色块、行距、相对位置和朝向全部视为不可编辑的原图纹理；不得在 shot.visual、onScreenText、voiceover、evidence、openingState、endingState 或任何导演字段中要求重写、翻译、替换、删改、重排、镜像这些表面内容，也不得要求生成“另一段清晰可读文案”。新增屏幕字只能是与商品像素分离的场景叠加字幕，绝不能印到商品或包装上。旋转、翻转、弯折或开合商品时，完整表面纹理必须随实体整体运动，不能漂移、翻面后复写或重新生成。若 executionBlueprint 或 productAdaptation 与本规则冲突，只保留其钩子、动作因果和镜头节奏，改写构图、机位或表演，绝不改商品表面。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaohhhh1/canvas-agent",
-  "version": "0.4.72",
+  "version": "0.4.74",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",