以下为本文档的中文说明Quietshrink 是一个充分利用 Apple Silicon 芯片硬件视频编码加速能力的视频压缩工具能够在几乎零 CPU 占用的情况下大幅压缩 macOS 屏幕录制文件的体积。该工具的核心技术优势在于使用 Apple Silicon 芯片内置的 Media Engine 专用硬件 HEVC 编码器进行视频编码而不是通过 CPU 进行软件编码因此在编码过程中电脑风扇保持安静CPU 资源几乎不受影响用户可以继续进行其他工作。使用场景非常明确当用户需要压缩屏幕录制、屏幕广播或任何 mov 和 mp4 格式的视频文件以便于通过网络分享时当视频文件体积过大无法通过聊天工具、电子邮件附件或 GitHub 上传限制发送时当需要在保持视觉无损的前提下大幅减小文件体积以节省存储空间时。该工具特别适合在配备 Apple Silicon 芯片的 Mac 电脑上使用效果最佳但在非屏幕内容如摄像头拍摄的视频或 Vlog 上效果有限因为这类内容缺少可丢弃的重复帧。核心特点与原则包括第一纯硬件加速编码——利用 Apple Silicon 的专用媒体引擎进行 HEVC 编码CPU 占用率极低编码过程安静无声不影响其他工作。第二显著的压缩效果——通常可将文件体积减小百分之七十到九十同时保持视觉无损的观看体验。第三多种质量预设方案——提供 tiny 最小体积模式约百分之九十压缩率、balanced 平衡模式约百分之八十八、transparent 透明模式默认设置视觉无损约百分之八十七和 pristine 接近原始质量模式约百分之八十四适应不同使用场景需求。第四结构化 JSON 输出——支持 json 标志参数返回输入输出文件大小、节省空间百分比、编码速度等完整结构化数据。第五前置检查机制——提供 doctor 命令验证运行环境是否完备probe 命令检查待处理文件的详细编码信息。quietshrink — Agent SkillYou have access tocli-anything-quietshrink, a CLI for compressing video files on macOS Apple Silicon. It uses the Media Engine (hardware HEVC encoder), not the CPU, so encoding is fast and silent.When to use itUser wants to compress a screen recording, screencast, or any .mov/.mp4 fileFile is too large to share (chat, email, GitHub)Need smaller files but cannot tolerate visible quality lossApple Silicon Mac (M1/M2/M3/M4) — best resultsDon’tuse this on non-screen content (camera footage, vlogs) — savings will be much smaller because there are no duplicate frames to drop.Commands# Compress with default transparent qualitycli-anything-quietshrink compressinput[output]# Compress with specific presetcli-anything-quietshrink compress-qtinyinput# smallestcli-anything-quietshrink compress-qtransparentinput# default, visually losslesscli-anything-quietshrink compress-qpristineinput# near-source quality# Inspect a file before compressingcli-anything-quietshrink probeinput# List quality presetscli-anything-quietshrink presets# Verify environmentcli-anything-quietshrink doctorAll commands accept--jsonfor machine-readable output.Quality presetsPresetqTypical reductionSSIMUse casetiny50~90%~0.95Chat/email — small artifacts OKbalanced55~88%~0.99Docs/sharing — high qualitytransparent(default)60~87%~0.99Anything important— visually losslesspristine70~84%~0.997Archival — near-sourceJSON output schemacompressreturns:{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}probereturns:{path:...,size_bytes:105952129,size_mb:101.04,codec:h264,width:3024,height:1964,framerate:120/1,duration_seconds:193.31}Decision flow for agentsUser wants to share a recording ├─ Is it on Apple Silicon Mac? → use quietshrink │ ├─ For chat/email/quick share → -q tiny │ ├─ For docs/important sharing → -q transparent (default) │ └─ For archival/editing → -q pristine └─ Not on Mac? → falls back to software, less efficientBefore processing, rundoctorto verify environment.For unfamiliar files, runprobeto understand resolution/codec/duration.Errors and recoveryffmpeg not found→brew install ffmpeghevc_videotoolbox not available→brew reinstall ffmpegcompression_failed→ check input file isn’t corrupted; try--verbosemode to see ffmpeg errorsSourceMain repo: https://github.com/achiya-automation/quietshrinkBash CLI:quietshrinkcommand (via the install script)Why this approach works: see WHY.md
以下为本文档的中文说明Quietshrink 是一个充分利用 Apple Silicon 芯片硬件视频编码加速能力的视频压缩工具能够在几乎零 CPU 占用的情况下大幅压缩 macOS 屏幕录制文件的体积。该工具的核心技术优势在于使用 Apple Silicon 芯片内置的 Media Engine 专用硬件 HEVC 编码器进行视频编码而不是通过 CPU 进行软件编码因此在编码过程中电脑风扇保持安静CPU 资源几乎不受影响用户可以继续进行其他工作。使用场景非常明确当用户需要压缩屏幕录制、屏幕广播或任何 mov 和 mp4 格式的视频文件以便于通过网络分享时当视频文件体积过大无法通过聊天工具、电子邮件附件或 GitHub 上传限制发送时当需要在保持视觉无损的前提下大幅减小文件体积以节省存储空间时。该工具特别适合在配备 Apple Silicon 芯片的 Mac 电脑上使用效果最佳但在非屏幕内容如摄像头拍摄的视频或 Vlog 上效果有限因为这类内容缺少可丢弃的重复帧。核心特点与原则包括第一纯硬件加速编码——利用 Apple Silicon 的专用媒体引擎进行 HEVC 编码CPU 占用率极低编码过程安静无声不影响其他工作。第二显著的压缩效果——通常可将文件体积减小百分之七十到九十同时保持视觉无损的观看体验。第三多种质量预设方案——提供 tiny 最小体积模式约百分之九十压缩率、balanced 平衡模式约百分之八十八、transparent 透明模式默认设置视觉无损约百分之八十七和 pristine 接近原始质量模式约百分之八十四适应不同使用场景需求。第四结构化 JSON 输出——支持 json 标志参数返回输入输出文件大小、节省空间百分比、编码速度等完整结构化数据。第五前置检查机制——提供 doctor 命令验证运行环境是否完备probe 命令检查待处理文件的详细编码信息。quietshrink — Agent SkillYou have access tocli-anything-quietshrink, a CLI for compressing video files on macOS Apple Silicon. It uses the Media Engine (hardware HEVC encoder), not the CPU, so encoding is fast and silent.When to use itUser wants to compress a screen recording, screencast, or any .mov/.mp4 fileFile is too large to share (chat, email, GitHub)Need smaller files but cannot tolerate visible quality lossApple Silicon Mac (M1/M2/M3/M4) — best resultsDon’tuse this on non-screen content (camera footage, vlogs) — savings will be much smaller because there are no duplicate frames to drop.Commands# Compress with default transparent qualitycli-anything-quietshrink compressinput[output]# Compress with specific presetcli-anything-quietshrink compress-qtinyinput# smallestcli-anything-quietshrink compress-qtransparentinput# default, visually losslesscli-anything-quietshrink compress-qpristineinput# near-source quality# Inspect a file before compressingcli-anything-quietshrink probeinput# List quality presetscli-anything-quietshrink presets# Verify environmentcli-anything-quietshrink doctorAll commands accept--jsonfor machine-readable output.Quality presetsPresetqTypical reductionSSIMUse casetiny50~90%~0.95Chat/email — small artifacts OKbalanced55~88%~0.99Docs/sharing — high qualitytransparent(default)60~87%~0.99Anything important— visually losslesspristine70~84%~0.997Archival — near-sourceJSON output schemacompressreturns:{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}probereturns:{path:...,size_bytes:105952129,size_mb:101.04,codec:h264,width:3024,height:1964,framerate:120/1,duration_seconds:193.31}Decision flow for agentsUser wants to share a recording ├─ Is it on Apple Silicon Mac? → use quietshrink │ ├─ For chat/email/quick share → -q tiny │ ├─ For docs/important sharing → -q transparent (default) │ └─ For archival/editing → -q pristine └─ Not on Mac? → falls back to software, less efficientBefore processing, rundoctorto verify environment.For unfamiliar files, runprobeto understand resolution/codec/duration.Errors and recoveryffmpeg not found→brew install ffmpeghevc_videotoolbox not available→brew reinstall ffmpegcompression_failed→ check input file isn’t corrupted; try--verbosemode to see ffmpeg errorsSourceMain repo: https://github.com/achiya-automation/quietshrinkBash CLI:quietshrinkcommand (via the install script)Why this approach works: see WHY.md
