openmontage 是做什么的？
用于完整的视频制作或 OpenMontage 项目。对于单次本地媒体编辑，请使用 ffmpeg 或 video-edit。对于已有的 Atlas Remotion/HyperFrames 任务，请继续使用那些原生技能。
运行时与工作目录
可移植性：以下路径和测试结果描述了原始的 Windows 参考环境。在新主机上，请为捆绑的 runtime/ 或已验证的上游仓库在隔离环境中配置依赖项；在运行任何命令之前，需确定其实际位置。安装程序不会创建此环境。
在此 Windows 安装中，已测试的运行时是 $env:USERPROFILE/.local/share/atlas/OpenMontage。使用其 .venv/Scripts/python.exe，并以该运行时作为工作目录来运行命令。不要使用全局 Python。生产项目应放置在 projects/<project-id>/ 下，并指定明确的输出路径。
在生产之前，请阅读已安装运行时中的 AGENT_GUIDE.md 和 pipeline_defs/ 下的相关清单。其中包含：概念 → 脚本 → 场景计划 → 资产 → 编辑 → 渲染、来源/参考资料审查、成本跟踪和阶段审查。该指南的生产规则适用于 OpenMontage 生产；它们不管理无关的任务或此插件的安装检查。
在提供生产路径之前，请运行预检：
Set-Location "$env:USERPROFILE/.local/share/atlas/OpenMontage"
& ./.venv/Scripts/python.exe -c "from tools.tool_registry import registry; import json; registry.discover(); print(json.dumps(registry.provider_menu_summary(), indent=2))"
报告实际的能力可用性。配置了提供商并不保证成功生成。不要打印凭据。提供商 API 调用可能产生费用；请遵循用户授权的提供商/模型和预算。缺少模型权重或凭据需要先进行设置，这些能力才能工作。切勿未经允许就用静态图像替代已批准的运动，或切换渲染引擎。
在每个管道阶段之前，请阅读该阶段的导演指南。遵循清单中的批准/检查点字段，检查输出结果，并尊重通过 OpenMontage 批准策略记录的用户明确授权。对于开放式需求，从概念和管道/工具计划开始；对于已有素材，先检查媒体。保持提供商、运行时、音乐和资产选择对用户可见。
捆绑的便携式支持
runtime/ 包含固定的 OpenMontage 代码、管道清单、阶段指南、架构、风格剧本和作曲者源码。它不包括虚拟环境、node_modules、生成的媒体和模型权重。在另一台机器上，将其复制到可写目录中，在隔离的 Python 环境中安装 requirements.txt，然后在 remotion-composer/ 内运行 npm ci。在需要用于授权的生产之前，不要安装 GPU 扩展或下载模型。
runtime/.agents/skills/<name>/ 下的技术/提供商引用使用 SKILL.reference.md，因此它们是支持文档，而非重复的技能入口点。首先解析工具的 agent_skills 名称为已安装运行时的原始 .agents/skills/<name>/SKILL.md，否则使用捆绑的引用或同名的原生插件技能。此处省略了大型备选 HyperFrames/Remotion 包；如有需要，请使用已安装的 Atlas 技能或原始运行时源码。runtime/skills/core/ 和 runtime/skills/meta/ 包含共享的执行和审查指南。
本地动画知识单独暴露，包括角色绑定、SVG/canvas 动画、GSAP、Three.js、视觉风格和 ManimCE。这些知识包不能证明其可选的渲染器/模型已安装。使用 character-animation 管道进行角色绑定动画；使用 animation 或 animated-explainer 进行动态图形。音频生成/转录使用规范的已安装提供商技能；OpenMontage 内部保留了特定于提供商的引用。
验证
在此机器上，核心合同测试和本地合成片段检查已通过。烟雾测试涵盖修剪、音频提取/混音/淡入淡出、合成、调色、烧录字幕、帧提取和媒体结构。要在不调用提供商的情况下重复此测试：
& "$env:USERPROFILE/.local/share/atlas/OpenMontage/.venv/Scripts/python.exe" '<this-skill-directory>/smoke.py' "$env:USERPROFILE/.local/share/atlas/OpenMontage"
它仅覆盖 projects/atlas-install-smoke/ 中的生成固件。四秒的合成渲染是本地集成检查，而非端到端的生成式生产。在展示最终交付物之前，请检查并聆听实际交付物，并运行管道质量审查。
OpenMontage 代码采用 AGPL-3.0 许可；请保留 LICENSE。原生参考包可能带有额外的上游许可声明。请检查针对特定生产的提供商/媒体/模型条款。