reelstyles/reelstyles-setup

ReelStyles setup

脚本位于 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 仓库内，除非那是用户唯一使用的文件夹。

1. 检测系统。 识别操作系统（Windows、macOS、Linux、WSL）并选择匹配的脚本。在 Windows 上优先使用 setup.ps1，除非已在 Git Bash 或 WSL 中。
2. 检查。 运行 SETUP check。它会列出 Node.js ≥ 22、ffmpeg + ffprobe、git、可用磁盘和 HyperFrames 所需的 Chrome，如果缺少任何必需项则退出并返回非零值。如果输出 READY，则跳至第4步。
3. 在用户同意后安装缺失项。
   • 运行 SETUP install --dry-run。它会为每个缺失的工具打印确切的命令（winget、Homebrew、apt 或 dnf；Node 通过 fnm、nvm 或官方 nvm 安装器，当系统 Node 版本过旧时）。
   • 向用户展示每条命令并询问运行哪些。切勿安装用户未同意的任何内容，并在命令使用 sudo 时明确说明。
   • 仅运行用户同意的工具：SETUP install --yes <tool> [<tool>...]（或让用户自行运行 SETUP install：它会逐个询问每个工具）。如果命令需要密码，请让用户在自己的终端中运行。
   • 刚刚安装的 Node 或 git 可能需要新终端才能出现在 PATH 中。然后再次运行 SETUP check，直到输出 READY。
4. 接入代理。 运行 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 用户无需接线。
5. 烟雾测试。 运行 SETUP test。它会渲染一个5秒测试影片并输出 mp4 路径和渲染时间。向用户报告这两项。如果失败，运行 SETUP check，修复其列出的问题，然后重试。
6. 完成 时输出："ReelStyles 已就绪：向我请求 STYLES.md 中的任何风格视频"（skills/reelstyles/STYLES.md）。

备注

• 此处不会向任何地方发送数据：HyperFrames 遥测已被脚本关闭。首次运行会下载 HyperFrames npm 包及其无头 Chrome。
• 脚本可以安全地重复运行；它们会跳过已完成的操作。