mcpField
S
setup

setup

github.com/barefootford创意与媒体61476 次安装5 周前更新
代码仓库

关于 setup

这项安装技能会检查 Mac 或 Windows PC 上的 ButterCut 依赖项，指导安装并验证结果。macOS 提供简易和高级安装路径，Windows 则使用专门的安装流程。

主要功能

  1. 01macOS 和 Windows 安装流程
  2. 02依赖项与版本检查
  3. 03macOS 简易或高级安装
  4. 04安装后验证
  5. 05可选的错误报告授权

适用场景

  1. 01为 ButterCut 准备电脑环境
  2. 02查找缺失的安装依赖项
  3. 03安装后验证 ButterCut

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/barefootford/buttercut --skill setup

安装后在 Claude Code 中输入/setup确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

advanced-setup.md
simple-setup.md
windows-setup.md

详细介绍

技能：安装

为 Mac 或 Windows PC 安装 ButterCut。在 Mac 上，根据用户偏好提供两种安装方式。

步骤 0：这是哪个平台？

uname -s
  • Darwin → macOS。继续执行下面的步骤 1。
  • MINGW… / MSYS… / CYGWIN… → Windows（Git Bash）。阅读并遵循 skills/setup/windows-setup.md — 其中有独立的检查当前状态流程 — 然后返回步骤 5（错误报告问题）。
  • 完全找不到 uname → 几乎可以确定是在未安装 Git for Windows 的 Windows PowerShell 中；windows-setup.md 会首先安装它。

步骤 1：检查当前状态

（macOS 流程 — Windows 机器已在步骤 0 中执行 windows-setup.md。）运行以下每项检查。依赖项存在时，每条命令都会以状态码 0 退出。记下哪些检查未通过 — 这些就是安装流程需要安装的内容。

  • Xcode CLI Tools — xcode-select -p（修复方法：xcode-select --install）
  • Homebrew — which brew（修复方法：参见 https://brew.sh）
  • Ruby 3.3.x — ruby --version | grep -q 'ruby 3\.3'（修复方法：安装 Ruby 3.3.6，参见 .ruby-version）
  • Bundler — which bundle（修复方法：gem install bundler）
  • Python 3.12.x — python3 --version | grep -q 'Python 3\.12'（修复方法：安装 Python 3.12.8，参见 .python-version）
  • FFmpeg — which ffmpeg（修复方法：参见下方安装文件中的 FFmpeg 安装说明 — 必须使用 homebrew-ffmpeg/ffmpeg tap 构建版本）
  • FFmpeg drawtext filter — ffmpeg -hide_banner -filters 2>/dev/null | grep -q ' drawtext '（修复方法：标准的 brew install ffmpeg formula 通常不包含 drawtext；请替换为 homebrew-ffmpeg/ffmpeg tap 构建版本 — 参见安装文件）
  • WhisperX — which whisperx || test -x ~/.buttercut/whisperx || test -x ~/.buttercut/venv/bin/whisperx（修复方法：参见下方安装步骤）
  • 已安装 Gems — bundle check（修复方法：在 buttercut 目录中运行 bundle install）

如果所有检查都通过，告知用户已准备就绪，然后停止。

步骤 2：询问用户偏好

如果有缺失的依赖项，请使用 AskUserQuestion：

Question: "How would you like to install ButterCut?"
Header: "Install type"
Options:
  1. "Simple (recommended)" - "Fully automatic setup. We'll install everything for you using sensible defaults."
  2. "Advanced" - "For developers who want control. You manage Ruby/Python versions with your preferred tools."

步骤 3：运行相应的安装流程

根据用户的选择：

  • 简单：阅读并遵循 skills/setup/simple-setup.md
  • 高级：阅读并遵循 skills/setup/advanced-setup.md

步骤 4：验证安装

安装完成后，重新运行步骤 1 中的检查清单，并向用户报告结果。

步骤 5：询问是否发送错误报告

仅当 ruby lib/buttercut/report.rb consent 输出 error_reporting=unset 时才询问 — 否则，用户已经回答过，请不要再次询问。

按照 skills/report-bug/SKILL.md（步骤 2）中的内容提出两个问题，并调整措辞，使其适用于全新安装而非崩溃情形：“ButterCut 有时会遇到错误。你愿意让我把这些错误发送给团队，以便他们修复吗？”通过在 libraries/settings.yaml 中设置 error_reporting: 和 error_report_email: 来保存答案。

只问这两个问题，然后继续 — 这是用户开始第一次剪辑前的最后一步。

评论

支持 Markdown