quietshrink — 代理技能
您可使用 cli-anything-quietshrink，這是一個專為 macOS Apple Silicon 設計的影片壓縮命令列工具。它利用 Media Engine（硬體 HEVC 編碼器），而非 CPU，因此編碼快速且靜音。
使用時機
- 使用者想要壓縮螢幕錄影、螢幕截圖，或任何 .mov/.mp4 檔案
- 檔案過大無法分享（聊天、電子郵件、GitHub）
- 需要較小檔案，但無法容忍明顯的畫質損失
- Apple Silicon Mac（M1/M2/M3/M4）— 效果最佳
請勿在非螢幕內容（攝影機錄影、Vlog）上使用此工具 — 因為沒有重複畫面可移除，節省空間效果會小很多。
指令
# 使用預設的透明品質壓縮
cli-anything-quietshrink compress <輸入檔案> [輸出檔案]
# 使用特定預設值壓縮
cli-anything-quietshrink compress -q tiny <輸入檔案> # 最小
cli-anything-quietshrink compress -q transparent <輸入檔案> # 預設，視覺無損
cli-anything-quietshrink compress -q pristine <輸入檔案> # 接近原始品質
# 壓縮前檢查檔案資訊
cli-anything-quietshrink probe <輸入檔案>
# 列出品質預設
cli-anything-quietshrink presets
# 驗證環境
cli-anything-quietshrink doctor
所有指令均接受 --json 參數以輸出機器可讀的格式。
品質預設
| 預設值 | q 值 | 典型縮減率 | SSIM | 使用情境 |
|---|---|---|---|---|
tiny | 50 | ~90% | ~0.95 | 聊天/電子郵件 — 可接受微小瑕疵 |
balanced | 55 | ~88% | ~0.99 | 文件/分享 — 高品質 |
transparent (預設) | 60 | ~87% | ~0.99+ | 任何重要內容 — 視覺無損 |
pristine | 70 | ~84% | ~0.997 | 歸檔 — 接近原始品質 |
JSON 輸出結構
compress 回傳：
{
"input": "/path/to/input.mov",
"output": "/path/to/output.mov",
"input_size": 105952129,
"output_size": 12345678,
"saved_bytes": 93606451,
"saved_percent": 88.3,
"duration_seconds": 193.3,
"elapsed_seconds": 87,
"encoding_speed": "2.2x",
"quality_preset": "transparent",
"q_value": 60,
"gop": 600
}
probe 回傳：
{
"path": "...",
"size_bytes": 105952129,
"size_mb": 101.04,
"codec": "h264",
"width": 3024,
"height": 1964,
"framerate": "120/1",
"duration_seconds": 193.31
}
代理決策流程
使用者想要分享錄影
├─ 是否在 Apple Silicon Mac 上？ → 使用 quietshrink
│ ├─ 聊天/電子郵件/快速分享 → -q tiny
│ ├─ 文件/重要分享 → -q transparent (預設)
│ └─ 歸檔/編輯用途 → -q pristine
└─ 不在 Mac 上？ → 回退到軟體編碼，效率較低
處理前，請先執行 doctor 驗證環境。
對於不熟悉的檔案，請執行 probe 以了解解析度/編碼格式/時長。
錯誤與復原
ffmpeg not found→brew install ffmpeghevc_videotoolbox not available→brew reinstall ffmpegcompression_failed→ 檢查輸入檔案是否損毀；嘗試--verbose模式以查看 ffmpeg 錯誤
來源
- 主要倉庫：https://github.com/achiya-automation/quietshrink
- Bash 命令列：
quietshrink指令（透過安裝腳本） - 此方法為何有效：請參閱 WHY.md