图像压缩

技能文档

---
name: baoyu-compress-image
title: 图像压缩
category: 开发工具
description: 使用最佳可用工具将图像压缩为 WebP（默认）或 PNG 格式，自动选择最优压缩方案。当用户要求"压缩图像"、"优化图片"、"转换为 webp"或减小图片文件大小时触发。触发词：压缩图像、优化图片、转换 webp、图片压缩、减小图片大小
---

# 图像压缩

使用最佳可用工具压缩图像（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 支持的配置项**：默认格式、默认质量、是否保留原图。

## 用法

```bash
${BUN_X} {baseDir}/scripts/main.ts <input> [options]
```

## 选项

| 选项 | 缩写 | 说明 | 默认值 |
|--------|-------|-------------|---------|
| `<input>` | | 输入文件或目录 | 必填 |
| `--output` | `-o` | 输出路径 | 同路径，新扩展名 |
| `--format` | `-f` | webp、png、jpeg | webp |
| `--quality` | `-q` | 质量 0-100 | 80 |
| `--keep` | `-k` | 保留原文件 | false |
| `--recursive` | `-r` | 递归处理子目录 | false |
| `--json` | | JSON 格式输出 | false |

## 示例

```bash
# 单文件 -> 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 进行自定义配置。路径和支持的选项请参阅**偏好配置**部分。

使用说明

# 图像压缩

使用最佳可用工具将图像压缩为 WebP 或 PNG 格式，自动选择最优压缩方案。

## 使用

```bash
${BUN_X} {baseDir}/scripts/main.ts <input> [options]
```

常用示例：

```bash
# 单文件压缩为 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
```

## 工作原理

按优先级自动选择可用的最佳压缩工具（sips -> cwebp -> ImageMagick -> Sharp），支持 WebP、PNG、JPEG 格式输出，可配置压缩质量、批量递归处理和 JSON 格式输出。通过 EXTEND.md 文件支持项目级和用户级自定义配置。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。