baoyu-compress-image

baoyu-compress-image

热门

将图像压缩为 WebP(默认)或 PNG,并自动选择最佳工具。当用户要求“压缩图片”、“优化图片”、“转换为 webp”或减小图片文件大小时使用。

2.2万Star
2606Fork
更新于 2026/6/18
SKILL.md
只读
名称
baoyu-compress-image
描述

将图像压缩为 WebP(默认)或 PNG,并自动选择最佳工具。当用户要求“压缩图片”、“优化图片”、“转换为 webp”或减小图片文件大小时使用。

版本
1.56.1

图像压缩工具

使用最佳可用工具(sips → cwebp → ImageMagick → Sharp)压缩图像。

脚本目录

脚本位于 scripts/ 子目录中。{baseDir} 表示此 SKILL.md 文件所在的目录路径。解析 ${BUN_X} 运行时:如果安装了 bun,则使用 bun;如果 npx 可用,则使用 npx -y bun;否则建议安装 bun。请将 {baseDir}${BUN_X} 替换为实际值。

脚本 用途
scripts/main.ts 图像压缩命令行工具

偏好设置(EXTEND.md

按优先级顺序检查 EXTEND.md,找到的第一个生效:

优先级 路径 范围
1 .baoyu-skills/baoyu-compress-image/EXTEND.md 项目
2 ${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-compress-image/EXTEND.md XDG
3 $HOME/.baoyu-skills/baoyu-compress-image/EXTEND.md 用户主目录

如果未找到,则使用默认值。

EXTEND.md 支持:默认格式、默认质量、保留原始文件偏好。

用法

${BUN_X} {baseDir}/scripts/main.ts <input> [选项]

选项

选项 缩写 描述 默认值
<input> 文件或目录 必填
--output -o 输出路径 相同路径,新扩展名
--format -f webp、png、jpeg webp
--quality -q 质量 0-100 80
--keep -k 保留原始文件 false
--recursive -r 处理子目录 false
--json JSON 输出 false

示例

# 单个文件 → WebP(替换原始文件)
${BUN_X} {baseDir}/scripts/main.ts image.png

# 保持 PNG 格式
${BUN_X} {baseDir}/scripts/main.ts image.png -f png --keep

# 目录递归处理
${BUN_X} {baseDir}/scripts/main.ts ./images/ -r -q 75

# JSON 输出
${BUN_X} {baseDir}/scripts/main.ts image.png --json

输出示例

image.png → image.webp (245KB → 89KB, 缩小 64%)

扩展支持

通过 EXTEND.md 进行自定义配置。请参阅偏好设置部分了解路径和受支持的选项。