以下为本文档的中文说明quietshrink 是一个专门用于在 Apple Silicon Mac 上压缩屏幕录制视频的专业技能利用苹果自研芯片M 系列内置的硬件 HEVC高效率视频编码/H.265编码器实现高性能视频压缩。屏幕录制文件通常体积巨大一分钟的 4K 屏幕录制可能占用数百兆字节存储空间这在文件分享、邮件附件发送、GitHub 仓库上传和团队协作等场景中会造成极大的不便。使用场景包括压缩技术培训或软件使用的屏幕录制教学视频以方便通过电子邮件发送或上传至在线学习平台、将大型项目演示录制文件压缩后在团队内部即时通讯工具中快速共享、减小需要上传至 GitHub/GitLab 等代码仓库的录制附件的体积以节省存储资源和加速上传下载速度。核心特点包括完全利用 Apple Silicon 的媒体引擎Media Engine硬件编解码能力执行 HEVC 编码压缩编码过程几乎不占用 CPU 核心资源CPU 负载接近于零使得 Mac 的风扇在整个压缩过程中保持静默状态电脑不会发热也不会产生噪声典型的压缩率可达 70% 至 90%即文件体积缩小至原始大小的十分之一到三分之一而在视觉感知上接近无损肉眼难以辨别压缩前后的画质差异支持常见的屏幕录制格式输入包括 .mov 和 .mp4 容器格式提供简洁易用的命令行界面CLI操作方式只需简单的 compress 命令指定输入文件和可选输出路径即可执行包含多种预设质量模式可供用户按需选择在文件大小和视觉保真度之间灵活权衡需要注意的是该工具对非屏幕录制内容如摄像机拍摄的视频、人物实拍影像、Vlog 等自然视频的压缩效果有限因为此类素材中没有大量重复帧可供高效压缩。该技能对于频繁制作和分享屏幕录制内容的开发者、培训师和技术写作者来说是极具实用价值的效率工具。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