核心用法
baoyu-compress-image 是一款命令行图像压缩工具，通过智能工具链调度实现高效本地压缩。用户只需指定输入文件或目录，Skill 会自动检测并按优先级调用系统可用的图像处理工具：macOS 优先使用原生 sips，跨平台场景依次尝试 cwebp、ImageMagick convert，最后回退至 Node.js 的 Sharp 库。支持 WebP（默认）、PNG、JPEG 三种输出格式，质量参数 0-100 可调，默认 80 兼顾体积与画质。批量处理时可通过 --recursive 遍历子目录，--json 输出结构化结果便于脚本集成。配置层面支持三级 EXTEND.md 覆盖机制，满足项目级、XDG 级、用户级的个性化默认设置。
显著优点
智能降级与兼容性：工具链级联设计确保在不同操作系统环境下均有可用方案，无需手动安装特定依赖即可运行。macOS 用户开箱即用，Linux/Windows 用户按需补充 cwebp 或 ImageMagick 即可。
隐私优先的本地处理：全流程零网络请求，图像数据不出本地，符合 GDPR 数据最小化原则，适合处理敏感商业素材或个人隐私照片。
灵活的输出控制：默认覆盖原文件（扩展名变更），--keep 选项保留原始文件为 _original 后缀；JSON 输出模式便于 CI/CD 流水线集成或生成处理报告。
轻量运行时：基于 TypeScript/Bun 构建，代码仅 317 行，启动速度快，内存占用低，适合高频批量处理场景。
潜在缺点与局限性
系统工具依赖：功能高度依赖外部二进制工具（sips/cwebp/convert），若目标环境未安装且 Sharp 动态导入失败，将导致功能不可用。Windows 原生支持较弱，需额外配置 ImageMagick。
无交互式预览：纯 CLI 工具，不支持压缩前后的可视化对比，用户需依赖质量参数经验或事后检查。
格式支持边界：虽覆盖主流 Web/印刷格式，但不支持 AVIF、JPEG XL 等新一代高效格式，对前沿格式需求需另寻方案。
文件名处理逻辑：未启用 --keep 时原文件被重命名而非保留原名，可能打乱依赖固定路径的下游工作流。
适合的目标群体
- 前端开发者：优化 Web 资源包，自动生成 WebP 备用图，提升页面加载性能
- 内容运营/自媒体：批量压缩配图适配各平台上传限制，保持视觉清晰度
- 摄影师/设计师：快速生成轻量预览图或交付版本，避免打开重型编辑软件
- DevOps/运维工程师：集成至构建流水线，实现资源文件的自动化体积管控
- 隐私敏感用户：拒绝云端压缩服务，坚持本地处理个人图像数据
使用风险
文件覆盖风险：默认行为直接替换原文件（扩展名变更），批量操作时若未使用 --keep 且未预览，可能导致原始素材管理混乱。建议重要素材处理前备份或始终启用 --keep。
依赖可用性风险：Sharp 采用动态导入，首次运行需确保网络环境可下载 npm 依赖；离线环境需预装系统工具链。CI/CD 场景需在镜像中预置 cwebp 或 ImageMagick。
质量参数误配：过低质量（<60）设置可能导致视觉损失不可逆，建议关键素材先单张测试再批量应用。
子进程稳定性：spawn 调用系统工具时若遇到超大文件或内存受限环境，可能出现进程挂起，建议设置超时监控。