Reel 設定
ENGINE = node "${CLAUDE_PLUGIN_ROOT}/engine/bin/reels.js"
HOME = 若已設定 $REELS_HOME 則使用該值，否則在 Mac 上為 ~/Movies/Reels，在 Windows 上為 ~/Videos/Reels。ENGINE init-home 會印出路徑。
在指令中，請務必將 HOME 和 PROJECT 路徑用雙引號包住，並使用引擎印出的完整路徑（路徑中的 ~ 在引號內無法作用）。在 Windows 上，路徑包含反斜線且常有空格，沒有引號會導致錯誤。
在 Windows 上（可用 uname -s 檢查：在 Claude Code 的 shell 中，若開頭為 MINGW 或 MSYS 即為 Windows），請跳過下方步驟 1 和 2，改為執行以下步驟：
- Node 與 ffmpeg： 檢查
node --version（必須為 22 或更新版本）和ffmpeg -version。若缺少則使用winget install --id OpenJS.NodeJS.LTS -e和winget install --id Gyan.FFmpeg -e安裝。Windows 可能會顯示「是否允許此應用程式變更」視窗：請成員點擊「是」。若安裝後仍找不到工具，引擎也會在 winget 自己的資料夾中尋找；若ENGINE doctor仍顯示紅字，請成員關閉並重新開啟 Claude，然後再次檢查。 - Whisper（轉錄器）： 使用
curl -s https://api.github.com/repos/ggml-org/whisper.cpp/releases/latest尋找 Windows 下載檔案，並選取名稱恰好為whisper-bin-x64.zip的資產。如果沒有任何資產的名稱符合，請停止並告知成員：「Windows 設定需要更新以支援最新的 Whisper 下載。Sam 已被告知。」否則，執行mkdir -p "HOME/tools/whisper"、curl -L --fail -o "HOME/tools/whisper.zip" <該資產的 browser_download_url>、/c/Windows/System32/tar.exe -xf "HOME/tools/whisper.zip" -C "HOME/tools/whisper"（Windows 本身的 tar 可以讀取 zip 檔案；Git Bash 附帶的 tar 則不行），然後刪除 zip 檔案。檢查whisper-cli.exe是否已放置妥當：執行ls "HOME/tools/whisper" "HOME/tools/whisper/Release"。如果它在這兩個資料夾中都找不到，請停止並告知成員相同的訊息：「Windows 設定需要更新以支援最新的 Whisper 下載。Sam 已被告知。」此時ENGINE doctor應該會顯示whisper-cli為綠色。 - 然後從下方的步驟 3 繼續。在
ENGINE doctor中，可選的– person cutout行會顯示「目前僅在 Mac 上可用」：請告知成員一次：「兩種將文字放在你頭後方的掛鉤外觀目前僅限 Mac 使用。其他四種都可正常運作。」不要提供任何修復方案。
- Homebrew（工具安裝程式）：檢查
which brew，然後檢查/opt/homebrew/bin/brew和/usr/local/bin/brew。如果都不存在，請成員使用一般的 Mac 安裝程式來安裝，不需使用終端機：請他們前往 https://github.com/Homebrew/brew/releases/latest，下載副檔名為.pkg的檔案，雙擊並按指示操作（它會要求輸入 Mac 密碼，這是標準的 Mac 視窗；您無需輸入或索取密碼）。等待他們表示安裝完成，然後再次檢查。如果brew仍無法直接以名稱找到，請為下一步驟使用完整路徑（/opt/homebrew/bin/brew）來呼叫它。 - 工具： 執行
brew install node ffmpeg whisper-cpp（跳過已安裝的部分）。然後執行ENGINE doctor。使用其fix提示修復任何紅字項目。- 以
–開頭的行為可選項目。– person cutout表示此 Mac 上已關閉兩種掛鉤卡片外觀（文字放在你頭後方）；其他功能皆正常。提供一次修復方案：「想要兩種放在頭後方的掛鉤外觀嗎？請在終端機中執行xcode-select --install，點擊安裝，然後說「再次檢查」。」請勿因此阻擋設定程序。
- 以
- 渲染器瀏覽器 + 語音模型（一次性下載，約 700MB）： 執行
npx -y [email protected] browser ensure。然後確認語音模型已存在：檢查~/.cache/hyperframes/whisper/models/ggml-small.en.bin或HOME/models/ggml-small.en.bin。如果兩者都不存在，請下載它：mkdir -p "HOME/models" && curl -L --fail -o "HOME/models/ggml-small.en.bin" https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-small.en.bin - 工作區： 執行
ENGINE init-home。它會印出 Reels 資料夾路徑，且永遠不會覆寫現有檔案。 - 基本資訊，一次問一個問題，儲存到
HOME/brand-kit.json（保留檔案中已有的所有其他鍵）：- Instagram 帳號 →
handle - 預設 Reel 長度（秒數，預設為 40）→
default_target_seconds
- Instagram 帳號 →
- 詞彙表： 詢問他們常說的名稱、工具和品牌詞語（例如公司名稱、產品、應用程式）。每行寫一個到
HOME/vocabulary.txt，以便轉錄時能正確拼寫。 - 他們的風格。 執行
../reel-style/references/style-interview.md中的風格問卷：它會開啟字幕挑選器頁面，他們在此頁面選擇的內容將成為預設風格。不要要求提供範例 Reel 或連結。跳過問卷的命名步驟：風格固定命名為main（直接寫入HOME/styles/main.json，無需draft）。不要提供第二種風格；他們之後可以透過 /reels-engine:reel-style 新增。 - 最後說：「設定完成。將 1-4 個剪輯片段拖入對話中，然後說「new reel」（或輸入 /reels-engine:reel）。」
重新執行是安全的：已完成的步驟會自動跳過。只有當他們想要變更時才再次詢問基本資訊，並將風格變更導向 /reels-engine:reel-style。