前言¶
克隆一份 OpenMontage 之後，環境往往比代碼本身更難對付。Windows 上有三個高頻卡點：git 缺 https 助手導致 clone 失敗，機器上沒有 make 導致依賴裝不上，ffmpeg 的 PATH 不被子進程繼承導致渲染階段直接被攔。每一步單獨搜都能搜到零散解法，但串起來的順序、驗證方式和回退點很少有人寫清楚。
下面介紹的這個 Skill 就是把「從零到能渲染」的完整鏈路固化成一套可複用的流程。
這是什麼¶
OpenMontage從零部署（座標 @user_7e6f1fc8/openmontage-workbuddy）是一個社區來源的 Skill，發佈者 user_7e6f1fc8，版本 1.0.0，SkillHub 分類爲 it-ops-security。
它解決的問題是：把 OpenMontage（開源 agentic 視頻製作系統）在一臺全新的 WorkBuddy 環境裏從零配好，直到完成一次端到端渲染驗證。
核心能力¶
1、覆蓋從零部署的完整流程，而不是隻貼一段安裝命令。
2、針對 Windows 環境的三大繞行方案：git 缺 https 助手改用 tarball；沒有 make 時手工翻譯構建步驟；ffmpeg PATH 不繼承時用 sitecustomize 補丁注入。
3、依賴安裝的順序與校驗方式。
4、部署後的健康檢查，用來區分「環境沒裝好」和「渲染本身有問題」。
5、端到端渲染驗證，確認整套鏈路真的可用。
Windows 三大繞行方案¶
這三個方案對應 Windows 上最常見的三類失敗，逐個說明。
1、git 缺 https 助手，改用 tarball
症狀是 clone 時報錯，根因通常是本機 git 沒有可用的 https 傳輸助手。繞行辦法是繞開 git 協議，直接從倉庫頁面下載壓縮包（tarball / zip）後解壓到目標目錄。
操作順序：
1、確認目標目錄和倉庫地址。
2、下載壓縮包到本地。
3、解壓到工作目錄，得到與 clone 後一致的目錄結構。
4、後續步驟按解壓後的目錄執行，不再依賴 git。
2、沒有 make，手工翻譯構建步驟
症狀是依賴構建階段提示找不到 make 或命令失敗。繞行辦法是把原本由 Makefile 驅動的步驟逐條翻譯成等價的直接命令，手工執行。
操作順序：
1、打開構建文件，逐條讀出需要執行的步驟。
2、把每條 make 目標替換爲對應的直接命令。
3、按依賴順序手工執行，一次一條，失敗就停。
4、執行完確認產物存在，再進入下一步。
3、ffmpeg PATH 不繼承，用 sitecustomize 補丁
症狀是健康檢查報 ffmpeg 檢測失敗，但單獨在終端裏執行 ffmpeg 是正常的。根因是 Python 進程沒有繼承到當前會話的 PATH。繞行辦法是用 sitecustomize 補丁，在解釋器啓動早期把所需路徑寫回 os.environ["PATH"]。
思路如下，具體路徑按實際安裝位置填：
# sitecustomize.py
import os
os.environ["PATH"] = r"<ffmpeg所在目錄>;" + os.environ.get("PATH", "")
放置位置應保證解釋器啓動時會加載它，然後用健康檢查腳本驗證 ffmpeg 能否被檢測到。
依賴安裝與健康檢查¶
先裝依賴，再做健康檢查。健康檢查的作用是把「環境沒配好」和「渲染邏輯有問題」區分開，避免在錯誤的方向上排查。
1、按項目聲明安裝依賴，順序按官方文檔爲準。
2、運行健康檢查腳本，確認關鍵外部命令（ffmpeg 等）可被檢測到。
3、若健康檢查失敗，先回到上面三個繞行方案排查，再繼續。
端到端渲染驗證¶
健康檢查通過後，跑一次最小渲染任務，驗證從素材到成片的鏈路是否完整。這一步通過，纔算部署真正完成。
安裝與啓用¶
該 Skill 發佈在 SkillHub，座標與頁面如下，標籤 requires_api_key=false，即不需要額外密鑰。
座標: @user_7e6f1fc8/openmontage-workbuddy
頁面: https://www.skillhub.cn/skills/user_7e6f1fc8/openmontage-workbuddy
接口: https://api.skillhub.cn/user_7e6f1fc8/openmontage-workbuddy
版本: 1.0.0
抓取到的資料中沒有給出具體的 CLI 安裝命令，也沒有區分 Cursor / Codex CLI / Claude Code 的差異，因此安裝入口以上述 SkillHub 頁面爲準，本文不臆造命令。
何時使用¶
適合在下面這些說法出現時啓用：
- 「部署 OpenMontage」「安裝 OpenMontage」
- 「在另一臺機器 / 新環境裝 OpenMontage」
- 「修復 OpenMontage 的 ffmpeg 檢測失敗」
- 「OpenMontage 渲染 blocked」
- 已經克隆了一份 OpenMontage，需要從零配好環境
也適用於同類場景：Node + Python 混合項目在 WorkBuddy 上部署時遇到 PATH 繼承問題。
適用場景與注意¶
適合的人：需要在 Windows 新機器上部署 OpenMontage，或正在排查渲染被攔、依賴裝不上這類環境問題的人。
需要注意的幾點：
1、三大繞行方案針對 Windows 環境，Linux / macOS 上不一定需要，不要照搬。
2、make 缺失時的「手工翻譯」需要能讀懂構建文件，不是一條萬能命令。
3、sitecustomize 補丁會改動解釋器啓動行爲，路徑寫死會污染其他項目，建議限定在本項目環境內。
4、本文的數據來自 SkillHub 頁面抓取時點：評分 100000、下載 1562、安裝 0，後續會變化。
5、核心能力來自 Skill 簡介，完整的命令級細節需在使用頁面時覈對。
結尾¶
這個 Skill 的價值在於把 Windows 上部署 OpenMontage 的三道坎和驗證鏈路整理成了一套順序明確、可復現的流程，省掉反覆試錯的時間。
官方地址：https://www.skillhub.cn/skills/user_7e6f1fc8/openmontage-workbuddy
