@xiaohhhh1/canvas-agent 0.4.76 → 0.4.77

package/dist/workflow/content-method.d.ts

@@ -0,0 +1,40 @@
+export declare const FLOW_C_CONTENT_STRATEGY_VERSION = "flow-c-content-strategy-v1";
+export type FlowCContentStrategy = {
+    contractVersion: typeof FLOW_C_CONTENT_STRATEGY_VERSION;
+    mode: "smart-diverse" | "best-match";
+    seed: string;
+};
+export type FlowCContentDirection = {
+    contractVersion: typeof FLOW_C_CONTENT_STRATEGY_VERSION;
+    mode: FlowCContentStrategy["mode"];
+    directionKey: string;
+    intentLabel: string;
+    brief: string;
+    selectionReason: string;
+    variationSeed: string;
+    recentAvoidance?: {
+        sameProductSelections: number;
+        matchedDirectionUses: number;
+        policy: "soft-penalty-only";
+    };
+};
+export type FlowCContentSummary = {
+    ordinal: number;
+    productIndex: number;
+    opening: string;
+    proof: string;
+    voiceover: string;
+};
+/** Missing/unknown versions keep historical tasks on their exact original prompt. */
+export declare function flowCContentStrategy(value: unknown): FlowCContentStrategy | null;
+export declare function flowCContentDirection(value: unknown, strategy: FlowCContentStrategy | null): FlowCContentDirection | null;
+/** Summarize actual rendered output, never the seed-labelled candidate fingerprint. */
+export declare function summarizeFlowCContentJob(value: unknown): FlowCContentSummary | null;
+/** Only centrally acknowledged ordinals are durable avoidance evidence. */
+export declare function mergeFlowCContentSummaries(values: unknown, jobs: unknown, acceptedOrdinals: readonly number[]): FlowCContentSummary[];
+export declare function flowCContentMethodPrompt(strategy: FlowCContentStrategy | null, options: {
+    recentScripts?: unknown;
+    productIndexes: number[];
+    ordinals: number[];
+    frameworkOrdinals: number[];
+}): string;

package/dist/workflow/content-method.js

