@xiaohhhh1/canvas-agent 0.4.79 → 0.4.81

package/dist/workflow/manager.js

@@ -14,12 +14,14 @@ 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, FLOW_C_GENERATED_MONTAGE_STYLE, FLOW_C_GENERATED_MONTAGE_VERSION, FLOW_C_GENERATED_MONTAGE_VERSION_UNSUPPORTED, flowCContentAdvisories, flowCContentDirection, flowCContentMethodPrompt, flowCContentStrategy, flowCGeneratedMontage, flowCGeneratedMontagePrompt, mergeFlowCContentSummaries } from "./content-method.js";
+import { FLOW_C_CONTENT_STRATEGY_VERSION, FLOW_C_GENERATED_MONTAGE_STYLE, FLOW_C_GENERATED_MONTAGE_VERSION, FLOW_C_GENERATED_MONTAGE_VERSION_UNSUPPORTED, flowCContentAdvisories, flowCContentDirection, flowCContentMethodPrompt, flowCContentStrategy, flowCGeneratedMontage, flowCGeneratedMontagePrompt, flowCVoicePacingRepairIssues, flowCVoicePacingRepairPrompt, flowCVoicePacingRepairScaffold, 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 = 45_000;
 export const FLOW_C_SCRIPT_REWRITE_MAX_ATTEMPTS = 2;
 export const FLOW_C_CANDIDATE_REVISION_MAX_ATTEMPTS = 2;
+export const FLOW_C_VOICE_PACING_REPAIR_MAX_ATTEMPTS = 1;
+export const FLOW_C_VOICE_PACING_REVIEW_REQUIRED = "FLOW_C_VOICE_PACING_REVIEW_REQUIRED";
 export const FLOW_C_LEGACY_DIRECT_CONTRACT_VERSION = "flow-c-template-direct-v2";
 export const FLOW_C_PRODUCT_PROFILE_DIRECT_CONTRACT_VERSION = "flow-c-product-profile-direct-v1";
 export const FLOW_C_CREATIVE_SOURCE_DIRECT_CONTRACT_VERSION = "flow-c-creative-source-direct-v1";
@@ -70,6 +72,8 @@ export class WorkflowManager {
             activeChunks: 0,
             productProfiles: previous?.productProfiles || [],
             pendingScriptJobs: previous?.pendingScriptJobs || [],
+            ...(previous?.voicePacingReviewJobs ? { voicePacingReviewJobs: previous.voicePacingReviewJobs } : {}),
+            ...(previous?.voicePacingRepairAttempts ? { voicePacingRepairAttempts: previous.voicePacingRepairAttempts } : {}),
             ...(previous?.contentAdvisories ? { contentAdvisories: previous.contentAdvisories } : {}),
             lastFailure: previous?.lastFailure,
             priorityAt: now(),
@@ -92,6 +96,7 @@ export class WorkflowManager {
             return this.scriptStatus(id);
         }
         delete record.retryRequested;
+        resetVoicePacingRepairAttempts(record);
         record.status = "queued";
         record.activeChunks = 0;
         // A failed manual attempt may leave a very large or interrupted thread.
@@ -126,6 +131,10 @@ export class WorkflowManager {
             task.content_recent_scripts = record.contentSummaries;
         }
         record.pendingScriptJobs = (record.pendingScriptJobs || []).filter((job) => !record.receivedOrdinals.includes(job.ordinal));
+        record.voicePacingReviewJobs = (record.voicePacingReviewJobs || []).filter((job) => !record.receivedOrdinals.includes(job.ordinal));
+        if (!record.voicePacingReviewJobs.length)
+            delete record.voicePacingReviewJobs;
+        pruneVoicePacingRepairAttempts(record);
         record.expiresAt = task.expires_at;
         record.updatedAt = now();
         this.save();
@@ -157,6 +166,10 @@ export class WorkflowManager {
         if (flowCContentStrategy(record.contentStrategy))
             record.contentSummaries = mergeFlowCContentSummaries(record.contentSummaries, jobs, record.receivedOrdinals);
         record.pendingScriptJobs = (record.pendingScriptJobs || []).filter((job) => !record.receivedOrdinals.includes(job.ordinal));
+        record.voicePacingReviewJobs = (record.voicePacingReviewJobs || []).filter((job) => !record.receivedOrdinals.includes(job.ordinal));
+        if (!record.voicePacingReviewJobs.length)
+            delete record.voicePacingReviewJobs;
+        pruneVoicePacingRepairAttempts(record);
         record.status = data.status === "ready" ? "complete" : "running";
         record.message = data.status === "ready"
             ? flowCContentStrategy(record.contentStrategy) ? `全部 ${record.requestedCount} 条脚本已回传（内容语义仍需审阅）` : `全部 ${record.requestedCount} 条高质量脚本已回传`
@@ -354,8 +367,10 @@ export class WorkflowManager {
                     }));
                     const results = pipelineResults.flat();
                     task = await this.scriptTask(id);
-                    const terminalFailure = terminalScriptChunkFailure(results);
+                    const terminalFailure = terminalScriptChunkFailure(results, this.scriptRecord(id).receivedOrdinals);
                     if (terminalFailure) {
+                        if (terminalFailure.terminalKind === "review")
+                            throw new Error(terminalFailure.error);
                         if (terminalFailure.terminalKind === "delivery")
                             throw new Error(terminalFailure.error);
                         if (terminalFailure.terminalKind === "transport")
@@ -405,8 +420,10 @@ export class WorkflowManager {
                 this.save();
                 const results = await Promise.all(wave.chunks.map((ordinals) => this.runScriptChunk(id, task, ordinals, workspace.workspacePath)));
                 task = await this.scriptTask(id);
-                const terminalFailure = terminalScriptChunkFailure(results);
+                const terminalFailure = terminalScriptChunkFailure(results, this.scriptRecord(id).receivedOrdinals);
                 if (terminalFailure) {
+                    if (terminalFailure.terminalKind === "review")
+                        throw new Error(terminalFailure.error);
                     if (terminalFailure.terminalKind === "delivery")
                         throw new Error(terminalFailure.error);
                     if (terminalFailure.terminalKind === "transport")
@@ -468,6 +485,7 @@ export class WorkflowManager {
             const retry = record.retryRequested && record.status !== "complete";
             delete record.retryRequested;
             if (retry) {
+                resetVoicePacingRepairAttempts(record);
                 record.status = "queued";
                 delete record.threadId;
                 record.message = "已保存本机结果，正在优先重试";
@@ -628,11 +646,35 @@ export class WorkflowManager {
                 if (!ordinals.length)
                     return { terminal: false };
             }
+            const selectedForRecovery = selectedCandidatesForOrdinals(task, ordinals);
+            const localization = compactTaskLocalization(task);
+            const targetLanguage = localization.targetLanguage || task.target_language || localization.targetLocale;
+            const storedReview = (record.voicePacingReviewJobs || []).filter((job) => {
+                if (!ordinals.includes(job.ordinal))
+                    return false;
+                const candidate = selectedForRecovery.get(job.ordinal);
+                return String(job.expectedCandidateRevision || "") === String(candidate?.candidateRevision || "");
+            });
+            const repairableStoredReview = storedReview.filter((job) => flowCVoicePacingRepairIssues([job], { targetLanguage }).length > 0);
+            if (repairableStoredReview.length) {
+                const reviewResult = await this.repairVoicePacingJobs(id, task, repairableStoredReview, cwd);
+                if (reviewResult.error || reviewResult.terminal)
+                    return reviewResult;
+                ordinals = ordinals.filter((ordinal) => !this.scriptRecord(id).receivedOrdinals.includes(ordinal));
+                if (!ordinals.length)
+                    return { terminal: false };
+            }
+            const retainedOrdinals = new Set(repairableStoredReview.map((job) => job.ordinal));
+            const activeRecord = this.scriptRecord(id);
+            activeRecord.voicePacingReviewJobs = (activeRecord.voicePacingReviewJobs || []).filter((job) => !ordinals.includes(job.ordinal) || retainedOrdinals.has(job.ordinal));
+            if (!activeRecord.voicePacingReviewJobs.length)
+                delete activeRecord.voicePacingReviewJobs;
+            pruneVoicePacingRepairAttempts(activeRecord);
             const durationSeconds = Number(task.duration_seconds || 10);
             let prompt;
             try {
                 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, received_ordinals: activeRecord.receivedOrdinals, content_recent_scripts: mergeFlowCContentSummaries([...(Array.isArray(task.content_recent_scripts) ? task.content_recent_scripts : []), ...(activeRecord.contentSummaries || [])], [], activeRecord.receivedOrdinals) }
                     : task;
                 prompt = scriptChunkPrompt(id, promptTask, ordinals, rewriteAttempt);
             }
@@ -666,11 +708,10 @@ export class WorkflowManager {
                 creativePlan: { ...(job.creativePlan || {}), ...selectedCandidatePlan(selected.get(job.ordinal), flowCContentStrategy(task.creative_strategy)) },
             }));
             this.emitScriptStage(id, ordinals, "parse", Date.now() - parseStartedAt);
-            this.noteScriptContentAdvisories(id, task, jobs);
             const persistStartedAt = Date.now();
-            await this.submitGeneratedScriptJobs(id, jobs);
+            const deliveryResult = await this.submitScriptJobsWithVoicePacingRepair(id, task, jobs, cwd);
             this.emitScriptStage(id, ordinals, "persist", Date.now() - persistStartedAt);
-            return { terminal: false };
+            return deliveryResult;
         }
         catch (error) {
             // Only explicit semantic rejection may discard the affected saved output.
@@ -740,7 +781,7 @@ export class WorkflowManager {
                 return preserveScriptRecoveryReplans(rewriteResult, error);
             }
             if (error instanceof CommerceRequestError && !creativeReplanOrdinals(error).length)
-                return { error: error.message, terminal: true, terminalKind: "delivery" };
+                return { error: error.message, terminal: true, terminalKind: "delivery", affectedOrdinals: scriptDeliveryOrdinals(error).length ? scriptDeliveryOrdinals(error) : [...ordinals] };
             return {
                 error: error instanceof Error ? `结构化脚本未通过本机校验：${error.message}` : "结构化脚本未通过本机校验",
                 terminal: terminalScriptValidationError(error),
@@ -748,6 +789,133 @@ export class WorkflowManager {
             };
         }
     }
+    async submitScriptJobsWithVoicePacingRepair(id, task, jobs, cwd) {
+        const record = this.scriptRecord(id);
+        const current = jobs.filter((job) => !record.receivedOrdinals.includes(job.ordinal));
+        if (!current.length)
+            return { terminal: false };
+        const selected = selectedCandidatesForOrdinals(task, current.map((job) => job.ordinal));
+        const repairEnabled = Boolean(flowCContentStrategy(task.creative_strategy)) || [...selected.values()].some((candidate) => flowCGeneratedMontage(candidate));
+        const localization = compactTaskLocalization(task);
+        const targetLanguage = localization.targetLanguage || task.target_language || localization.targetLocale;
+        const repairIssues = repairEnabled ? flowCVoicePacingRepairIssues(current, { targetLanguage }) : [];
+        const repairOrdinals = new Set(repairIssues.map((issue) => issue.ordinal));
+        this.noteScriptContentAdvisories(id, task, current);
+        if (!repairOrdinals.size) {
+            await this.submitGeneratedScriptJobs(id, current);
+            return { terminal: false };
+        }
+        const review = new Map((record.voicePacingReviewJobs || []).map((job) => [job.ordinal, job]));
+        for (const job of current)
+            if (repairOrdinals.has(job.ordinal))
+                review.set(job.ordinal, structuredClone(job));
+        record.voicePacingReviewJobs = [...review.values()].sort((left, right) => left.ordinal - right.ordinal);
+        record.message = `检测到 ordinal ${[...repairOrdinals].join(", ")} 的短镜口播明显过密；合格稿先回传，受影响稿只做 1 次定向压缩/重分配`;
+        record.updatedAt = now();
+        this.save();
+        const clean = current.filter((job) => !repairOrdinals.has(job.ordinal));
+        if (clean.length)
+            await this.submitGeneratedScriptJobs(id, clean);
+        const affected = current.filter((job) => repairOrdinals.has(job.ordinal) && !this.scriptRecord(id).receivedOrdinals.includes(job.ordinal));
+        if (!affected.length)
+            return { terminal: false };
+        return this.repairVoicePacingJobs(id, task, affected, cwd);
+    }
+    /**
+     * One correction turn only. Originals live outside pendingScriptJobs, so a
+     * restart or response loss can never replay an overcrowded draft as accepted.
+     */
+    async repairVoicePacingJobs(id, task, originals, cwd) {
+        const record = this.scriptRecord(id);
+        const current = originals.filter((job) => !record.receivedOrdinals.includes(job.ordinal));
+        if (!current.length)
+            return { terminal: false };
+        const eligible = current.filter((job) => voicePacingRepairAttemptCount(record, job) < FLOW_C_VOICE_PACING_REPAIR_MAX_ATTEMPTS);
+        const exhausted = current.filter((job) => !eligible.includes(job));
+        if (!eligible.length)
+            return voicePacingReviewFailure(exhausted.map((job) => job.ordinal), "本机已记录本次自动修复机会，后台恢复不会再次调用模型");
+        const localization = compactTaskLocalization(task);
+        const targetLanguage = localization.targetLanguage || task.target_language || localization.targetLocale;
+        const selected = selectedCandidatesForOrdinals(task, eligible.map((job) => job.ordinal));
+        const frameworkOrdinals = [...selected.values()].filter(isFlowCUserFrameworkCandidate).map((candidate) => candidate.ordinal);
+        const ordinals = eligible.map((job) => job.ordinal);
+        const durationSeconds = Number(task.duration_seconds || 10);
+        const prompt = flowCVoicePacingRepairPrompt(eligible, { targetLanguage, frameworkOrdinals });
+        for (const job of eligible)
+            recordVoicePacingRepairAttempt(record, job);
+        record.message = `正在为 ordinal ${ordinals.join(", ")} 做第 1/${FLOW_C_VOICE_PACING_REPAIR_MAX_ATTEMPTS} 次短镜口播定向修复；画面、时轴与已选框架保持不变`;
+        record.updatedAt = now();
+        this.save();
+        let result;
+        try {
+            result = await this.runVoicePacingRepairTurn(id, prompt, cwd, durationSeconds, ordinals.length);
+        }
+        catch (error) {
+            const received = this.scriptRecord(id).receivedOrdinals;
+            const missing = [...exhausted.map((job) => job.ordinal), ...ordinals].filter((ordinal) => !received.includes(ordinal));
+            return missing.length ? voicePacingReviewFailure(missing, error instanceof Error ? error.message : "口播修复回合异常") : { terminal: false };
+        }
+        this.emitScriptStage(id, ordinals, "voice_repair", result.timings.queueWaitMs + result.timings.threadStartMs + result.timings.modelMs);
+        const missingAfterTurn = [...exhausted.map((job) => job.ordinal), ...ordinals].filter((ordinal) => !this.scriptRecord(id).receivedOrdinals.includes(ordinal));
+        if (!missingAfterTurn.length)
+            return { terminal: false };
+        if (!result.ok)
+            return voicePacingReviewFailure(missingAfterTurn, result.error || "Codex 未返回口播修复稿");
+        if (!result.text)
+            return voicePacingReviewFailure(missingAfterTurn, "Codex 未返回口播修复稿");
+        let candidates;
+        try {
+            candidates = parseFlowCScriptOutput(result.text, ordinals);
+        }
+        catch (error) {
+            const missing = missingAfterTurn.filter((ordinal) => !this.scriptRecord(id).receivedOrdinals.includes(ordinal));
+            return missing.length ? voicePacingReviewFailure(missing, error instanceof Error ? error.message : "口播修复稿未通过结构校验") : { terminal: false };
+        }
+        const byOrdinal = new Map(candidates.map((job) => [job.ordinal, job]));
+        const accepted = [];
+        const failed = new Map(exhausted.map((job) => [job.ordinal, "本次自动修复机会已经使用"]));
+        for (const original of eligible.filter((job) => !this.scriptRecord(id).receivedOrdinals.includes(job.ordinal))) {
+            const candidate = byOrdinal.get(original.ordinal);
+            if (!candidate) {
+                failed.set(original.ordinal, "修复回合未返回该 ordinal");
+                continue;
+            }
+            try {
+                const repaired = applyFlowCVoicePacingRepair(original, candidate, frameworkOrdinals.includes(original.ordinal));
+                const remaining = flowCVoicePacingRepairIssues([repaired], { targetLanguage });
+                if (remaining.length) {
+                    failed.set(original.ordinal, `仍有 ${remaining.length} 个明显过密短镜`);
+                    continue;
+                }
+                accepted.push(repaired);
+            }
+            catch (error) {
+                failed.set(original.ordinal, error instanceof Error ? error.message : "修复稿改变了受保护字段");
+            }
+        }
+        const stillMissing = accepted.filter((job) => !this.scriptRecord(id).receivedOrdinals.includes(job.ordinal));
+        if (stillMissing.length) {
+            this.noteScriptContentAdvisories(id, task, stillMissing);
+            await this.submitGeneratedScriptJobs(id, stillMissing);
+        }
+        for (const ordinal of this.scriptRecord(id).receivedOrdinals)
+            failed.delete(ordinal);
+        if (failed.size)
+            return voicePacingReviewFailure([...failed.keys()], [...failed.entries()].map(([ordinal, reason]) => `ordinal ${ordinal}: ${reason}`).join("；"));
+        return { terminal: false };
+    }
+    runVoicePacingRepairTurn(id, prompt, cwd, durationSeconds, count) {
+        return runCodexWorkflowTurn(prompt, this.emit, {
+            cwd,
+            permissionMode: "full",
+            timeoutMs: FLOW_C_CODEX_TURN_TIMEOUT_MS,
+            ...flowCVoicePacingRepairTurnOptions(),
+            outputSchema: flowCScriptOutputSchema(durationSeconds, count),
+            onThread: (threadId) => { this.scriptRecord(id).threadId = threadId; this.save(); },
+            onWorkerStart: () => { const next = this.scriptRecord(id); next.activeChunks = Number(next.activeChunks || 0) + 1; next.updatedAt = now(); this.save(); },
+            onWorkerFinish: () => { const next = this.scriptRecord(id); next.activeChunks = Math.max(0, Number(next.activeChunks || 0) - 1); next.updatedAt = now(); this.save(); },
+        });
+    }
     /** Nonblocking, text-free diagnostics for newly generated policy scripts only. */
     noteScriptContentAdvisories(id, task, jobs) {
         const strategy = flowCContentStrategy(task.creative_strategy);
@@ -778,7 +946,7 @@ export class WorkflowManager {
         }
         catch (error) {
             if (jobs.length === 1 || error instanceof CommerceRequestError && ![400, 409, 422].includes(error.status || 0))
-                throw error;
+                throw markScriptDeliveryOrdinals(error, jobs);
             let accepted = 0;
             const failures = [];
             for (const job of jobs) {
@@ -788,7 +956,7 @@ export class WorkflowManager {
                 }
                 catch (jobError) {
                     if (jobError instanceof CommerceRequestError && ![400, 409, 422].includes(jobError.status || 0))
-                        throw jobError;
+                        throw markScriptDeliveryOrdinals(jobError, [job]);
                     failures.push(jobError);
                 }
             }
@@ -936,12 +1104,134 @@ export function compareScriptQueueRecords(left, right) {
         return String(right.priorityAt || "").localeCompare(String(left.priorityAt || ""));
     return left.updatedAt.localeCompare(right.updatedAt);
 }
+function pacingObject(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+export function flowCVoicePacingRepairTurnOptions() {
+    return { maxProcessAttempts: FLOW_C_VOICE_PACING_REPAIR_MAX_ATTEMPTS };
+}
+function voicePacingCandidateRevision(job) {
+    return String(job.expectedCandidateRevision || "");
+}
+export function voicePacingRepairAttemptCount(record, job) {
+    const revision = voicePacingCandidateRevision(job);
+    return Math.max(0, ...((record.voicePacingRepairAttempts || []).filter((entry) => Number(entry.ordinal) === Number(job.ordinal) && String(entry.candidateRevision || "") === revision).map((entry) => Math.floor(Number(entry.attempts) || 0))));
+}
+function recordVoicePacingRepairAttempt(record, job) {
+    const revision = voicePacingCandidateRevision(job);
+    const attempts = (record.voicePacingRepairAttempts || []).filter((entry) => Number(entry.ordinal) !== job.ordinal || String(entry.candidateRevision || "") !== revision);
+    attempts.push({ ordinal: job.ordinal, candidateRevision: revision, attempts: voicePacingRepairAttemptCount(record, job) + 1 });
+    record.voicePacingRepairAttempts = attempts.sort((left, right) => left.ordinal - right.ordinal || left.candidateRevision.localeCompare(right.candidateRevision));
+}
+function pruneVoicePacingRepairAttempts(record) {
+    const active = new Set((record.voicePacingReviewJobs || []).map((job) => `${job.ordinal}\u0000${voicePacingCandidateRevision(job)}`));
+    record.voicePacingRepairAttempts = (record.voicePacingRepairAttempts || []).filter((entry) => active.has(`${Number(entry.ordinal)}\u0000${String(entry.candidateRevision || "")}`));
+    if (!record.voicePacingRepairAttempts.length)
+        delete record.voicePacingRepairAttempts;
+}
+function resetVoicePacingRepairAttempts(record) {
+    delete record.voicePacingRepairAttempts;
+}
+function pacingSegments(value) {
+    const job = pacingObject(value);
+    return Array.isArray(job.segments) ? job.segments.map(pacingObject) : job.segment ? [pacingObject(job.segment)] : [];
+}
+function isPacingSilence(value) {
+    return /^(?:none|无|sin voz|sin diálogo)$/i.test(String(value || "").trim());
+}
+function exactSegmentTranscript(shots) {
+    return shots.map((shot) => String(shot.voiceover || "").trim()).filter((line) => line && !isPacingSilence(line)).join(" ").replace(/\s+/gu, " ").trim();
+}
+function stablePacingValue(value) {
+    if (Array.isArray(value))
+        return value.map(stablePacingValue);
+    if (!value || typeof value !== "object")
+        return value;
+    return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, child]) => [key, stablePacingValue(child)]));
+}
+function protectedPacingProjection(value) {
+    const job = structuredClone(pacingObject(value));
+    delete job.script;
+    delete job.masterScript;
+    delete job.segmentVoiceovers;
+    for (const segment of pacingSegments(job)) {
+        delete segment.script;
+        const shots = Array.isArray(segment.shots) ? segment.shots.map(pacingObject) : [];
+        for (const shot of shots)
+            shot.voiceover = "[voiceover-only-repair]";
+    }
+    return stablePacingValue(job);
+}
+/**
+ * Accept only repaired per-shot speech. Every visual/timeline/state/selection
+ * field comes from the locally validated original and rendered projections are
+ * rebuilt from that one final voice source.
+ */
+export function applyFlowCVoicePacingRepair(originalValue, candidateValue, preserveExactTranscript = false) {
+    const original = pacingObject(originalValue);
+    const candidate = pacingObject(candidateValue);
+    const ordinal = Number(original.ordinal);
+    if (!Number.isInteger(ordinal) || Number(candidate.ordinal) !== ordinal || Number(candidate.productIndex) !== Number(original.productIndex))
+        throw new Error("修复稿 ordinal/productIndex 与原稿不一致");
+    if (JSON.stringify(protectedPacingProjection(flowCVoicePacingRepairScaffold(candidate))) !== JSON.stringify(protectedPacingProjection(flowCVoicePacingRepairScaffold(original)))) {
+        throw new Error("修复稿改变了 VO 之外的画面、事实、声音方向或连续性字段");
+    }
+    const originalSegments = pacingSegments(original);
+    const candidateSegments = pacingSegments(candidate);
+    if (!originalSegments.length || candidateSegments.length !== originalSegments.length)
+        throw new Error("修复稿改变了分段数量");
+    const patchedSegments = originalSegments.map((originalSegment, segmentIndex) => {
+        const originalShots = Array.isArray(originalSegment.shots) ? originalSegment.shots.map(pacingObject) : [];
+        const candidateShots = Array.isArray(candidateSegments[segmentIndex]?.shots) ? candidateSegments[segmentIndex].shots.map(pacingObject) : [];
+        if (!originalShots.length || candidateShots.length !== originalShots.length)
+            throw new Error(`segment ${segmentIndex + 1} 改变了镜头数量`);
+        for (const [shotIndex, originalShot] of originalShots.entries()) {
+            const candidateShot = candidateShots[shotIndex];
+            if (Number(candidateShot.startSeconds) !== Number(originalShot.startSeconds) || Number(candidateShot.endSeconds) !== Number(originalShot.endSeconds))
+                throw new Error(`segment ${segmentIndex + 1} shot ${shotIndex + 1} 改变了镜头时轴`);
+            if (!String(candidateShot.voiceover || "").trim())
+                throw new Error(`segment ${segmentIndex + 1} shot ${shotIndex + 1} 缺少 voiceover`);
+        }
+        const originalTranscript = exactSegmentTranscript(originalShots);
+        const repairedTranscript = exactSegmentTranscript(candidateShots);
+        if (originalTranscript && !repairedTranscript)
+            throw new Error(`segment ${segmentIndex + 1} 删除了整段口播`);
+        if (preserveExactTranscript && repairedTranscript !== originalTranscript)
+            throw new Error(`segment ${segmentIndex + 1} 改写了用户逐字框架口播`);
+        return {
+            ...originalSegment,
+            shots: originalShots.map((shot, shotIndex) => ({ ...shot, voiceover: String(candidateShots[shotIndex].voiceover).trim() })),
+        };
+    });
+    const patched = Array.isArray(original.segments) ? { ...original, segments: patchedSegments } : { ...original, segment: patchedSegments[0] };
+    const scaffold = flowCVoicePacingRepairScaffold(patched);
+    const rendered = parseFlowCScriptOutput(JSON.stringify({ jobs: [scaffold] }), [ordinal])[0];
+    const result = { ...original, ...rendered };
+    if (JSON.stringify(protectedPacingProjection(result)) !== JSON.stringify(protectedPacingProjection(original)))
+        throw new Error("修复稿改变了 VO 之外的受保护字段");
+    return result;
+}
+function voicePacingReviewFailure(ordinals, reason) {
+    const scoped = [...new Set(ordinals.map(Number).filter((ordinal) => Number.isInteger(ordinal) && ordinal > 0))].sort((left, right) => left - right);
+    return {
+        error: `${FLOW_C_VOICE_PACING_REVIEW_REQUIRED}: ordinal ${scoped.join(", ")} 的短镜口播在唯一一次定向修复后仍未安全落入镜头时长；原稿仅保存在本机待审区，未作为可重传稿提交。${reason}。请人工审阅，或确认逐字框架可调整后手动重试`,
+        terminal: true,
+        terminalKind: "review",
+        affectedOrdinals: scoped,
+    };
+}
 /** A deterministic response-format failure stops fallback isolation immediately. */
 export function terminalScriptChunkError(results) {
     return terminalScriptChunkFailure(results)?.error || "";
 }
-export function terminalScriptChunkFailure(results) {
-    return results.find((result) => result.terminal);
+export function terminalScriptChunkFailure(results, receivedOrdinals = []) {
+    const received = new Set(receivedOrdinals.map(Number).filter(Number.isInteger));
+    return results.find((result) => {
+        if (!result.terminal)
+            return false;
+        const affected = Array.isArray(result.affectedOrdinals) ? result.affectedOrdinals.map(Number).filter((ordinal) => Number.isInteger(ordinal) && ordinal > 0) : [];
+        return !affected.length || affected.some((ordinal) => !received.has(ordinal));
+    });
 }
 export function scriptCreativeReplanOrdinals(results) {
     return [...new Set(results.flatMap((result) => (result && typeof result === "object" ? result.replanOrdinals || [] : [])).filter((ordinal) => Number.isInteger(ordinal) && ordinal > 0))].sort((left, right) => left - right);
@@ -960,6 +1250,17 @@ export function creativeReplanOrdinals(error) {
     const values = error.resetOrdinals;
     return Array.isArray(values) ? [...new Set(values.map(Number).filter((ordinal) => Number.isInteger(ordinal) && ordinal > 0))].sort((left, right) => left - right) : [];
 }
+function markScriptDeliveryOrdinals(error, jobs) {
+    if (error && typeof error === "object") {
+        const current = scriptDeliveryOrdinals(error);
+        error.deliveryOrdinals = [...new Set([...current, ...jobs.map((job) => Number(job.ordinal))].filter((ordinal) => Number.isInteger(ordinal) && ordinal > 0))].sort((left, right) => left - right);
+    }
+    return error;
+}
+export function scriptDeliveryOrdinals(error) {
+    const values = error && typeof error === "object" ? error.deliveryOrdinals : [];
+    return Array.isArray(values) ? [...new Set(values.map(Number).filter((ordinal) => Number.isInteger(ordinal) && ordinal > 0))].sort((left, right) => left - right) : [];
+}
 export function candidateRevisionChangedOrdinals(error) {
     if (!error || typeof error !== "object")
         return [];
@@ -1105,7 +1406,7 @@ export function scriptChunkPrompt(id, task, ordinals, rewriteAttempt = 0) {
         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),
+        frameworkOrdinals: [...selected.values()].filter(isFlowCUserFrameworkCandidate).map((candidate) => candidate.ordinal),
         montageOrdinals: generatedMontageOrdinals,
     });
     const generatedMontageMethod = flowCGeneratedMontagePrompt(generatedMontageOrdinals);
@@ -1326,6 +1627,9 @@ function positiveDuration(value) {
     const duration = Number(value);
     return Number.isFinite(duration) && duration > 0 ? Math.round(duration * 1000) / 1000 : null;
 }
+function isFlowCUserFrameworkCandidate(value) {
+    return value.selectionMode === "user-framework" || value.scriptSource === "user-framework" || value.creativeSource === "user-framework";
+}
 export function selectedCandidatePlan(value, contentStrategy = null) {
     if (!value)
         throw new Error("中心缺少选中的创意候选");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaohhhh1/canvas-agent",
-  "version": "0.4.79",
+  "version": "0.4.81",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -23,7 +23,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
     "@huggingface/transformers": "4.2.0",
-    "@openai/codex": "0.145.0",
+    "@openai/codex": "0.153.4",
     "express": "^5.1.0",
     "playwright-core": "^1.62.1",
     "ws": "^8.18.3",