OpenMontage Cinematic 管线发布指南Publish Director 的 Hero/衍生版本打包、元数据策略与人工审批门【免费下载链接】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 开源 Agentic 视频生产系统中 Cinematic电影感管线的最后一环——Publish Director发布导演角色。它负责把 compose 阶段产出的正片与各类 cutdown缩短版打包成分发意图明确、Hero 主版本清晰可辨的发布包并将发布元数据与情绪基调对齐后写入publish_log工件。读完本文你将掌握该阶段的触发条件、前置工件依赖、四步发布流程、publish_log完整 Schema 结构以及绑定式人工审批门的正确执行方式含 Backlot 看板呈现与 checkpoint 协议。Publish Director 在 Cinematic 管线中的定位OpenMontage 的 Cinematic 管线由 Executive Producer执行制片人编排包含 research → proposal → script → scene_plan → assets → edit → compose → publish 八个阶段。Publish Director 是最后一个阶段负责收尾交付。在 pipeline_defs/cinematic.yaml 中publish 阶段被定义为- name: publish skill: pipelines/cinematic/publish-director required_artifacts_in: - render_report - final_review optional_artifacts_in: - proposal_packet - script produces: - publish_log tools_available: [] checkpoint_required: true human_approval_default: true review_focus: - Hero export and derivative exports are clearly labeled - Metadata matches the tone and distribution intent - Poster-frame or thumbnail concept is coherent success_criteria: - Schema-valid publish_log artifact - Export package contains video and metadata outputs值得注意的关键点该阶段tools_available为空——Publish Director 不做新的渲染、不做新的剪辑它的职责纯粹是组织、标注、包装与存档。compose 阶段已经通过video_compose、audio_mixer、video_stitch等工具完成了正片渲染详见 compose-director.mdpublish 阶段要做的只是把成品整理成可直接分发的形态。何时使用为什么发布需要一位导演发布这一步很容易被当成导出文件的机械操作但 Cinematic 管线明确将其定义为导演级职责。文档给出的使用场景是Package the cinematic piece and any cutdowns so the hero version stays clear and the distribution intent is obvious.将正片及所有缩短版打包确保 Hero 主版本清晰可辨、分发意图一目了然。一部电影感作品的典型交付物不止一个文件至少包括Hero 正片hero trailer 或 brand film——代表作品最高完成度的主版本Teaser 短预告——悬念导向的先行版本社交平台 cutdown——针对不同平台时长与构图约束的裁剪版Poster-frame / thumbnail 概念——封面帧或缩略图方案。如果这些文件混在一起、命名随意下游运营团队将无法判断哪个是主版本、哪个是衍生版本分发意图也会被稀释。Publish Director 的存在就是为了消灭这种混乱。前置条件工件、Schema 与 Playbook该阶段运行前必须满足以下依赖来自 publish-director.md层级资源用途Schemaschemas/artifacts/publish_log.schema.json工件校验前置工件state.artifacts[compose][render_report]、state.artifacts[proposal][proposal_packet]、state.artifacts[research][research_brief]、state.artifacts[script][script]最终输出与节奏图beat mapPlaybook当前激活的风格 playbook基调与命名一致性其中两个关键输入来自相邻阶段render_reportcompose 阶段产出Schema 见 schemas/artifacts/render_report.schema.json包含outputs[]每个输出的path、format、resolution、duration_seconds、platform_target、render_grammar渲染器族如cinematic-trailer、render_time_seconds、warnings等字段。它告诉 Publish Director 到底渲染出了哪些文件、各自面向什么平台。proposal_packetproposal 阶段产出Schema 见 schemas/artifacts/proposal_packet.schema.json携带concept_options、selected_concept、production_plan含锁定的render_runtime、cost_estimate与approval。其中的分发意图target_platform、target_duration_seconds是发布阶段核对元数据是否匹配分发意图的参照系。publish_log是这条依赖链的终点也是整条 Cinematic 管线唯一被写进state.artifacts[publish]的最终工件。四步发布流程1. 分离 Hero 与衍生版本发布的第一要务是分清主次。将交付物分成两类Hero 正片完整表达作品情绪弧线的主版本命名中必须明确标识如hero_前缀衍生版本teaser、social cutdown、poster-frame/thumbnail 等每个都要按用途命名如teaser_、social_16x9_、poster_。命名即文档——清晰的前缀让任何人打开发布目录都能在 5 秒内判断每个文件的角色。这与 review_focus 的第一条Hero export and derivative exports are clearly labeled直接对应。2. 让元数据匹配情绪基调发布包装标题、描述、标签必须忠实反映作品的实际情绪而不是套用模板。文档明确列出的基调候选包括dramatic戏剧化premium高级感mysterious神秘reflective沉思urgent紧迫这条规则与 schemas/artifacts/publish_log.schema.json 中每条 entry 的metadata_used字段对应——它承载了实际用于分发的标题、描述、话题标签与章节信息字段类型说明titlestring分发标题应与作品基调一致descriptionstring分发描述hashtagsstring[]话题标签数组chaptersobject[]章节信息可用于 YouTube 章节标记例如一部mysterious基调的 teaser其标题与描述就不应该使用明亮的营销话术premium基调的作品描述应克制、精准而非堆砌夸张形容词。元数据是作品情绪的延伸不是独立的文案任务。3. 保留编辑真实性Editorial Truth发布元数据必须忠实记录这部片子的真实构成存放在publish_log.metadata中包含四个字段hero_output——哪个文件是主版本derivative_outputs——哪些文件是衍生版本、各自用途poster_frame_notes——封面帧/缩略图的设计说明distribution_notes——分发备注各平台处理说明、特殊注意事项。编辑真实性的含义是不得为了让某个 cutdown 看起来更完整而把它包装成 hero不得在分发备注中隐瞒分辨率、时长或内容删减事实。这是发布环节的诚实性底线也是质量门检查的第三项依据。4. 质量门Quality Gate发布完成前Publish Director 必须逐项确认Hero 导出版本被清晰标识不会被误认为衍生版本衍生导出版本按用途标注teaser、social、poster 各归其位元数据与情绪基调匹配没有用错语气发布包无需人工二次清理即可直接使用文件命名、目录结构、配套元数据自洽。这四条全部通过才允许进入下面的审批门。publish_log 工件完整 Schema 与示例Publish Director 的核心产出是publish_log工件其 JSON Schema 位于 schemas/artifacts/publish_log.schema.json定义如下顶层必填version固定为1.0、entriesentries是发布/导出结果数组每条 entry 必填platform、status、timestampstatus枚举published、exported、failed、draft、pending_review每条 entry 可携带url、video_id、visibilitypublic/private/unlisted、export_path、metadata_used、error顶层metadata为自由对象用于承载文档要求的hero_output、derivative_outputs、poster_frame_notes、distribution_notes。一个符合 Schema 的完整示例{ version: 1.0, entries: [ { platform: youtube, status: exported, timestamp: 2026-09-11T19:45:00Z, export_path: projects/aurora/renders/hero_brand_film_4k.mp4, visibility: unlisted, metadata_used: { title: Aurora — a film about signal, description: A premium brand film. Watch in silence., hashtags: [#brandfilm, #cinematic], chapters: [{ time: 0:00, label: The signal }] } }, { platform: instagram, status: exported, timestamp: 2026-09-11T19:47:00Z, export_path: projects/aurora/renders/social_9x16_teaser.mp4, metadata_used: { title: Teaser — 30s, description: Mysterious, incomplete by design. } }, { platform: generic, status: draft, timestamp: 2026-09-11T19:48:00Z, export_path: projects/aurora/renders/poster_frame_thumb.png, metadata_used: { title: Poster frame concept } } ], metadata: { hero_output: projects/aurora/renders/hero_brand_film_4k.mp4, derivative_outputs: { teaser: projects/aurora/renders/social_9x16_teaser.mp4, poster_frame: projects/aurora/renders/poster_frame_thumb.png }, poster_frame_notes: Frame at 0:12 — the reveal beat; low-key lighting preserved, distribution_notes: YouTube unlisted first; Instagram 9x16 teaser after approval } }注意status的语义是发布状态而非渲染状态。failed条目应配合error字段记录失败原因draft/pending_review用于尚未正式分发的版本这正好支撑分发意图必须明显的要求。常见陷阱文档明确了三类最常见的发布失误均在评审中会被判定为 review findingTeaser 与 Hero 输出混放、命名不清——直接违反第一质量门是发布包混乱的最大来源写通用元数据、忽视情绪基调——mysterious 的作品配了营销腔描述或所有作品共用一套标题模板会让分发效果与作品质感脱节把所有 cutdown 当成可互换的等价物——teaser 与 social cutdown 的剪辑逻辑、时长、构图约束完全不同必须按用途逐一标注不能笼统归类为剪短版。这三条陷阱的共同根源是把发布当成功课而不是导演决策。Gate 提醒绑定协议人工审批门这是 Publish Director 技能中标注为Binding绑定的硬性要求来自原文档This stage gates on human approval (human_approval_default: true). After review passes: checkpoint withstatusawaiting_human, present the summary (the Backlot board renders the artifact), andEND YOUR TURN. Do not start the next stage in the same response. Approval is per-gate — an earlier go ahead does not cover this gate.拆解执行步骤以statusawaiting_human写 checkpoint——不是completed。这是 schemas/checkpoints/checkpoint.schema.json 中status枚举completed、failed、awaiting_human、in_progress的合法取值也是 skills/meta/checkpoint-protocol.md 规定的门控阶段写法呈现摘要——将publish_log工件呈现在 Backlot 看板上。Backlot 是 OpenMontage 的活分镜看板backlot/README.md通过python -m backlot open project-id打开从projects/id/下的 checkpoint、artifacts、renders 等磁盘状态实时渲染发布包的 Hero/衍生版本与元数据都会呈现在板上供人审阅END YOUR TURN结束回合——不得在同一轮回复中启动下一阶段。这是硬性门控即使整个管线此前已经多次获得继续的授权每个门都要单独审批。checkpoint-protocol 中明确说明lib/checkpoint.py会在门控阶段未带human_approvedTrue就写入statuscompleted时抛出GATE VIOLATION错误。用户回应后的三种分支依据 checkpoint-protocol.md批准→ 以statuscompleted、human_approvedTrue重写 checkpoint进入下一阶段要求修改→ 带着反馈回到 Publish Director 技能产出修订后的发布包、重新评审、重新 checkpoint被取代的 checkpoint 自动归档到projects/id/history/中止→ 停止管线。此外checkpoint 的cost_snapshottotal_spent_usd、total_reserved_usd、budget_remaining_usd应随摘要一起呈现让人在批准发布前掌握整条 Cinematic 管线的总花费。与相邻阶段的数据衔接Publish Director 不是孤立阶段它的输入输出与整条管线闭环上游compose 阶段产出的render_report含outputs[]与platform_target决定了发布阶段能组织哪些文件proposal_packet中锁定的render_runtime与target_platform是分发意图的源头下游publish_log是管线终态工件。配合 checkpoint 历史Backlot 看板可以支持对整次生产的回放scripts/backlot_simulate_run.py可模拟一次完整运行tools/publishers/export_bundle.py则代表了导出包这一工具层能力供发布阶段整理视频与元数据输出。整条 Cinematic 管线从 research 的情绪研究、proposal 的方向锁定、compose 的渲染到 publish 的打包与审批构成了情绪驱动的电影感生产的完整闭环——而 Publish Director 就是那个确保作品以正确身份、正确语气、正确姿态离开生产线的守门人。【免费下载链接】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），仅供参考 OpenMontage Cinematic 管线发布指南：Publish Director 的 Hero/衍生版本打包、元数据策略与人工审批门
OpenMontage Cinematic 管线发布指南Publish Director 的 Hero/衍生版本打包、元数据策略与人工审批门【免费下载链接】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 开源 Agentic 视频生产系统中 Cinematic电影感管线的最后一环——Publish Director发布导演角色。它负责把 compose 阶段产出的正片与各类 cutdown缩短版打包成分发意图明确、Hero 主版本清晰可辨的发布包并将发布元数据与情绪基调对齐后写入publish_log工件。读完本文你将掌握该阶段的触发条件、前置工件依赖、四步发布流程、publish_log完整 Schema 结构以及绑定式人工审批门的正确执行方式含 Backlot 看板呈现与 checkpoint 协议。Publish Director 在 Cinematic 管线中的定位OpenMontage 的 Cinematic 管线由 Executive Producer执行制片人编排包含 research → proposal → script → scene_plan → assets → edit → compose → publish 八个阶段。Publish Director 是最后一个阶段负责收尾交付。在 pipeline_defs/cinematic.yaml 中publish 阶段被定义为- name: publish skill: pipelines/cinematic/publish-director required_artifacts_in: - render_report - final_review optional_artifacts_in: - proposal_packet - script produces: - publish_log tools_available: [] checkpoint_required: true human_approval_default: true review_focus: - Hero export and derivative exports are clearly labeled - Metadata matches the tone and distribution intent - Poster-frame or thumbnail concept is coherent success_criteria: - Schema-valid publish_log artifact - Export package contains video and metadata outputs值得注意的关键点该阶段tools_available为空——Publish Director 不做新的渲染、不做新的剪辑它的职责纯粹是组织、标注、包装与存档。compose 阶段已经通过video_compose、audio_mixer、video_stitch等工具完成了正片渲染详见 compose-director.mdpublish 阶段要做的只是把成品整理成可直接分发的形态。何时使用为什么发布需要一位导演发布这一步很容易被当成导出文件的机械操作但 Cinematic 管线明确将其定义为导演级职责。文档给出的使用场景是Package the cinematic piece and any cutdowns so the hero version stays clear and the distribution intent is obvious.将正片及所有缩短版打包确保 Hero 主版本清晰可辨、分发意图一目了然。一部电影感作品的典型交付物不止一个文件至少包括Hero 正片hero trailer 或 brand film——代表作品最高完成度的主版本Teaser 短预告——悬念导向的先行版本社交平台 cutdown——针对不同平台时长与构图约束的裁剪版Poster-frame / thumbnail 概念——封面帧或缩略图方案。如果这些文件混在一起、命名随意下游运营团队将无法判断哪个是主版本、哪个是衍生版本分发意图也会被稀释。Publish Director 的存在就是为了消灭这种混乱。前置条件工件、Schema 与 Playbook该阶段运行前必须满足以下依赖来自 publish-director.md层级资源用途Schemaschemas/artifacts/publish_log.schema.json工件校验前置工件state.artifacts[compose][render_report]、state.artifacts[proposal][proposal_packet]、state.artifacts[research][research_brief]、state.artifacts[script][script]最终输出与节奏图beat mapPlaybook当前激活的风格 playbook基调与命名一致性其中两个关键输入来自相邻阶段render_reportcompose 阶段产出Schema 见 schemas/artifacts/render_report.schema.json包含outputs[]每个输出的path、format、resolution、duration_seconds、platform_target、render_grammar渲染器族如cinematic-trailer、render_time_seconds、warnings等字段。它告诉 Publish Director 到底渲染出了哪些文件、各自面向什么平台。proposal_packetproposal 阶段产出Schema 见 schemas/artifacts/proposal_packet.schema.json携带concept_options、selected_concept、production_plan含锁定的render_runtime、cost_estimate与approval。其中的分发意图target_platform、target_duration_seconds是发布阶段核对元数据是否匹配分发意图的参照系。publish_log是这条依赖链的终点也是整条 Cinematic 管线唯一被写进state.artifacts[publish]的最终工件。四步发布流程1. 分离 Hero 与衍生版本发布的第一要务是分清主次。将交付物分成两类Hero 正片完整表达作品情绪弧线的主版本命名中必须明确标识如hero_前缀衍生版本teaser、social cutdown、poster-frame/thumbnail 等每个都要按用途命名如teaser_、social_16x9_、poster_。命名即文档——清晰的前缀让任何人打开发布目录都能在 5 秒内判断每个文件的角色。这与 review_focus 的第一条Hero export and derivative exports are clearly labeled直接对应。2. 让元数据匹配情绪基调发布包装标题、描述、标签必须忠实反映作品的实际情绪而不是套用模板。文档明确列出的基调候选包括dramatic戏剧化premium高级感mysterious神秘reflective沉思urgent紧迫这条规则与 schemas/artifacts/publish_log.schema.json 中每条 entry 的metadata_used字段对应——它承载了实际用于分发的标题、描述、话题标签与章节信息字段类型说明titlestring分发标题应与作品基调一致descriptionstring分发描述hashtagsstring[]话题标签数组chaptersobject[]章节信息可用于 YouTube 章节标记例如一部mysterious基调的 teaser其标题与描述就不应该使用明亮的营销话术premium基调的作品描述应克制、精准而非堆砌夸张形容词。元数据是作品情绪的延伸不是独立的文案任务。3. 保留编辑真实性Editorial Truth发布元数据必须忠实记录这部片子的真实构成存放在publish_log.metadata中包含四个字段hero_output——哪个文件是主版本derivative_outputs——哪些文件是衍生版本、各自用途poster_frame_notes——封面帧/缩略图的设计说明distribution_notes——分发备注各平台处理说明、特殊注意事项。编辑真实性的含义是不得为了让某个 cutdown 看起来更完整而把它包装成 hero不得在分发备注中隐瞒分辨率、时长或内容删减事实。这是发布环节的诚实性底线也是质量门检查的第三项依据。4. 质量门Quality Gate发布完成前Publish Director 必须逐项确认Hero 导出版本被清晰标识不会被误认为衍生版本衍生导出版本按用途标注teaser、social、poster 各归其位元数据与情绪基调匹配没有用错语气发布包无需人工二次清理即可直接使用文件命名、目录结构、配套元数据自洽。这四条全部通过才允许进入下面的审批门。publish_log 工件完整 Schema 与示例Publish Director 的核心产出是publish_log工件其 JSON Schema 位于 schemas/artifacts/publish_log.schema.json定义如下顶层必填version固定为1.0、entriesentries是发布/导出结果数组每条 entry 必填platform、status、timestampstatus枚举published、exported、failed、draft、pending_review每条 entry 可携带url、video_id、visibilitypublic/private/unlisted、export_path、metadata_used、error顶层metadata为自由对象用于承载文档要求的hero_output、derivative_outputs、poster_frame_notes、distribution_notes。一个符合 Schema 的完整示例{ version: 1.0, entries: [ { platform: youtube, status: exported, timestamp: 2026-09-11T19:45:00Z, export_path: projects/aurora/renders/hero_brand_film_4k.mp4, visibility: unlisted, metadata_used: { title: Aurora — a film about signal, description: A premium brand film. Watch in silence., hashtags: [#brandfilm, #cinematic], chapters: [{ time: 0:00, label: The signal }] } }, { platform: instagram, status: exported, timestamp: 2026-09-11T19:47:00Z, export_path: projects/aurora/renders/social_9x16_teaser.mp4, metadata_used: { title: Teaser — 30s, description: Mysterious, incomplete by design. } }, { platform: generic, status: draft, timestamp: 2026-09-11T19:48:00Z, export_path: projects/aurora/renders/poster_frame_thumb.png, metadata_used: { title: Poster frame concept } } ], metadata: { hero_output: projects/aurora/renders/hero_brand_film_4k.mp4, derivative_outputs: { teaser: projects/aurora/renders/social_9x16_teaser.mp4, poster_frame: projects/aurora/renders/poster_frame_thumb.png }, poster_frame_notes: Frame at 0:12 — the reveal beat; low-key lighting preserved, distribution_notes: YouTube unlisted first; Instagram 9x16 teaser after approval } }注意status的语义是发布状态而非渲染状态。failed条目应配合error字段记录失败原因draft/pending_review用于尚未正式分发的版本这正好支撑分发意图必须明显的要求。常见陷阱文档明确了三类最常见的发布失误均在评审中会被判定为 review findingTeaser 与 Hero 输出混放、命名不清——直接违反第一质量门是发布包混乱的最大来源写通用元数据、忽视情绪基调——mysterious 的作品配了营销腔描述或所有作品共用一套标题模板会让分发效果与作品质感脱节把所有 cutdown 当成可互换的等价物——teaser 与 social cutdown 的剪辑逻辑、时长、构图约束完全不同必须按用途逐一标注不能笼统归类为剪短版。这三条陷阱的共同根源是把发布当成功课而不是导演决策。Gate 提醒绑定协议人工审批门这是 Publish Director 技能中标注为Binding绑定的硬性要求来自原文档This stage gates on human approval (human_approval_default: true). After review passes: checkpoint withstatusawaiting_human, present the summary (the Backlot board renders the artifact), andEND YOUR TURN. Do not start the next stage in the same response. Approval is per-gate — an earlier go ahead does not cover this gate.拆解执行步骤以statusawaiting_human写 checkpoint——不是completed。这是 schemas/checkpoints/checkpoint.schema.json 中status枚举completed、failed、awaiting_human、in_progress的合法取值也是 skills/meta/checkpoint-protocol.md 规定的门控阶段写法呈现摘要——将publish_log工件呈现在 Backlot 看板上。Backlot 是 OpenMontage 的活分镜看板backlot/README.md通过python -m backlot open project-id打开从projects/id/下的 checkpoint、artifacts、renders 等磁盘状态实时渲染发布包的 Hero/衍生版本与元数据都会呈现在板上供人审阅END YOUR TURN结束回合——不得在同一轮回复中启动下一阶段。这是硬性门控即使整个管线此前已经多次获得继续的授权每个门都要单独审批。checkpoint-protocol 中明确说明lib/checkpoint.py会在门控阶段未带human_approvedTrue就写入statuscompleted时抛出GATE VIOLATION错误。用户回应后的三种分支依据 checkpoint-protocol.md批准→ 以statuscompleted、human_approvedTrue重写 checkpoint进入下一阶段要求修改→ 带着反馈回到 Publish Director 技能产出修订后的发布包、重新评审、重新 checkpoint被取代的 checkpoint 自动归档到projects/id/history/中止→ 停止管线。此外checkpoint 的cost_snapshottotal_spent_usd、total_reserved_usd、budget_remaining_usd应随摘要一起呈现让人在批准发布前掌握整条 Cinematic 管线的总花费。与相邻阶段的数据衔接Publish Director 不是孤立阶段它的输入输出与整条管线闭环上游compose 阶段产出的render_report含outputs[]与platform_target决定了发布阶段能组织哪些文件proposal_packet中锁定的render_runtime与target_platform是分发意图的源头下游publish_log是管线终态工件。配合 checkpoint 历史Backlot 看板可以支持对整次生产的回放scripts/backlot_simulate_run.py可模拟一次完整运行tools/publishers/export_bundle.py则代表了导出包这一工具层能力供发布阶段整理视频与元数据输出。整条 Cinematic 管线从 research 的情绪研究、proposal 的方向锁定、compose 的渲染到 publish 的打包与审批构成了情绪驱动的电影感生产的完整闭环——而 Publish Director 就是那个确保作品以正确身份、正确语气、正确姿态离开生产线的守门人。【免费下载链接】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），仅供参考