需要压缩 PNG/JPEG 截图并保持原格式时：用…

当截图文件过大，且需要在文档、仓库、博客等场景中保持 PNG/JPEG 兼容性时，用 pngquant 压缩 PNG、用 jpegoptim 压缩 JPEG。

适用场景

解决思路

1. 运行脚本：`python /path/to/skills/screenshot-compression/scripts/compress_screenshots.py <files-or-directories>`，传入图片文件或目录路径。
2. 脚本先检查 `pngquant` 和 `jpegoptim` 是否已安装；若缺失，打印安装说明并退出。
3. 缺失依赖时不要替用户安装，只转达错误信息，让用户自行安装。
4. macOS 安装依赖：`brew install pngquant jpegoptim`。
5. Ubuntu / Debian 安装依赖：`sudo apt install pngquant jpegoptim`。
6. CentOS / RHEL 安装依赖：`sudo yum install pngquant jpegoptim`。
7. 脚本按扩展名自动识别文件格式。
8. 对每个文件就地压缩，覆盖原文件。
9. 打印每个文件及总体的压缩摘要。
10. 使用位置参数 `paths`（必填）指定要压缩的图片文件或目录。
11. 使用 `-r` / `--recursive`（默认关闭）递归处理目录。
12. 使用 `--png-quality`（默认 `80-95`）设置 pngquant 质量范围，格式为 min-max，取值 0-100。
13. 使用 `--jpeg-quality`（默认 `85`）设置 jpegoptim 最大质量，取值 0-100。
14. 单文件示例：`python .../compress_screenshots.py screenshot.png`。
15. 目录示例：`python .../compress_screenshots.py ./images/`。
16. 递归目录示例：`python .../compress_screenshots.py ./docs/ --recursive`。
17. 代码截图高质量示例：`python .../compress_screenshots.py *.png --png-quality 90-100`。
18. 缩略图激进压缩示例：`python .../compress_screenshots.py *.jpg --jpeg-quality 70`。
19. 通用截图（文档、网页）建议：`--png-quality 80-95`，`--jpeg-quality 85`。
20. 代码截图（文字需清晰）建议：`--png-quality 90-100`，`--jpeg-quality 90`。
21. 缩略图/预览（优先体积）建议：`--png-quality 60-80`，`--jpeg-quality 70`。
22. PNG 处理方式：pngquant 将 24 位真彩色量化为 8 位调色板（256 色）。
23. PNG 处理方式：使用 Floyd-Steinberg 抖动使渐变更平滑。
24. PNG 处理方式：截图是理想候选，UI 颜色通常远少于 256 个唯一值。
25. PNG 典型压缩率：60-80%。
26. JPEG 处理方式：jpegoptim 按指定质量重新编码。
27. JPEG 处理方式：通过 `--strip-all` 移除元数据（EXIF、ICC profiles、缩略图）。
28. JPEG 处理方式：优化 Huffman 表。
29. JPEG 典型压缩率：20-50%。
30. 文件会被就地压缩并覆盖原文件；如需要先备份。
31. 仅处理 `.png`、`.jpg`、`.jpeg`；其他格式会被静默跳过。
32. 脚本从不自动安装依赖；缺失时打印安装说明并退出。

适用边界 · 注意事项

• 需要 WebP/AVIF 等更高压缩率且目标平台支持时，不必用此技能；它保留 PNG/JPEG 以保证兼容性。
• 必须保留 JPEG 元数据（EXIF、ICC profiles、缩略图）时不要用 jpegoptim 路径，因为它会 `--strip-all`。
• 系统没有 `pngquant`/`jpegoptim` 且无法安装时不要用；脚本不会自动安装依赖。