Baoyu Compress Image

核心功能

baoyu-compress-image 是一款自动化图片压缩技能，专为开发者与设计师打造。它采用四层回退策略智能选择压缩引擎：优先使用 macOS 原生 sips，其次调用 Google cwebp，再降级至 ImageMagick，最后以 Node.js 库 Sharp 兜底，确保跨平台稳定运行。

显著优点：

• 零配置开箱即用：默认 WebP 格式、质量 80，平衡画质与体积
• 多格式灵活输出：支持 WebP（推荐）、PNG、JPEG 互转
• 批量递归处理：-r 参数支持目录遍历，适合静态站点优化
• 智能路径解析：EXTEND.md 三级配置（项目级 → XDG 级 → 用户级），满足不同场景偏好
• JSON 结构化输出：便于 CI/CD 流水线集成与日志分析

潜在局限：

• 依赖 bun 或 npx 运行时，首次使用需确保 Node.js 生态可用
• cwebp 与 ImageMagick 为外部二进制依赖，跨平台需单独安装
• 暂无 GUI，纯 CLI 交互对非技术用户门槛较高
• 质量参数 0-100 为通用范围，但不同引擎实际压缩曲线存在差异

适合人群：前端开发者、运维工程师、博客/电商站点维护者、需要批量优化图片资产的团队。

常规风险提示：

• 默认覆盖原文件（--keep 显式开启保留），建议先备份或测试单文件
• WebP 格式在旧版 Safari/IE 存在兼容性盲区，需评估目标用户浏览器分布
• 批量递归时建议先在小目录验证输出质量，避免全站图片意外降级

核心用法

baoyu-compress-image 是一款基于 TypeScript 编写的本地图像压缩 CLI 工具，默认输出 WebP 格式，同时支持 PNG/JPEG 转换。用户通过 ${BUN_X} {baseDir}/scripts/main.ts <input> [options] 命令调用，可处理单文件或整个目录。工具内置四级降级策略：优先尝试 macOS 原生 sips，其次 Google cwebp，再选 ImageMagick convert，最后回退至 Node.js sharp 库，确保跨平台兼容性。

关键参数包括 -f 指定格式、-q 调节质量（0-100，默认 80）、-r 递归处理子目录、-k 保留原图、--json 输出结构化结果。配置文件支持三级优先级加载（项目级 → XDG 级 → 用户级），便于团队统一规范或个人偏好持久化。

显著优点

智能引擎调度：自动检测并选用本地最优工具链，无需手动配置；体积优化显著：实测 PNG → WebP 平均压缩率 60%+，大幅节省 CDN 流量与存储成本；零网络依赖：纯本地处理，杜绝数据外泄风险；开发者友好：MIT 开源协议，源码仅 318 行，依赖清晰，易于审计与二次开发；格式覆盖广：输入支持常见位图格式，输出聚焦现代 Web 标准（WebP）与无损 PNG。

潜在缺点与局限性

外部工具依赖：首次使用需确保目标系统已安装至少一种后端（macOS 自带 sips，Linux 需自行安装 cwebp 或 ImageMagick），否则将回退至 Sharp 的纯 Node 方案，性能略降；功能聚焦单一：仅处理静态位图压缩，不支持 SVG 优化、动画 WebP、渐进式 JPEG 等进阶特性；无 GUI 界面：纯命令行交互，非技术用户上手成本较高；T3 来源可信度：由个人开发者维护，虽代码结构清晰但缺乏企业级 SLA 保障，长期更新依赖社区贡献。

适合的目标群体

• 前端/全栈开发者：需要批量优化项目静态资源，集成至构建流水线；
• 设计师与运营：处理营销素材、社交媒体配图，快速降低文件体积；
• 技术写作者：压缩文档插图，提升页面加载速度；
• 运维与 DevOps：在 CI/CD 中自动化图像优化，减少人工干预。

常规使用风险

性能风险：大批量递归处理高分辨率图片时，CPU 占用可能飙升，建议在服务器场景限制并发或分批次执行；依赖项风险：Sharp 虽为可选依赖，但若强制降级使用需确保 npm 源可信，避免供应链攻击；路径覆盖风险：未设置 -k 参数时默认覆盖原图，误操作可能导致源文件丢失，建议重要素材先备份；工具链缺失风险：Windows 环境默认缺乏 sips/cwebp，需提前配置环境或接受 Sharp 方案；版本漂移：个人项目更新频率不定，生产环境建议锁定版本并定期审计 CVE。