OpenMontage

使用指南

## 什么时候用 当你希望编码 Agent 像一支视频制作团队一样工作，从调研和脚本一路推进到素材、剪辑、合成和质检时使用。它适合动画解说、品牌短片、真人口播、屏幕演示、播客拆条、纪录片混剪和多语言视频。 如果你只需要网页里快速生成一个短视频片段，或者不愿安装 Python、Node.js、FFmpeg 及本地依赖，则不适用。 ## 准备条件 - Python 3.10 及以上 - Node.js 18 及以上 - FFmpeg 与 FFprobe - Codex、Claude Code、Cursor、Copilot 或 Windsurf 等可读取文件并运行命令的 Agent - 足够的本地磁盘空间；高质量本地生成还可能需要独立显卡 ## 安装 ```bash git clone https://github.com/calesthio/OpenMontage.git cd OpenMontage make setup ``` 安装会拉取 Python、Remotion、浏览器渲染和离线语音等依赖。建议在隔离目录安装，并在投入正式项目之前检查依赖安全报告。 ## 最短使用路径 1. 说明视频目标、受众、时长、比例、素材和预算。 2. 要求 Agent 先盘点当前能力并推荐一条管线。 3. 确认创意方案、供应商、模型和渲染引擎。 4. 按管线阶段完成脚本、场景、素材、剪辑和合成。 5. 查看 Backlot 看板中的人工确认节点。 6. 验收最终 MP4、项目文件、决策记录和质检结果。 ## 完成标准 - 最终 MP4 可播放，分辨率、帧率、时长和编码符合目标。 - 脚本、场景、素材和成片之间保持一致。 - 字幕、音量、画面抽帧和交付承诺检查通过。 - 费用、供应商、模型和渲染路线有记录。 - 所有需要人工批准的管线门禁均有明确确认。 ## 失败后怎么调整 安装失败先检查 Python、Node.js 与 FFmpeg 版本；供应商不可用时回到方案阶段重新选择，不要静默降级；成片不符合预期时根据质检结果回到对应阶段修订，不要无限重跑全部流程。 ## 费用、数据与版权 核心代码开源，零密钥路线可使用本地工具和开放素材，但第三方图像、视频、语音、音乐或模型 API 可能收费。发送人物影像、客户资料或未公开商业素材前，应确认服务商的数据条款与授权范围。素材、音乐、肖像、商标和参考视频的版权责任仍由使用者确认。 本次隔离验证成功生成 23 秒、1920×1080、30fps、H.264/AAC 的零密钥演示视频。合同测试 1209 项通过、7 项跳过；1 项因测试环境继承 Google 凭据产生误判，清空相关环境变量后单项通过。Remotion 依赖安装阶段报告 2 个高危安全告警，正式使用前应重新执行依赖审计并评估。 来源：https://github.com/calesthio/OpenMontage 许可证：AGPL-3.0