ReelStyles 設定
指令碼位於 ReelStyles 儲存庫根目錄的 setup/ 資料夾中（此檔案往上兩層）：setup/setup.sh（macOS、Linux、WSL、Git Bash）和 setup/setup.ps1（Windows PowerShell）。它們接受相同的指令。以下 SETUP 表示：
- macOS / Linux / WSL / Git Bash：
bash <repo>/setup/setup.sh - Windows PowerShell：
powershell -ExecutionPolicy Bypass -File <repo>\setup\setup.ps1
請在使用者的專案資料夾（他們希望代理整合的資料夾）中執行這些指令，除非該資料夾就是他們唯一使用的資料夾，否則請勿在 ReelStyles 儲存庫內部執行。
- 偵測系統。 找出作業系統（Windows、macOS、Linux、WSL）並選擇對應的指令碼。在 Windows 上，優先使用
setup.ps1，除非你已經在 Git Bash 或 WSL 中。 - 檢查。 執行
SETUP check。它會列出 Node.js ≥ 22、ffmpeg + ffprobe、git、可用磁碟空間以及用於 HyperFrames 的 Chrome，如果缺少任何必要項目，則會以非零狀態碼退出。如果顯示 READY，則跳至步驟 4。 - 安裝遺漏的項目，並取得使用者同意。
- 執行
SETUP install --dry-run。它會針對每個遺漏的工具，顯示即將執行的確切指令（winget、Homebrew、apt 或 dnf；透過 fnm、nvm 或官方 nvm 安裝程式來處理節點，當系統中的 Node 版本太舊時）。 - 向使用者顯示每個指令，並詢問他們要執行哪些。絕對不要在未經使用者同意的情況下安裝任何東西，並且在指令使用
sudo時明確告知。 - 僅執行
SETUP install --yes <tool> [<tool>...]來安裝使用者同意的工具（或讓使用者自行執行SETUP install：它會逐一詢問每個工具）。如果某個指令需要密碼，請要求使用者在他們自己的終端機中執行。 - 剛才安裝的 Node 或 git 可能需要開啟新的終端機才能出現在 PATH 中。然後再次執行
SETUP check，直到顯示 READY。
- 執行
- 整合代理。 執行
SETUP wire list來查看有哪些代理被偵測到，告知使用者，然後執行SETUP wire auto（或針對使用者指定的代理執行SETUP wire <agent>，可用的代理名稱有：claude codex cursor roo cline gemini copilot windsurf）。它會在專案中寫入簡短的指標檔案（例如.cursor/rules/reelstyles.mdc、.roo/rules/reelstyles.md、AGENTS.md區塊），告訴代理 ReelStyles 技能的位置。它絕不會複製套件。如果使用者希望套用至每個專案，請加上--global。已安裝外掛的 Claude Code 使用者無需進行整合。 - 冒煙測試。 執行
SETUP test。它會渲染一段 5 秒的測試影片，並顯示 mp4 路徑和渲染時間。將這兩項資訊回報給使用者。如果失敗，請執行SETUP check，修正它所列出的問題，然後再試一次。 - 完成時顯示：「ReelStyles 已就緒：向我要求任何 STYLES.md 中的風格的影片」（
skills/reelstyles/STYLES.md）。
注意事項
- 此處不會將任何資料發送到任何地方：HyperFrames 的遙測功能已由指令碼關閉。第一次執行時會下載 HyperFrames npm 套件及其無頭 Chrome。
- 這些指令碼可以安全地重複執行；它們會跳過已經完成的部分。