baoyu-compress-image

baoyu-compress-image - 图片压缩与格式转换工具

技能概述

baoyu-compress-image 是一款智能图片压缩命令行工具，支持将图片转换为 WebP、PNG 或 JPEG 格式，自动选择最佳压缩引擎（sips → cwebp → ImageMagick → Sharp），帮助您快速减小图片体积。

适用场景

网站资源优化

批量压缩项目中的图片资源，减小页面加载体积。支持递归处理整个目录结构，自动转换为 WebP 格式以获得最佳压缩率。

图片格式标准化

将混合格式的图片资源统一转换为 WebP 或指定格式，便于项目管理和 CDN 分发。可选择保留原文件或直接替换。

内容创作者批量处理

对博客文章、电商产品图或设计稿进行批量压缩和质量调整，减少存储占用和传输带宽，提升用户访问体验。

核心功能

智能工具自动选择

自动检测并使用系统中可用的最佳压缩引擎：优先使用 macOS 原生 sips，其次是 cwebp、ImageMagick 或 Sharp，无需手动安装依赖。

灵活的质量控制与格式转换

支持 0-100 的质量参数调节，默认 80；可在 WebP、PNG、JPEG 之间自由转换。通过 --keep 选项决定是否保留原文件。

目录递归处理与 JSON 输出

使用 -r 递归处理子目录下的所有图片，--json 输出结构化压缩结果，便于集成到 CI/CD 流程或自动化脚本中。

常见问题

baoyu-compress-image 支持哪些图片格式？

工具支持常见的图片格式输入和输出，包括 PNG、JPEG、JPG 等主流格式。输出格式可选择 WebP（默认）、PNG 或 JPEG。输入格式支持由选中的压缩引擎决定，通常覆盖常见的 Web 图片格式。

如何批量压缩文件夹中的所有图片？

使用 -r 或 --recursive 参数可以递归处理指定目录及其子目录下的所有图片。例如：npx -y bun ${SKILL_DIR}/scripts/main.ts ./images/ -r 将处理 images 目录下的所有图片。

压缩后能看到节省了多少空间吗？

可以。使用 --json 参数可获得结构化的压缩结果输出，显示原文件大小、压缩后大小和压缩百分比。普通模式也会在终端显示如 (245KB → 89KB, 64% reduction) 的压缩统计信息。