OpenMontage 角色动画流水线 Compose Director从动作时间线到可交付 final.mp4 的渲染与质量门控实战指南【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage导读本文聚焦 OpenMontage 开源智能视频生产系统中角色动画character-animation流水线的Compose合成阶段系统讲解 compose-director.md 所定义的职责将上一阶段edit-director产出的edit_decisions与action_timeline兑现为经过评审的最终渲染视频并交付到projects/project-name/renders/final.mp4。读完本文你将掌握如何按提案锁定的render_runtime在 Remotion、HyperFrames、FFmpeg 三条渲染路径间正确路由如何通过character_rig_renderer产出可复现的渲染包、用character_animation_reviewer完成角色级 QA以及如何用video_compose的final_review做技术探针、抽帧、音画抽查与交付承诺校验确保没有静默降级、没有把未通过的输出当作成品交付。一、Compose 阶段在流水线中的位置与输入输出契约在pipeline_defs/character-animation.yaml定义的 11 个阶段中compose 处于 edit 与 publish 之间是最后一个产出视频实体的技术阶段维度内容输入工件edit_decisions、action_timeline、asset_manifest必须rig_plan、pose_library、proposal_packet可选产出工件render_report、final_review、character_qa_report均为 Schema 校验对象可用工具character_rig_renderer、character_animation_reviewer、video_compose、audio_mixer检查点checkpoint_required: true默认无需人工审批human_approval_default: false该阶段在pipeline_defs/character-animation.yaml中声明的评审焦点review_focus就是本文的核心脉络提案阶段选定的 runtime 必须与实际使用的 runtime 一致浏览器预览在可用时必须通过 Playwright/截图检查最终 MP4 必须通过 ffprobe、抽帧、角色 QA 与视觉自评严禁静默降级为静态图像伪运动。三个产出工件分别对应 Schemarender_report.schema.json、final_review.schema.json、character_qa_report.schema.jsonPipeline 后续的 publish 阶段会把这些工件作为必选输入继续传递因此 compose 产出的工件必须 Schema 合法否则整个流水线无法继续。二、Runtime 路由先从edit_decisions.render_runtime开始Compose Director 的第一条铁律是先读edit_decisions.render_runtime。该字段在提案阶段由用户批准锁定除非decision_log中有一条明确的render_runtime_selection决策改变了它否则 compose 不得擅自更换引擎。2.1 三条渲染路径的取舍路径适用场景注意点remotionReact 场景组件栈text_card、stat_card、图表场景、CaptionOverlay、TalkingHead、CinematicRenderer、逐词字幕烧录需要把素材暂存到remotion-composer/public构建 composition JSON再经video_compose渲染hyperframes动效字排kinetic typography、产品宣传片、网页转视频、注册表块registry block驱动的场景需要物化一个 HyperFrames 工作区由video_compose委托给hyperframes_composehyperframes lint与validate必须通过ffmpeg仅用于后期处理或简单视频拼接文档明确不足以单独承载角色表演严禁作为角色动画的静默兜底从源码看这一路由契约在 video_compose.py 的模块文档字符串中写得很清楚Routing is driven byedit_decisions.render_runtime(locked at proposal)且Silent runtime swaps are forbidden by governance——若所选 runtime 不可用或渲染失败工具会抛出结构化阻塞blocker等待 Agent 重新征询用户而不是偷偷换引擎。同时hyperframes_compose.py 明确指出自己是video_compose在render_runtime hyperframes时的委托实现二者构成一条完整的调用链。2.2 为什么不能随意降级到 FFmpeg角色动画的交付承诺通常依赖真实运动delivery_promise.motion_required: true。Compose 阶段的评审焦点中有专门一条No silent downgrade to still-image motion禁止静默降级为静态图像伪运动即用 FFmpeg 的 Ken Burns 缩放平移冒充角色表演是不被允许的。这与 hyperframes.md 中运动必需类交付的 runtime 是承诺而非提示的硬性规则一脉相承。如果 Remotion 未安装、npx hyperframes doctor报告阻塞正确的做法是按 AGENT_GUIDE.md 的显式升级阻塞协议处理等待用户批准后再切换 runtime。三、评审工作流五步把通过评审的渲染落到实处3.1 第 1 步用character_rig_renderer产出或刷新渲染包运行 character_rig_renderertools/character/character_animation.py中的CharacterRigRenderer类生成 HyperFrames 渲染包。这一步会同时写出浏览器预览 HTML把action_timeline序列化为window.__ACTION_TIMELINE__注入页面用 GSAP 驱动角色眨眼、转头、摆臂等循环动画。注意文档明确它是QA/debug 产物不是正式渲染路径HyperFrames 工作区默认落在output_path.parent / hyperframes下包含hyperframes.jsonCLI 配置、DESIGN.md视觉说明、compositions/character-scene.html带data-composition-id的注册表块模板asset_manifest与edit_decisions返回preview_path、hyperframes_workspace、composition_path、asset_manifest、edit_decisions等字段其中edit_decisions.render_runtime固定为hyperframes作为交付给video_compose的交接证据。从源码看CharacterRigRenderer的输入 Schema 要求action_timeline必填其余rig_plan、pose_library、output_path、workspace_path、video_output_path、render_video、duration_seconds默认 3、fps默认 12可选输出通过asset_manifest记录资产来源与成本本地渲染成本为 0 美元并通过edit_decisions.metadata.proposal_render_runtime保留提案期的 runtime方便final_review做运行时切换检测。3.2 第 2 步核验渲染器交接产物Compose Director 必须在继续前确认渲染器确实产出了四样东西一个 HyperFramesworkspace_path一份 composition HTMLcompositions/character-scene.html一份asset_manifest一份edit_decisions.render_runtime: hyperframes的交接记录。这四者缺一不可——它们是渲染路径可复现、可审计的凭证也是后续video_compose自动解析资产 ID 的依据render操作会通过asset_manifest把cuts[].source解析为文件路径。3.3 第 3 步运行character_animation_reviewer做角色级 QA对 rig、poses、timeline 与 preview 执行 character_animation_reviewerCharacterAnimationReviewer类。该工具产出character_qa_report其 Schemacharacter_qa_report.schema.json规定了核心检查项检查项含义schema_validrig_plan、pose_library、action_timeline三个工件是否通过对应 Schema 校验assets_existpreview_path是否存在pivots_defined每个角色是否定义了 joints/pivotsposes_defined每个角色是否定义了 posesactions_timed每个场景是否有时序化动作motion_detected当前实现中以actions_timed作为代理指标browser_preview_checkedbrowser/final 级别评审必须为 trueframe_samples_checkedfinal 级别评审必须为 truestatus取值pass / revise / fail存在任一 issue 即为revise。工具的review_level参数支持static / browser / final三档browser与final强制要求browser_preview_checkedfinal还强制要求frame_samples_checked缺少即追加 issue。其元数据中明确提示static artifact review; run Playwright/FFmpeg checks in compose for final output说明角色 QA 与最终视频的 Playwright/FFmpeg 检查是互补的两道闸门。3.4 第 4 步通过video_compose渲染最终视频使用渲染器的交接产物或经批准的 Remotion/HyperFrames 包调用video_compose的render操作。工具会依据edit_decisions.render_runtime自动路由remotion→ React 逐帧精确渲染npx remotion renderhyperframes→ 委托hyperframes_compose物化工作区并执行lint → validate → renderffmpeg→ 仅简单拼接/裁剪。交付路径约定最终成品必须落在projects/project-name/renders/final.mp4这是 OpenMontage 的标准项目约定publish 阶段会按此路径取用。HyperFrames 路径的验证协议值得单独强调详见 hyperframes.md 的 Validation protocol 与 hyperframes_compose.pynpx hyperframes lint——静态契约检查重复 id、轨道重叠、缺失data-composition-id、未注册时间线渲染前必须通过npx hyperframes validate——基于浏览器的运行时检查seek 暂停合成、截图、像素采样、计算 WCAG 对比度、验证window.__timelines注册与classclip渲染前必须通过迭代期可--no-contrast跳过对比度最终渲染不可跳过npx hyperframes render --quality standard——产出 MP4渲染后最终评审——与 Remotion 路径同一套final_review契约。前置条件方面hyperframes_compose依赖npx与ffmpeg要求 Node.js ≥ 22、npx hyperframes doctor通过注意 npm 包名为hyperframesnpx hyperframes/cli会 404。3.5 第 5 步运行标准final_review对成品执行标准最终评审video_compose的render流程会生成final_review工件final_review.schema.json涵盖五个维度的检查维度检查内容源码证据见 video_compose.pytechnical_probeffprobe 探测容器合法性、时长、分辨率、fps、编码、是否含音频流约第 2311 行起visual_spotcheck抽 4 帧以上open/middle/end检测黑帧约第 2389 行起audio_spotcheck检测异常静音、旁白是否存在、音乐是否存在、削波clipping约第 2441 行起promise_preservation比对proposal_packet.production_plan.render_runtime与实际使用的 runtimeruntime_swap_detected为 true 即违规同时校验motion_required承诺、motion_ratio_actual、静默降级检测约第 2500 行起subtitle_check/transcript_comparison字幕存在性、覆盖率与脚本一致性比对final_review.status若为revise或fail绝不能把视频当作完成品交付。这一点同时被 reviewer.md 强制compose 阶段若缺少final_review或final_review.status ! passpublish 评审会直接判为 CRITICAL 级问题final_review.checks.promise_preservation.runtime_swap_detected必须为false。四、浏览器 QAPlaywright 可用与不可用两条路径4.1 Playwright 可用时按文档执行五步浏览器检查打开预览preview.html捕获开头 / 中间 / 结尾三组帧检查控制台报错验证角色可见比较帧间差异确认运动确实存在。从源码看CharacterRigRenderer._render_preview_mp4正是这一思路的实现用 Playwright 启动 Chromium以 1280×720 视口打开preview_path按fps间隔逐帧截图再用 ffmpeg 把帧序列以yuv420p编码成预览 MP4——这解释了为何character_animation_reviewer的final评审级别要求browser_preview_checked与frame_samples_checked同时为 true。4.2 Playwright 不可用时退化为静态工件检查检查预览 HTML 存在、window.__ACTION_TIMELINE__注入、角色元素渲染加 FFmpeg 抽帧比对并在最终交付说明中如实报告置信度降低。这是诚实工程的一部分不能因为没有浏览器就谎称完成了视觉验证。五、质量门什么情况下绝不交付文档最后一节定义了清晰的收尾准则结合 Schema 可以归纳为两条硬性闸门角色 QA 闸门character_qa_report.status为revise或fail时不得将输出呈现为完成品character_qa_report.schema.json 中status枚举即pass/revise/failrecommended_action在非 pass 时指向fix_rig/fix_assets/fix_timeline/block最终评审闸门final_review.status ! pass时不得交付final_review.schema.json 的recommended_action指向re_render/revise_edit/revise_assets/re_author/block。同时compose 阶段还必须守住运行时一致性红线edit_decisions.render_runtime必须与提案锁定值一致任何 runtime 变更都必须先有一条经过用户批准的render_runtime_selection决策记录在decision_log中。两条闸门全部放行后projects/project-name/renders/final.mp4才允许进入 publish 阶段。六、进阶HyperFrames 实战避坑要点由于角色动画流水线以 HyperFrames 作为主要本地渲染路径character_rig_renderer默认产出 HyperFrames 工作区Compose Director 在实践中还会遇到 hyperframes.md 记录的硬经验直接决定渲染成败素材分辨率陷阱许多免费素材库的大尺寸视频实际只有 640×360。若预处理用 scale-to-fit pad会得到黑边里的小画面。正确做法是 scale-to-cover crop例如-vf scale1920:1080:force_original_aspect_ratioincrease,crop1920:1080,unsharp3:3:0.6渲染前必须预览拖拽检查60 分钟的渲染成本极高正式渲染前用npx hyperframes preview对每章至少一个 b-roll 主导场景做视觉检查2 秒的预览检查能省下 60 分钟的回归成本素材关键帧密度关键帧间隔 5s 的素材会导致video_heavy_parallel_timeout或帧冻结入库前统一重编码-c:v libx264 -r 30 -g 30 -keyint_min 30 -sc_threshold 0 -movflags faststart视频密集型合成用--workers 1超过 5 个背景视频元素时默认并行捕获会压垮 headless Chrome字体选择确定性字体编译器只内联有映射的字体Space Grotesk会被回退成 Arial优先使用Outfit、Inter、JetBrains Mono等GSAP 纪律时间线内禁止repeat: -1无限补间破坏确定性 seek-and-capture 渲染禁止在async上下文 /setTimeout/ Promise 中构建动画——window.__timelines必须在页面加载后同步完全填充。从 hyperframes.md 的 Pipelines adopting HyperFrames 表可见character-animation属于 Wave 1 之外但共享同一运行时桥接能力的路径Compose Director 需要理解这些底层约束才能真正把渲染包 → final.mp4跑通。结语Compose Director 的本质是一道可审计的渲染闸门从edit_decisions.render_runtime的路由裁决到character_rig_renderer的确定性渲染包再到character_animation_reviewer的角色 QA 与video_compose的final_review五维自检每一步都产出 Schema 合法、可追溯的工件。任何一步出现revise/fail成品都不得视为完成。这套工具产出 多级评审 承诺校验的模式正是 OpenMontage 用本地确定性渲染替代远程视频生成、把角色动画做成可复现工程的关键所在。【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/12 5:32:21 · 阅读 1.2k OpenMontage 角色动画流水线 Compose Director：从动作时间线到可交付 final.mp4 的渲染与质量门控实战指南
OpenMontage 角色动画流水线 Compose Director从动作时间线到可交付 final.mp4 的渲染与质量门控实战指南【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage导读本文聚焦 OpenMontage 开源智能视频生产系统中角色动画character-animation流水线的Compose合成阶段系统讲解 compose-director.md 所定义的职责将上一阶段edit-director产出的edit_decisions与action_timeline兑现为经过评审的最终渲染视频并交付到projects/project-name/renders/final.mp4。读完本文你将掌握如何按提案锁定的render_runtime在 Remotion、HyperFrames、FFmpeg 三条渲染路径间正确路由如何通过character_rig_renderer产出可复现的渲染包、用character_animation_reviewer完成角色级 QA以及如何用video_compose的final_review做技术探针、抽帧、音画抽查与交付承诺校验确保没有静默降级、没有把未通过的输出当作成品交付。一、Compose 阶段在流水线中的位置与输入输出契约在pipeline_defs/character-animation.yaml定义的 11 个阶段中compose 处于 edit 与 publish 之间是最后一个产出视频实体的技术阶段维度内容输入工件edit_decisions、action_timeline、asset_manifest必须rig_plan、pose_library、proposal_packet可选产出工件render_report、final_review、character_qa_report均为 Schema 校验对象可用工具character_rig_renderer、character_animation_reviewer、video_compose、audio_mixer检查点checkpoint_required: true默认无需人工审批human_approval_default: false该阶段在pipeline_defs/character-animation.yaml中声明的评审焦点review_focus就是本文的核心脉络提案阶段选定的 runtime 必须与实际使用的 runtime 一致浏览器预览在可用时必须通过 Playwright/截图检查最终 MP4 必须通过 ffprobe、抽帧、角色 QA 与视觉自评严禁静默降级为静态图像伪运动。三个产出工件分别对应 Schemarender_report.schema.json、final_review.schema.json、character_qa_report.schema.jsonPipeline 后续的 publish 阶段会把这些工件作为必选输入继续传递因此 compose 产出的工件必须 Schema 合法否则整个流水线无法继续。二、Runtime 路由先从edit_decisions.render_runtime开始Compose Director 的第一条铁律是先读edit_decisions.render_runtime。该字段在提案阶段由用户批准锁定除非decision_log中有一条明确的render_runtime_selection决策改变了它否则 compose 不得擅自更换引擎。2.1 三条渲染路径的取舍路径适用场景注意点remotionReact 场景组件栈text_card、stat_card、图表场景、CaptionOverlay、TalkingHead、CinematicRenderer、逐词字幕烧录需要把素材暂存到remotion-composer/public构建 composition JSON再经video_compose渲染hyperframes动效字排kinetic typography、产品宣传片、网页转视频、注册表块registry block驱动的场景需要物化一个 HyperFrames 工作区由video_compose委托给hyperframes_composehyperframes lint与validate必须通过ffmpeg仅用于后期处理或简单视频拼接文档明确不足以单独承载角色表演严禁作为角色动画的静默兜底从源码看这一路由契约在 video_compose.py 的模块文档字符串中写得很清楚Routing is driven byedit_decisions.render_runtime(locked at proposal)且Silent runtime swaps are forbidden by governance——若所选 runtime 不可用或渲染失败工具会抛出结构化阻塞blocker等待 Agent 重新征询用户而不是偷偷换引擎。同时hyperframes_compose.py 明确指出自己是video_compose在render_runtime hyperframes时的委托实现二者构成一条完整的调用链。2.2 为什么不能随意降级到 FFmpeg角色动画的交付承诺通常依赖真实运动delivery_promise.motion_required: true。Compose 阶段的评审焦点中有专门一条No silent downgrade to still-image motion禁止静默降级为静态图像伪运动即用 FFmpeg 的 Ken Burns 缩放平移冒充角色表演是不被允许的。这与 hyperframes.md 中运动必需类交付的 runtime 是承诺而非提示的硬性规则一脉相承。如果 Remotion 未安装、npx hyperframes doctor报告阻塞正确的做法是按 AGENT_GUIDE.md 的显式升级阻塞协议处理等待用户批准后再切换 runtime。三、评审工作流五步把通过评审的渲染落到实处3.1 第 1 步用character_rig_renderer产出或刷新渲染包运行 character_rig_renderertools/character/character_animation.py中的CharacterRigRenderer类生成 HyperFrames 渲染包。这一步会同时写出浏览器预览 HTML把action_timeline序列化为window.__ACTION_TIMELINE__注入页面用 GSAP 驱动角色眨眼、转头、摆臂等循环动画。注意文档明确它是QA/debug 产物不是正式渲染路径HyperFrames 工作区默认落在output_path.parent / hyperframes下包含hyperframes.jsonCLI 配置、DESIGN.md视觉说明、compositions/character-scene.html带data-composition-id的注册表块模板asset_manifest与edit_decisions返回preview_path、hyperframes_workspace、composition_path、asset_manifest、edit_decisions等字段其中edit_decisions.render_runtime固定为hyperframes作为交付给video_compose的交接证据。从源码看CharacterRigRenderer的输入 Schema 要求action_timeline必填其余rig_plan、pose_library、output_path、workspace_path、video_output_path、render_video、duration_seconds默认 3、fps默认 12可选输出通过asset_manifest记录资产来源与成本本地渲染成本为 0 美元并通过edit_decisions.metadata.proposal_render_runtime保留提案期的 runtime方便final_review做运行时切换检测。3.2 第 2 步核验渲染器交接产物Compose Director 必须在继续前确认渲染器确实产出了四样东西一个 HyperFramesworkspace_path一份 composition HTMLcompositions/character-scene.html一份asset_manifest一份edit_decisions.render_runtime: hyperframes的交接记录。这四者缺一不可——它们是渲染路径可复现、可审计的凭证也是后续video_compose自动解析资产 ID 的依据render操作会通过asset_manifest把cuts[].source解析为文件路径。3.3 第 3 步运行character_animation_reviewer做角色级 QA对 rig、poses、timeline 与 preview 执行 character_animation_reviewerCharacterAnimationReviewer类。该工具产出character_qa_report其 Schemacharacter_qa_report.schema.json规定了核心检查项检查项含义schema_validrig_plan、pose_library、action_timeline三个工件是否通过对应 Schema 校验assets_existpreview_path是否存在pivots_defined每个角色是否定义了 joints/pivotsposes_defined每个角色是否定义了 posesactions_timed每个场景是否有时序化动作motion_detected当前实现中以actions_timed作为代理指标browser_preview_checkedbrowser/final 级别评审必须为 trueframe_samples_checkedfinal 级别评审必须为 truestatus取值pass / revise / fail存在任一 issue 即为revise。工具的review_level参数支持static / browser / final三档browser与final强制要求browser_preview_checkedfinal还强制要求frame_samples_checked缺少即追加 issue。其元数据中明确提示static artifact review; run Playwright/FFmpeg checks in compose for final output说明角色 QA 与最终视频的 Playwright/FFmpeg 检查是互补的两道闸门。3.4 第 4 步通过video_compose渲染最终视频使用渲染器的交接产物或经批准的 Remotion/HyperFrames 包调用video_compose的render操作。工具会依据edit_decisions.render_runtime自动路由remotion→ React 逐帧精确渲染npx remotion renderhyperframes→ 委托hyperframes_compose物化工作区并执行lint → validate → renderffmpeg→ 仅简单拼接/裁剪。交付路径约定最终成品必须落在projects/project-name/renders/final.mp4这是 OpenMontage 的标准项目约定publish 阶段会按此路径取用。HyperFrames 路径的验证协议值得单独强调详见 hyperframes.md 的 Validation protocol 与 hyperframes_compose.pynpx hyperframes lint——静态契约检查重复 id、轨道重叠、缺失data-composition-id、未注册时间线渲染前必须通过npx hyperframes validate——基于浏览器的运行时检查seek 暂停合成、截图、像素采样、计算 WCAG 对比度、验证window.__timelines注册与classclip渲染前必须通过迭代期可--no-contrast跳过对比度最终渲染不可跳过npx hyperframes render --quality standard——产出 MP4渲染后最终评审——与 Remotion 路径同一套final_review契约。前置条件方面hyperframes_compose依赖npx与ffmpeg要求 Node.js ≥ 22、npx hyperframes doctor通过注意 npm 包名为hyperframesnpx hyperframes/cli会 404。3.5 第 5 步运行标准final_review对成品执行标准最终评审video_compose的render流程会生成final_review工件final_review.schema.json涵盖五个维度的检查维度检查内容源码证据见 video_compose.pytechnical_probeffprobe 探测容器合法性、时长、分辨率、fps、编码、是否含音频流约第 2311 行起visual_spotcheck抽 4 帧以上open/middle/end检测黑帧约第 2389 行起audio_spotcheck检测异常静音、旁白是否存在、音乐是否存在、削波clipping约第 2441 行起promise_preservation比对proposal_packet.production_plan.render_runtime与实际使用的 runtimeruntime_swap_detected为 true 即违规同时校验motion_required承诺、motion_ratio_actual、静默降级检测约第 2500 行起subtitle_check/transcript_comparison字幕存在性、覆盖率与脚本一致性比对final_review.status若为revise或fail绝不能把视频当作完成品交付。这一点同时被 reviewer.md 强制compose 阶段若缺少final_review或final_review.status ! passpublish 评审会直接判为 CRITICAL 级问题final_review.checks.promise_preservation.runtime_swap_detected必须为false。四、浏览器 QAPlaywright 可用与不可用两条路径4.1 Playwright 可用时按文档执行五步浏览器检查打开预览preview.html捕获开头 / 中间 / 结尾三组帧检查控制台报错验证角色可见比较帧间差异确认运动确实存在。从源码看CharacterRigRenderer._render_preview_mp4正是这一思路的实现用 Playwright 启动 Chromium以 1280×720 视口打开preview_path按fps间隔逐帧截图再用 ffmpeg 把帧序列以yuv420p编码成预览 MP4——这解释了为何character_animation_reviewer的final评审级别要求browser_preview_checked与frame_samples_checked同时为 true。4.2 Playwright 不可用时退化为静态工件检查检查预览 HTML 存在、window.__ACTION_TIMELINE__注入、角色元素渲染加 FFmpeg 抽帧比对并在最终交付说明中如实报告置信度降低。这是诚实工程的一部分不能因为没有浏览器就谎称完成了视觉验证。五、质量门什么情况下绝不交付文档最后一节定义了清晰的收尾准则结合 Schema 可以归纳为两条硬性闸门角色 QA 闸门character_qa_report.status为revise或fail时不得将输出呈现为完成品character_qa_report.schema.json 中status枚举即pass/revise/failrecommended_action在非 pass 时指向fix_rig/fix_assets/fix_timeline/block最终评审闸门final_review.status ! pass时不得交付final_review.schema.json 的recommended_action指向re_render/revise_edit/revise_assets/re_author/block。同时compose 阶段还必须守住运行时一致性红线edit_decisions.render_runtime必须与提案锁定值一致任何 runtime 变更都必须先有一条经过用户批准的render_runtime_selection决策记录在decision_log中。两条闸门全部放行后projects/project-name/renders/final.mp4才允许进入 publish 阶段。六、进阶HyperFrames 实战避坑要点由于角色动画流水线以 HyperFrames 作为主要本地渲染路径character_rig_renderer默认产出 HyperFrames 工作区Compose Director 在实践中还会遇到 hyperframes.md 记录的硬经验直接决定渲染成败素材分辨率陷阱许多免费素材库的大尺寸视频实际只有 640×360。若预处理用 scale-to-fit pad会得到黑边里的小画面。正确做法是 scale-to-cover crop例如-vf scale1920:1080:force_original_aspect_ratioincrease,crop1920:1080,unsharp3:3:0.6渲染前必须预览拖拽检查60 分钟的渲染成本极高正式渲染前用npx hyperframes preview对每章至少一个 b-roll 主导场景做视觉检查2 秒的预览检查能省下 60 分钟的回归成本素材关键帧密度关键帧间隔 5s 的素材会导致video_heavy_parallel_timeout或帧冻结入库前统一重编码-c:v libx264 -r 30 -g 30 -keyint_min 30 -sc_threshold 0 -movflags faststart视频密集型合成用--workers 1超过 5 个背景视频元素时默认并行捕获会压垮 headless Chrome字体选择确定性字体编译器只内联有映射的字体Space Grotesk会被回退成 Arial优先使用Outfit、Inter、JetBrains Mono等GSAP 纪律时间线内禁止repeat: -1无限补间破坏确定性 seek-and-capture 渲染禁止在async上下文 /setTimeout/ Promise 中构建动画——window.__timelines必须在页面加载后同步完全填充。从 hyperframes.md 的 Pipelines adopting HyperFrames 表可见character-animation属于 Wave 1 之外但共享同一运行时桥接能力的路径Compose Director 需要理解这些底层约束才能真正把渲染包 → final.mp4跑通。结语Compose Director 的本质是一道可审计的渲染闸门从edit_decisions.render_runtime的路由裁决到character_rig_renderer的确定性渲染包再到character_animation_reviewer的角色 QA 与video_compose的final_review五维自检每一步都产出 Schema 合法、可追溯的工件。任何一步出现revise/fail成品都不得视为完成。这套工具产出 多级评审 承诺校验的模式正是 OpenMontage 用本地确定性渲染替代远程视频生成、把角色动画做成可复现工程的关键所在。【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考