scourtain/reels-engine

Reel 设置

引擎路径 = node "${CLAUDE_PLUGIN_ROOT}/engine/bin/reels.js" 主目录路径 = 如果设置了 $REELS_HOME 则使用该值，否则在 Mac 上为 ~/Movies/Reels，在 Windows 上为 ~/Videos/Reels。执行 ENGINE init-home 可打印出主目录路径。 在命令中，始终将 HOME 和 PROJECT 路径用双引号括起来，并使用引擎打印的完整路径（被双引号括起来的 ~ 无法正常解析）。在 Windows 上，路径包含反斜杠且经常包含空格，不加引号会导致问题。

在 Windows 上（通过 uname -s 检查：在 Claude Code 的 shell 中输出以 MINGW 或 MSYS 开头），跳过下面的第 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 的 asset。如果没有该名称的 asset，则停止并告知成员：“Windows 版 Whisper 的最新下载需要更新。已通知 Sam。”否则，执行 mkdir -p "HOME/tools/whisper"，curl -L --fail -o "HOME/tools/whisper.zip" <该 asset 的 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 使用。其他四个效果正常工作。”不要为其提供任何修复。

1. 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）。
2. 工具： brew install node ffmpeg whisper-cpp（跳过已安装的工具）。然后执行 ENGINE doctor。使用其 fix 提示修复任何红色显示的问题。
   • 以 – 开头的行是可选项。– person cutout 表示这台 Mac 上两个钩子卡片效果（字型放在头后）已关闭；其他一切正常。一次性提供修复：“想要两个头后钩子效果？在终端中运行 xcode-select --install，点击安装，然后说‘再次检查’。”不要因为这一步而阻塞设置流程。
3. 渲染器浏览器 + 语音模型（一次性下载，约 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
4. 工作区： ENGINE init-home。它会打印出 Reels 文件夹路径，并且永远不会覆盖已有文件。
5. 基本信息，一次只问一个问题，保存到 HOME/brand-kit.json（保留文件中已有的所有其他键）：
   • Instagram 用户名 → handle
   • 默认 Reel 长度（秒，默认 40） → default_target_seconds
6. 词汇： 询问他们经常使用的名称、工具和品牌词汇（如公司名称、产品、应用）。每行写入一个到 HOME/vocabulary.txt，以便转写时正确拼写。
7. 他们的风格。 运行 ../reel-style/references/style-interview.md 中的风格访谈：它会打开字幕选择页面，他们在此页面上的选择将成为其默认风格。不要要求提供示例 Reel 或链接。跳过访谈的命名步骤：风格始终命名为 main（直接写入 HOME/styles/main.json，没有 draft）。不要提供第二种风格；他们稍后可以通过 /reels-engine:reel-style 添加。
8. 最后告知：“设置完成。将 1-4 个片段拖入聊天并说‘new reel’（或输入 /reels-engine:reel）。”

重新运行是安全的：已完成的步骤会跳过。仅在用户想要更改基本信息时才重新询问，并将风格更改引导至 /reels-engine:reel-style。