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。這些知識包不保證其選擇性渲染器/模型已安裝。請使用角色動畫管道來處理綁定角色的動畫；對於動態圖形，請使用 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 檔案。原生參考套件可能包含其他上游授權聲明。請針對特定製作檢查提供者/媒體/模型的使用條款。