用途:在用户要求优化、压缩图片、减小图片文件体积或优化 PNG 等场景下,使用现代工具为网页项目优化图片。
主要能力:基于 Sharp(Node.js 图片处理库,底层为 libvips),对 PNG 和 JPEG 进行压缩并尽量保持视觉质量;脚本会递归查找所有 PNG/JPEG 图片、应用压缩设置、仅在结果更小时覆盖原文件,并报告每个文件的节省量和总节省汇总。
必要用法:安装 Sharp 使用 bun add -d sharp 或 npm install -D sharp。先基准测量(如 du -sh public/images/),再对单张图片试运行:bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/optimize-images/scripts/optimize-images.ts --file=public/images/largest-image.png --dry-run,确认后运行完整优化命令。脚本支持 --dry-run 和 --file= 参数。
PNG 可设置 quality、compressionLevel、adaptiveFiltering、palette;JPEG 可设置 quality 和 mozjpeg。资料给出参考质量:截图 80、照片 75-80、Hero 图 85。
适用场景:生产部署前的图片准备、降低页面加载时间、优化 public/images 目录、批量压缩截图/水彩/照片、优化前后体积审计;也可配合预提交钩子或 CI/CD 体积检查。
限制与注意事项:不要在上下文中回读优化后的图片,以避免占满上下文;需要质量确认时让用户目视检查。透明 PNG 复杂时可用 palette: false。macOS 上如遇 Sharp 安装问题可执行 brew install vips 或 npm rebuild sharp。资料未提供价格与具体平台支持信息。