用途:为 ButterCut 准备 Mac 或 Windows 电脑的运行环境,安装所需依赖并验证安装结果。
主要能力:先判断平台(uname -s 返回 Darwin 为 macOS;MINGW/MSYS/CYGWIN 为 Windows Git Bash;找不到 uname 通常是无 Git for Windows 的 PowerShell)。macOS 路径会逐项检查依赖:Xcode CLI Tools(xcode-select -p)、Homebrew(which brew)、Ruby 3.3.x、Bundler、Python 3.12.x、FFmpeg、FFmpeg drawtext 滤镜、WhisperX、已安装的 Gems(bundle check),并给出对应修复方式。FFmpeg 需使用 homebrew-ffmpeg/ffmpeg tap 构建,因为常规 brew 安装常缺少 drawtext。
使用方式:若依赖缺失,会询问用户选择“Simple(推荐,全自动)”或“Advanced(开发者自行管理 Ruby/Python 版本)”,随后分别执行 simple-setup.md 或 advanced-setup.md,完成后重新运行检查清单并报告结果。最后在未设置 error_reporting 时,询问是否发送错误报告及邮箱,并写入 libraries/settings.yaml。
适用场景:首次安装 ButterCut 或依赖不完整时。
限制:Windows 路径需先按 windows-setup.md 处理;具体安装命令与版本细节以对应 setup 文件为准,资料未提供完整命令内容。