@@ -0,0 +1,85 @@
+export const FLOW_C_CONTENT_STRATEGY_VERSION = "flow-c-content-strategy-v1";
+function object(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function text(value, limit) {
+    return String(value ?? "").normalize("NFKC").trim().replace(/\s+/g, " ").slice(0, limit);
+}
+function summaryText(value, limit) {
+    return text(typeof value === "string" ? value.replace(/https?:\/\/\S+|data:\S+/gi, "[link]") : "", limit);
+}
+/** Missing/unknown versions keep historical tasks on their exact original prompt. */
+export function flowCContentStrategy(value) {
+    const input = object(value);
+    if (input.contractVersion !== FLOW_C_CONTENT_STRATEGY_VERSION || (input.mode !== "smart-diverse" && input.mode !== "best-match"))
+        return null;
+    const seed = text(input.seed, 1000);
+    return seed ? { contractVersion: FLOW_C_CONTENT_STRATEGY_VERSION, mode: input.mode, seed } : null;
+}
+export function flowCContentDirection(value, strategy) {
+    const input = object(value);
+    if (!strategy || input.contractVersion !== strategy.contractVersion || input.mode !== strategy.mode)
+        return null;
+    const directionKey = text(input.directionKey, 100);
+    const variationSeed = text(input.variationSeed, 100);
+    if (!/^flow-c-direction:[a-f0-9]{32}$/.test(directionKey) || !/^[a-f0-9]{24}$/.test(variationSeed))
+        return null;
+    const avoidance = object(input.recentAvoidance);
+    const count = (value) => Math.min(1000, Math.max(0, Math.floor(Number(value) || 0)));
+    const recentAvoidance = input.recentAvoidance && typeof input.recentAvoidance === "object" && !Array.isArray(input.recentAvoidance)
+        ? { sameProductSelections: count(avoidance.sameProductSelections), matchedDirectionUses: count(avoidance.matchedDirectionUses), policy: "soft-penalty-only" }
+        : undefined;
+    return {
+        contractVersion: strategy.contractVersion,
+        mode: strategy.mode,
+        directionKey,
+        intentLabel: text(input.intentLabel, 120),
+        brief: text(input.brief, 2400),
+        selectionReason: text(input.selectionReason, 700),
+        variationSeed,
+        ...(recentAvoidance ? { recentAvoidance } : {}),
+    };
+}
+function summary(value) {
+    const input = object(value);
+    if (!Number.isInteger(input.ordinal) || Number(input.ordinal) < 1 || !Number.isInteger(input.productIndex) || Number(input.productIndex) < 0)
+        return null;
+    const result = { ordinal: Number(input.ordinal), productIndex: Number(input.productIndex), opening: summaryText(input.opening, 240), proof: summaryText(input.proof, 240), voiceover: summaryText(input.voiceover, 160) };
+    return result.opening || result.proof || result.voiceover ? result : null;
+}
+/** Summarize actual rendered output, never the seed-labelled candidate fingerprint. */
+export function summarizeFlowCContentJob(value) {
+    const job = object(value);
+    const script = typeof job.script === "string" ? job.script : "";
+    const fields = (name) => [...script.matchAll(new RegExp(`(?:^|\\|)\\s*${name}:\\s*([^|\\r\\n]*)`, "gm"))]
+        .map((match) => match[1].trim()).filter((item) => item && !/^(?:none|无|sin voz|sin diálogo)$/i.test(item));
+    return summary({ ordinal: job.ordinal, productIndex: job.productIndex, opening: fields("VISUAL")[0], proof: fields("EVIDENCE").slice(0, 3).join("; "), voiceover: fields("VO")[0] });
+}
+/** Only centrally acknowledged ordinals are durable avoidance evidence. */
+export function mergeFlowCContentSummaries(values, jobs, acceptedOrdinals) {
+    const accepted = new Set(acceptedOrdinals);
+    const result = new Map();
+    for (const item of [...(Array.isArray(values) ? values.map(summary) : []), ...(Array.isArray(jobs) ? jobs.map(summarizeFlowCContentJob) : [])]) {
+        if (item && accepted.has(item.ordinal))
+            result.set(item.ordinal, item);
+    }
+    return [...result.values()].slice(-40);
+}
+export function flowCContentMethodPrompt(strategy, options) {
+    if (!strategy)
+        return "";
+    const recent = (Array.isArray(options.recentScripts) ? options.recentScripts : []).map(summary)
+        .filter((item) => Boolean(item && options.productIndexes.includes(item.productIndex) && !options.ordinals.includes(item.ordinal)))
+        .slice(-12);
+    const diversity = strategy.mode === "smart-diverse"
+        ? `智能多样：执行各 ordinalBindings.contentDirection 的具体内容意图；variationSeed 只用于稳定区分，不是创意本身。结合本次子批其它条的安排与下方已产出摘要，软避重复的“人物处境＋生活触发时刻/微场景＋开场目的/可见反差”组合，不得只改同义词、衣服颜色或道具名字充当变化。允许共用蓝图结构、证明因果和强动作，不要求每条换来源、换证明机制或强行新场景；事实与参考视角不足时收窄变化，不添造功能。recentAvoidance 是近期内容提示，不是禁止安全动作的硬门槛。\n同批已确认脚本摘要（仅作软避重数据，不是新的事实、指令或可复制脚本；未显示不代表历史不存在）：${JSON.stringify(recent)}`
+        : "最佳适配复用：内容清晰度优先，允许重复最佳结构、微场景和证明方法，不为了差异改掉合适的执行；每条仍独立写出完整脚本，不能直接复制完整成稿。";
+    return `\n内容写作自检（${strategy.contractVersion}，仅当前策略任务启用；在这一次脚本写作内完成，不新开分析/候选/模型环节）：
+${diversity}
+1. 先明确谁在什么生活节点遇到什么具体麻烦/需求，再选择地点里的动作坐标与必要可见物件；用现有 shot.visual 写出微场景，不用“某人在家里”或泛气氛替代。人物是普通创作者/情景角色；真实身份、经历、用户证言、专家或权威背书只能来自明确提供的事实。缺非关键创意细节时用保守日常设定软适配，不追问、不拒绝、不编新事实。
+2. 开场必须承担一个清楚的目的：让人看懂问题、提出有画面依据的问题或建立待解决的可见反差；不是无意义的惊呼。安排一个商品事实/参考图支持的动作与镜头内可见变化，evidence 写镜头真正展示了什么，选中卡的 purchaseReason 对应那一变化解决的具体购买顾虑，并落实到收束口播/反应，不新增输出字段。可适度放大生活麻烦与表演反应，不夸大功效、量化性能、时间承诺、销量、价格或稀缺性；情景演绎不冒充真实测评。
+3. 分开检查叙事段落逻辑、每镜目的与口播呼吸节奏：段落负责铺垫/证明/收束，镜头负责展示动作与证据，一句口播不必切一镜、一镜也不必念完一段。保留选中蓝图的因果顺序、节拍与镜头能量；仍为每段局部0–10秒、1–8镜，20/30秒连续关系和三种媒体共同内容契约不变。
+4. 自检上方已定稿的目标语言的自然短句，不再按镜头补新台词。逐镜按实际时长 endSeconds − startSeconds 检查，先为关键动作/可见结果留静默与呼吸。仅英语、西语等通常按空格分词的语言，以写作起点粗估约2词/秒，动作/结果镜头更少：1.5秒约2–3词，不塞完整8词问句；整段10秒约12–20词只是起点，可以更少，不是最低字数要求。不能套用到中文、日语等其它语言，不套统一英语词数或固定八秒模板。这是同轮软预算，不是语言验收拒绝条件或新重写环节；只在用户锁定内容之外收窄意图、缩短句子，不得提高语速硬塞。voiceProfile.speakingRate/pauseHabit 与 voiceCue 要符合实际可说完的语速，不得标成 unhurried/慢速却塞满台词；emotionalNote 只写镜头目的/情绪转折。不输出计算、推理或预算报告。
+5. contentDirection 只细化既有蓝图可替换的人物、微场景、措辞和执行槽位，不改变商品身份、纹理文字、能力证据、0–10秒分段或媒体制作方式。creativeBrief 始终最高优先；用户框架 ordinal ${JSON.stringify(options.frameworkOrdinals)} 的开头、事件顺序、核心剧情和结尾不可被方向卡/避重覆盖，只能在其留白处具体化。
+返回前按以上内容要求自检，修正能在本次写作中修正的空泛描述。自检不是新验收闸门；只输出原严格 schema 的既有字段，不输出推理、自检报告、contentDirection 或其它新增字段。\n`;
+}

package/dist/workflow/manager.d.ts

@@ -2,6 +2,7 @@ import type { AgentEmit } from "../agent/types.js";
 import { type CanvasAgentConfig } from "../config.js";
 import { type FlowCProductExecutionProfile } from "./product-profile.js";
 import { type CommerceRequestDiagnostic } from "./commerce-http.js";
+import { type FlowCContentStrategy, type FlowCContentSummary } from "./content-method.js";
 export declare const FLOW_C_CODEX_TURN_TIMEOUT_MS: number;
 export declare const FLOW_C_SELECTED_BLUEPRINT_PROMPT_MAX_CHARS = 36000;
 export declare const FLOW_C_SCRIPT_REWRITE_MAX_ATTEMPTS = 2;
@@ -26,6 +27,8 @@ type ScriptRecord = {
     activeChunks?: number;
     productProfiles?: FlowCProductExecutionProfile[];
     pendingScriptJobs?: DraftJob[];
+    contentStrategy?: FlowCContentStrategy;
+    contentSummaries?: FlowCContentSummary[];
     lastFailure?: CommerceRequestDiagnostic;
     retryRequested?: boolean;
     priorityAt?: string;
@@ -78,6 +81,7 @@ type SelectedCandidate = {
     ordinal: number;
     productIndex: number;
     candidateRevision?: string;
+    contentDirection?: unknown;
     scriptSource?: string;
     creativeSource?: string;
     sellingFormCardId?: string | null;
@@ -122,6 +126,8 @@ type ScriptTask = {
     market: string;
     target_language?: string | null;
     localization?: Record<string, unknown>;
+    creative_strategy?: unknown;
+    content_recent_scripts?: FlowCContentSummary[];
     script_source_default?: string;
     duration_seconds?: 10 | 20 | 30;
     script_output_contract_version?: string;
@@ -271,6 +277,7 @@ export declare class WorkflowManager {
         }[];
     };
     health(): {
+        contentStrategyVersion: string;
         activeScriptHandoffIds: string[];
         activeScripts: number;
         scriptConcurrencyLimit: number;
@@ -404,7 +411,7 @@ export declare function isFlowCPromptPayloadTooLarge(error: unknown): error is E
 export declare function productExecutionProfilePrompt(product: ProductInput, contractVersion?: string): string;
 export declare function scriptChunkPrompt(id: string, task: ScriptTask, ordinals: number[], rewriteAttempt?: number): string;
 export declare function creativeCandidatePrompt(id: string, task: ScriptTask, ordinals: number[]): string;
-export declare function selectedBlueprintPromptPayload(values: SelectedCandidate[], fallbackTargetDurationSeconds?: number): {
+export declare function selectedBlueprintPromptPayload(values: SelectedCandidate[], fallbackTargetDurationSeconds?: number, contentStrategy?: FlowCContentStrategy | null): {
     executionBlueprints: {
         blueprintRef: string;
         executionBlueprint: string;
@@ -414,6 +421,7 @@ export declare function selectedBlueprintPromptPayload(values: SelectedCandidate
     }[];
     productAdaptations: Record<string, unknown>[];
     ordinalBindings: {
+        contentDirection?: import("./content-method.js").FlowCContentDirection | undefined;
         ordinal: number;
         productIndex: number;
         blueprintRef: string | null;
@@ -421,6 +429,49 @@ export declare function selectedBlueprintPromptPayload(values: SelectedCandidate
         variationSeed: string;
     }[];
 };
+export declare function selectedCandidatePlan(value: SelectedCandidate | undefined, contentStrategy?: FlowCContentStrategy | null): {
+    contentDirection?: import("./content-method.js").FlowCContentDirection | undefined;
+    visualPremise: string;
+    learnedTemplateId: string | null;
+    learnedTemplateSource: Record<string, unknown> | null;
+    scriptSource: string | null;
+    sellingFormCardId: string | null;
+    sellingFormName: string | null;
+    sellingFormSelectionReason: string | null;
+    sellingFormLibraryVersion: string | null;
+    sellingFormSelectionVersion: string | null;
+    productIdentityProfile: Record<string, unknown>;
+    productExecutionProfileRef: string;
+    mutationAxes: string[];
+    culturalAnchors: Record<string, unknown>[];
+    spectacleEscalation: string;
+    productProofAction: string;
+    purchaseReason: string;
+    truthBoundary: string;
+    riskFlags: string[];
+    firstFrame: string;
+    visualHook: string;
+    conflict: string;
+    escalation: string;
+    turn: string;
+    productIntervention: string;
+    visibleProof: string;
+    callbackMotivation: string;
+    differentiationKey: string | undefined;
+    firstFrameFocus: string;
+    visualContrast: string;
+    sensoryTexture: string;
+    motionPeak: string;
+    compositionLighting: string;
+    localNativeDetail: string;
+    antiFlatness: string;
+    creativeFingerprint: Record<string, string>;
+    fingerprintKey: string | undefined;
+    selectionScore: number | undefined;
+    selectionBreakdown: Record<string, unknown> | undefined;
+    selectionMode: string | undefined;
+    visualExecutionVersion: string;
+};
 /**
  * 已选创意永远优先进入脚本扩写；只有当前没有可写脚本时才生成下一小波候选。
  * 每次最多占用受控 worker 数量的子批，避免把整批候选提前塞满 worker 队列。

package/dist/workflow/manager.js

@@ -14,6 +14,7 @@ import { FLOW_C_CREATIVE_CANDIDATE_CONTRACT_VERSION, flowCCreativeCandidateOutpu
 import { FLOW_C_LEGACY_PRODUCT_EXECUTION_PROFILE_CONTRACT_VERSION, FLOW_C_PRODUCT_EXECUTION_PROFILE_CONTRACT_VERSION, flowCProductExecutionProfileOutputSchema, parseFlowCProductExecutionProfileOutput } from "./product-profile.js";
 import { flowCScriptOutputSchema, parseFlowCScriptOutput } from "./script-output.js";
 import { commerceJson, CommerceRequestError } from "./commerce-http.js";
+import { FLOW_C_CONTENT_STRATEGY_VERSION, flowCContentDirection, flowCContentMethodPrompt, flowCContentStrategy, mergeFlowCContentSummaries } from "./content-method.js";
 const STATE_FILE = path.join(CONFIG_DIR, "workflow-state.json");
 export const FLOW_C_CODEX_TURN_TIMEOUT_MS = 8 * 60 * 1000;
 export const FLOW_C_SELECTED_BLUEPRINT_PROMPT_MAX_CHARS = 36_000;
@@ -115,6 +116,12 @@ export class WorkflowManager {
         record.receivedOrdinals = [...new Set([...record.receivedOrdinals, ...task.received_ordinals.map(Number).filter(Number.isInteger)])].sort((left, right) => left - right);
         task.received_ordinals = record.receivedOrdinals;
         record.productProfiles = mergeProductProfiles(record.productProfiles, task.product_execution_profiles);
+        const contentStrategy = flowCContentStrategy(task.creative_strategy);
+        if (contentStrategy) {
+            record.contentStrategy = contentStrategy;
+            record.contentSummaries = mergeFlowCContentSummaries([...(record.contentSummaries || []), ...(Array.isArray(task.content_recent_scripts) ? task.content_recent_scripts : [])], record.pendingScriptJobs, record.receivedOrdinals);
+            task.content_recent_scripts = record.contentSummaries;
+        }
         record.pendingScriptJobs = (record.pendingScriptJobs || []).filter((job) => !record.receivedOrdinals.includes(job.ordinal));
         record.expiresAt = task.expires_at;
         record.updatedAt = now();
@@ -144,6 +151,8 @@ export class WorkflowManager {
             record.receivedOrdinals = [...accepted].sort((a, b) => a - b);
         }
         record.requestedCount = Number(data.requestedCount || record.requestedCount);
+        if (flowCContentStrategy(record.contentStrategy))
+            record.contentSummaries = mergeFlowCContentSummaries(record.contentSummaries, jobs, record.receivedOrdinals);
         record.pendingScriptJobs = (record.pendingScriptJobs || []).filter((job) => !record.receivedOrdinals.includes(job.ordinal));
         record.status = data.status === "ready" ? "complete" : "running";
         record.message = data.status === "ready" ? `全部 ${record.requestedCount} 条高质量脚本已回传` : `已回传 ${data.received}/${data.requestedCount} 条脚本`;
@@ -182,6 +191,7 @@ export class WorkflowManager {
         const records = Object.values(this.state.scripts);
         const workers = flowCCodexWorkerStatus();
         return {
+            contentStrategyVersion: FLOW_C_CONTENT_STRATEGY_VERSION,
             activeScriptHandoffIds: [...this.runningScripts],
             activeScripts: workers.active,
             scriptConcurrencyLimit: workers.limit,
@@ -611,7 +621,10 @@ export class WorkflowManager {
             const durationSeconds = Number(task.duration_seconds || 10);
             let prompt;
             try {
-                prompt = scriptChunkPrompt(id, task, ordinals, rewriteAttempt);
+                const promptTask = flowCContentStrategy(task.creative_strategy)
+                    ? { ...task, received_ordinals: record.receivedOrdinals, content_recent_scripts: mergeFlowCContentSummaries([...(Array.isArray(task.content_recent_scripts) ? task.content_recent_scripts : []), ...(record.contentSummaries || [])], [], record.receivedOrdinals) }
+                    : task;
+                prompt = scriptChunkPrompt(id, promptTask, ordinals, rewriteAttempt);
             }
             catch (error) {
                 if (isFlowCPromptPayloadTooLarge(error))
@@ -640,7 +653,7 @@ export class WorkflowManager {
                 ...job,
                 sellingFormId: selected.get(job.ordinal)?.sellingFormCardId || job.sellingFormId,
                 expectedCandidateRevision: selected.get(job.ordinal)?.candidateRevision,
-                creativePlan: { ...(job.creativePlan || {}), ...selectedCandidatePlan(selected.get(job.ordinal)) },
+                creativePlan: { ...(job.creativePlan || {}), ...selectedCandidatePlan(selected.get(job.ordinal), flowCContentStrategy(task.creative_strategy)) },
             }));
             this.emitScriptStage(id, ordinals, "parse", Date.now() - parseStartedAt);
             const persistStartedAt = Date.now();
@@ -1060,22 +1073,29 @@ export function scriptChunkPrompt(id, task, ordinals, rewriteAttempt = 0) {
         : "";
     const localization = compactTaskLocalization(task);
     const targetVoiceLanguage = String(localization.targetLanguage || task.target_language || localization.targetLocale || "").trim() || `目标市场 ${task.market} 的自然当地语言`;
+    const contentStrategy = flowCContentStrategy(task.creative_strategy);
+    const contentMethod = flowCContentMethodPrompt(contentStrategy, {
+        recentScripts: mergeFlowCContentSummaries(task.content_recent_scripts, [], task.received_ordinals),
+        productIndexes: products.map((product) => product.productIndex),
+        ordinals,
+        frameworkOrdinals: [...selected.values()].filter((candidate) => candidate.selectionMode === "user-framework").map((candidate) => candidate.ordinal),
+    });
     return `你正在后台完成 Flow C 脚本交接 ${id}，只写 ordinal：${ordinals.join(", ")}；映射：${scriptProductAssignments(task.product_quantities, ordinals)}。
 目标市场：${task.market}。目标口播语言：${targetVoiceLanguage}。结构化当地化事实（国家、语言/locale、出镜者、受众、生活场景、创作者口吻和CTA彼此独立；不得从国家推断族群）：${compactJson(localization, 3_000, "当前脚本子批的当地化事实")}。商品事实：${compactJson(productFacts, 12_000, "当前脚本子批的商品事实")}
-中心已完成当前 ordinal 的创意选择。executionBlueprints 只保存一次共享的模型无关创意蓝图（可能来自已学习爆款，也可能来自已筛选带货形式卡）；productAdaptations 只保存一次每个不同的当前商品执行卡；ordinalBindings 只用 blueprintRef/adaptationRef 和 variationSeed 映射到具体脚本。存在 blueprintRef 时，对应 executionBlueprint 是唯一结构权威；没有 blueprintRef 时，对应 productAdaptation 是用户框架的唯一执行权威。相同蓝图可供同一商品整批复用，直接替换成当前商品执行，不要生成候选、重新选题或重新评分：
-${compactJson(selectedBlueprintPromptPayload([...selected.values()], duration), FLOW_C_SELECTED_BLUEPRINT_PROMPT_MAX_CHARS, "当前脚本子批的共享蓝图与商品适配")}
+中心已完成当前 ordinal 的创意选择。executionBlueprints 只保存一次共享的模型无关创意蓝图（可能来自已学习爆款，也可能来自已筛选带货形式卡）；productAdaptations 只保存一次每个不同的当前商品执行卡；ordinalBindings ${contentStrategy ? "用 blueprintRef/adaptationRef、variationSeed 和逐条 contentDirection" : "只用 blueprintRef/adaptationRef 和 variationSeed"} 映射到具体脚本。存在 blueprintRef 时，对应 executionBlueprint 是唯一结构权威；没有 blueprintRef 时，对应 productAdaptation 是用户框架的唯一执行权威。相同蓝图可供同一商品整批复用，直接替换成当前商品执行，不要生成候选、重新选题或重新评分：
+${compactJson(selectedBlueprintPromptPayload([...selected.values()], duration, contentStrategy), FLOW_C_SELECTED_BLUEPRINT_PROMPT_MAX_CHARS, "当前脚本子批的共享蓝图与商品适配")}
 ${rewriteInstruction}
 ${durationRules}
 写作要求：
 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。
+3. 每条生成一份稳定 voiceProfile；每段只写简短 voiceCue。口播必须使用${targetVoiceLanguage}，并执行 creatorVoiceStyle/ctaStyle；未提供 creatorVoiceStyle 时使用当地 TikTok 带货创作者真实会说的口吻。${contentStrategy ? '不是逐字翻译。Hook → Body/visible proof → Close 是画面叙事结构，不等于口播结构；镜头数量不等于台词数量。除用户明确锁定的对白外，先为整个局部10秒定稿1–2个能自然说完的很短口语句，再分配到真正需要补充人物动机或购买判断的镜头，不逐镜复述 visual；其它镜头默认 voiceover="none"，只在 soundBgm 保留动作现场声。结尾的一个简短自然 CTA 并入已定稿短句，不另外追加一句。用户锁定的对白、原框架和目标语言优先，不擅自删改；上述定稿与分配在同一次写作内完成，不输出中间声音轨。' : '不是逐字翻译，整条内容按 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 个按剧情需要决定的 ${contentStrategy ? 'shots。每镜 voiceover 字段必须存在，但不等于必须有台词：只填上一步分配给该镜的原句，其余填非空静默标记 "none"，绝不让配音念出 none；每镜同时给出准确 onScreenText、evidence、soundBgm、emotionalNote，并提供每段 endingState' : 'shots、准确 voiceover、onScreenText、evidence、soundBgm、emotionalNote 与 endingState'}；模型不要输出 continuity 或 continuityMode。
 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 与本规则冲突，只保留其钩子、动作因果和镜头节奏，改写构图、机位或表演，绝不改商品表面。
-固定使用 GPT-5.6 Terra 中等推理。媒体制作方式与分镜布局由中心在脚本完成后管理，不得影响这里的创意、镜头、口播或结构化脚本。只返回当前结构化 jobs，不调用工具、不创建任何图片或视频任务。`;
+${contentMethod}固定使用 GPT-5.6 Terra 中等推理。媒体制作方式与分镜布局由中心在脚本完成后管理，不得影响这里的创意、镜头、口播或结构化脚本。只返回当前结构化 jobs，不调用工具、不创建任何图片或视频任务。`;
 }
 export function creativeCandidatePrompt(id, task, ordinals) {
     const products = relevantProductInputs(task, ordinals);
@@ -1195,7 +1215,7 @@ function selectedCandidatesForOrdinals(task, ordinals) {
     const expected = new Set(ordinals);
     return new Map((task.selected_candidates || []).filter((candidate) => expected.has(Number(candidate.ordinal))).map((candidate) => [Number(candidate.ordinal), candidate]));
 }
-export function selectedBlueprintPromptPayload(values, fallbackTargetDurationSeconds) {
+export function selectedBlueprintPromptPayload(values, fallbackTargetDurationSeconds, contentStrategy = null) {
     const blueprints = new Map();
     const blueprintRefBySignature = new Map();
     const adaptations = new Map();
@@ -1255,12 +1275,14 @@ export function selectedBlueprintPromptPayload(values, fallbackTargetDurationSec
         const adaptationRef = `product-${candidate.productIndex}-${createHash("sha256").update(signature).digest("hex").slice(0, 16)}`;
         if (!adaptations.has(adaptationRef))
             adaptations.set(adaptationRef, { adaptationRef, ...adaptation });
+        const contentDirection = flowCContentDirection(candidate.contentDirection, contentStrategy);
         return {
             ordinal: candidate.ordinal,
             productIndex: candidate.productIndex,
             blueprintRef,
             adaptationRef,
-            variationSeed: candidate.fingerprintKey || `ordinal-${candidate.ordinal}`,
+            variationSeed: contentDirection?.variationSeed || candidate.fingerprintKey || `ordinal-${candidate.ordinal}`,
+            ...(contentDirection ? { contentDirection } : {}),
         };
     });
     return {
@@ -1273,9 +1295,10 @@ function positiveDuration(value) {
     const duration = Number(value);
     return Number.isFinite(duration) && duration > 0 ? Math.round(duration * 1000) / 1000 : null;
 }
-function selectedCandidatePlan(value) {
+export function selectedCandidatePlan(value, contentStrategy = null) {
     if (!value)
         throw new Error("中心缺少选中的创意候选");
+    const contentDirection = flowCContentDirection(value.contentDirection, contentStrategy);
     return {
         visualPremise: value.visualPremise,
         learnedTemplateId: value.learnedTemplateId || null,
@@ -1317,6 +1340,7 @@ function selectedCandidatePlan(value) {
         selectionBreakdown: value.selectionBreakdown,
         selectionMode: value.selectionMode,
         visualExecutionVersion: "flow-c-visual-execution-v1",
+        ...(contentDirection ? { contentDirection } : {}),
     };
 }
 function chunkNumbers(values, size) {

package/package.json

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