用途:tuzi-compress-image 是一个图片压缩 CLI 技能,用于把单个文件或整个目录的图片压缩为指定格式,默认输出 WebP,也可选 png、jpeg,常用于“压缩图片”“优化图片”“转换为 webp”或减小图片体积。
主要能力:脚本会自动选择当前环境可用的压缩工具,依次尝试 sips、cwebp、ImageMagick、Sharp。支持设置输出路径、格式、质量(0-100,默认 80)、是否保留原图、是否递归处理子目录,以及 JSON 格式输出。示例输出:image.png → image.webp(245KB → 89KB,64% reduction)。
使用方式:通过以下命令调用,把 ${SKILL_DIR} 替换为该 SKILL.md 所在目录路径: npx -y bun ${SKILL_DIR}/scripts/main.ts <input> [options] 常用选项:--output/-o 输出路径;--format/-f 指定 webp、png、jpeg;--quality/-q 质量;--keep/-k 保留原图;--recursive/-r 处理子目录;--json 输出 JSON。示例:npx -y bun ${SKILL_DIR}/scripts/main.ts image.png;加 -f png --keep 可保留 PNG 并保留原图;加 ./images/ -r -q 75 可递归处理目录。
配置:可在项目级 .tuzi-skills/tuzi-compress-image/EXTEND.md 或用户级 $HOME/.tuzi-skills/tuzi-compress-image/EXTEND.md 提供 EXTEND.md,支持设置默认格式、默认质量和是否保留原图。若不存在则使用默认值。
适用场景与限制:适合批量图片体积优化与格式转换;实际可用压缩后端取决于系统是否安装对应工具,资料未提供具体安装依赖说明、性能上限或错误处理细节。