Baoyu Compress Image

核心功能

baoyu-compress-image 是一款自动化图像压缩技能，专为减少图片体积、优化加载性能而设计。其核心能力包括：

• 智能引擎选择：按优先级自动调用系统工具（macOS sips → Google cwebp → ImageMagick → Node.js Sharp），无需手动配置依赖
• 多格式输出：默认输出 WebP（现代浏览器最优格式），可选 PNG、JPEG
• 灵活质量控制：0-100 质量调节，默认 80 兼顾体积与画质
• 批量递归处理：支持单文件或整目录压缩，-r 递归遍历子文件夹
• 保留原文件：-k/--keep 选项避免覆盖风险

显著优点

| 优势 | 说明 |

|------|------|

| 零配置开箱即用 | 自动探测并链式 fallback 到可用工具 |

| 现代化格式优先 | WebP 压缩率通常比 PNG 高 25-35%，比 JPEG 高 10-20% |

| 层级化配置 | 支持项目级、XDG 标准、用户级三级 EXTEND.md 配置 |

| JSON 输出友好 | `--json` 便于 CI/CD 集成与自动化报告 |

潜在局限

• 依赖外部工具：若系统未预装 sips/cwebp/ImageMagick/Sharp，功能降级或失败
• Bun 运行时要求：需安装 Bun 或允许通过 npx 临时下载
• 无 GUI 界面：纯命令行工具，非技术用户上手门槛较高
• 格式支持有限：暂不支持 AVIF、JPEG XL 等下一代格式

适合人群

• 前端开发者优化网站资源
• CI/CD 流程集成图片压缩
• 需要批量处理图片的运维/内容团队
• 注重性能且熟悉命令行的技术用户

常规风险提示

• 数据覆盖风险：默认不保留原文件，建议首次使用加 -k 验证效果
• 质量损失不可逆：过度压缩（<60）可能导致可见失真
• Bun 网络依赖：npx 模式需网络下载，内网环境需预装 Bun

核心用法

baoyu-compress-image 是一款专注于本地图像压缩的 Agent Skill，采用智能降级策略自动选择最优处理引擎（sips → cwebp → ImageMagick → Sharp）。用户通过 CLI 调用 main.ts 脚本，支持单文件或递归目录批量处理，可灵活指定输出格式（默认 WebP）、质量等级（0-100，默认80）、是否保留原图等参数。运行时自动解析 bun 或 npx 环境，无需复杂配置即可工作。

使用示例：

• 单文件压缩：bun scripts/main.ts image.png
• 指定格式保留原图：bun scripts/main.ts image.png -f png --keep
• 递归目录批量处理：bun scripts/main.ts ./images/ -r -q 75

显著优点

1. 多引擎智能适配：自动检测并优先使用系统原生工具（macOS sips、系统 cwebp），无缝降级到 ImageMagick 和 Node.js sharp 库，跨平台兼容性极佳。

2. 纯本地隐私安全：无任何网络请求，图像数据全程本地处理，符合 GDPR 数据最小化原则，适合对隐私敏感的场景。

3. 零配置开箱即用：自动识别 bun/npx 运行时，支持全局配置（EXTEND.md）和项目级配置，默认参数已针对网页优化场景调优。

4. 批量处理友好：支持递归目录遍历、JSON 结构化输出，便于集成到自动化工作流和 CI/CD 管道。

潜在缺点与局限性

1. 外部依赖较重：依赖系统预装 sips（仅限 macOS）、cwebp、ImageMagick 或 sharp 库，Windows/Linux 环境可能需要额外安装，首次使用配置成本较高。

2. 输入验证基础：仅做文件扩展名检查，缺乏严格的路径遍历防护，特殊构造的符号链接路径可能存在安全风险。

3. 无图像预览功能：纯命令行工具，压缩前无法可视化对比效果，需配合其他工具确认质量。

4. 格式支持有限：主要覆盖 WebP/PNG/JPEG，对 AVIF、HEIC 等新兴格式支持依赖底层工具链。

适合的目标群体

• 前端开发者：优化网页资源，减少图片加载体积
• 内容运营人员：批量压缩文章配图、社交媒体素材
• DevOps 工程师：集成到构建流程自动优化静态资源
• 隐私敏感用户：拒绝云端压缩服务，坚持本地处理

使用风险提醒

• 依赖安全风险：sharp 库需定期更新以修复潜在 CVE
• 路径遍历可能：谨慎处理用户输入的不可信路径
• 大文件 DoS 风险：建议增加文件大小限制防止内存耗尽
• T3 来源项目：个人维护，建议生产环境使用前进行人工审查