Communitygithub.com

bhubbard/ffmpeg-skill-rs

高效能原生 Rust 移植版 ffmpeg-skill。為 AI 配對程式設計師與創作者提供的確定性 FFmpeg 媒體處理工具集與模型上下文協定(MCP)伺服器。

ffmpeg-skill-rs 是什麼?

ffmpeg-skill-rs 是 kajisho5/ffmpeg-skill 的高效能原生 Rust 移植與分支版本。它用單一獨立的靜態連結原生二進位檔案取代了脆弱的 shell/Python 包裝腳本,提供了嚴格的型別安全、次毫秒級的呼叫延遲,以及內建的模型上下文協定(MCP)JSON-RPC 2.0 stdio 伺服器。此工具專為 AI 配對程式設計師與創作者設計,可直接整合至 Claude Desktop、Cursor、Antigravity、Open WebUI 等 MCP 用戶端。它提供了豐富的 CLI 子命令,涵蓋媒體探測、無損剪裁、長寬比調整、黑邊偵測、平台交付預設集、串接與淡入淡出轉場、EBU R128 響度正規化、靜音移除、速度操控、波形與頻譜圖渲染、場景偵測及規範驗證。其核心優勢在於零執行時期開銷(無需 Python/Node.js 環境)、硬體加速預設集(Apple Silicon VideoToolbox、Nvidia NVENC、VAAPI),以及可供自主代理程式可靠使用的確定性機器可讀合約。

相容平台✓Claude Code~Codex CLI✓Cursor✓Antigravity✓Gemini CLI
npx skills add bhubbard/ffmpeg-skill-rs

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

ffmpeg-skill-rs (fms)

ffmpeg-skill-rs 是 kajisho5/ffmpeg-skill 的高效能原生 Rust 移植與分支版本。它以單一獨立的靜態連結原生二進位檔案取代了脆弱的 shell/Python 包裝腳本,提供嚴格的型別安全、次毫秒級的呼叫延遲,以及內建的模型上下文協定(MCP)JSON-RPC 2.0 stdio 伺服器。

重點特色

  • 零執行時期開銷:單一編譯的原生 Rust 二進位檔案(ffmpeg-skill / 別名 fms)。無需 Python、Node.js 或 pip 環境。
  • 內建 MCP 伺服器:可立即整合至 Claude Desktop、Cursor、Antigravity、Open WebUI 及其他 AI 代理程式(fms mcp)。
  • 確定性機器可讀合約:輸出 contract_version: "1.0" JSON 規格,供自主編碼代理程式可靠地執行工具。
  • 硬體加速預設集:自動利用 Apple Silicon VideoToolbox(h264_videotoolbox、hevc_videotoolbox、prores_videotoolbox)、Nvidia NVENC 及 VAAPI。
  • 智慧跳切與兩遍 EBU R128:無縫移除靜音片段,並進行廣播級音訊響度正規化。

CLI 使用方式

# 檢查功能與硬體加速支援
fms doctor

# 使用點號欄位選擇器進行深度媒體探測
fms probe input.mp4 --compact
fms probe input.mp4 --field "duration"
fms probe input.mp4 --field "video[0].codec"

# 無損或影格精確裁剪
fms cut input.mp4 --start 00:01:30 --duration 15.5
fms cut input.mp4 --start 10.0 --end 25.0 --accurate -o output.mp4

# 長寬比調整(填補、裁切、模糊)
fms fit input.mp4 -a 9:16 -m pad --fps 60

# 精確矩形邊界框裁切
fms crop input.mp4 -W 1080 -H 1080 -x 420 -y 0

# 黑邊 / 信箱模式偵測
fms cropdetect movie.mp4 --limit 30 --json

# 平台交付預設集(YouTube、Reels、TikTok、ProRes、GIF)
fms export input.mov --preset reels
fms export input.mov --preset youtube4k
fms export clip.mp4 --preset gif --fps 15

# 串接並加入淡入淡出轉場
fms join clip1.mp4 clip2.mp4 clip3.mp4 --transition dissolve --transition-duration 1.0

# EBU R128 兩遍響度正規化
fms loudness podcast.wav --preset podcast -o podcast_master.wav

# 跳切靜音片段
fms silence raw_take.mp4 --noise-db -28 --min-duration 0.4 --remove

# 速度操控,保留 atempo 音高
fms speedramp video.mp4 --speed 1.5

# 視覺化波形與頻譜圖渲染
fms waveform audio.mp3 --mode waveform -W 1920 -H 400 -o waveform.png

# 場景偵測與縮圖擷取
fms scenes video.mp4 --threshold 0.35 -d ./thumbnails

# 交付前規格合規性驗證器
fms check final_cut.mp4 --platform reels --json

# 輸出機器可讀合約 JSON
fms contract --json

模型上下文協定(MCP)配置

將 ffmpeg-skill 加入您的 MCP 用戶端設定檔(例如 claude_desktop_config.json、gemini 或 cursor):

{
  "mcpServers": {
    "ffmpeg-skill": {
      "command": "ffmpeg-skill",
      "args": ["mcp"]
    }
  }
}

相關技能