- name
- image-resizer
- description
- 图片尺寸调整和压缩工具技能。用于按指定像素宽高、比例或最大尺寸限制调整图片大小，并支持智能压缩到指定文件大小。适用于需要批量处理图片、生成特定尺寸缩略图、压缩图片以满足文件大小限制等场景。
技能概述
技能名称： image-resizer 核心功能： 图片尺寸调整和压缩，支持按像素宽高、比例、最大尺寸进行调整，以及智能压缩到指定文件大小 适用场景：
- 按指定像素尺寸调整图片（如 800×600）
- 按比例缩放图片（如 50% 缩小、200% 放大）
- 限制最大尺寸（保持比例，如最大 1920×1080）
- 指定宽高比裁剪（如 16:9、4:3）
- 压缩图片到指定大小（如压缩到 ≤500KB）
- 批量处理多张图片
脚本使用说明
安装依赖
cd scripts
npm install
基本用法
node resize_image.js <输入图片> [选项]
选项说明
| 参数 | 简写 | 说明 | 示例 |
|---|
--width | -w | 目标宽度（像素） | -w 800 |
--height | -h | 目标高度（像素） | -h 600 |
--scale | -s | 缩放比例 | -s 0.5 |
--max-width | - | 最大宽度（保持比例） | --max-width 1920 |
--max-height | - | 最大高度（保持比例） | --max-height 1080 |
--quality | -q | 输出质量 1-100 | -q 80 |
--size | -S | 目标文件大小（KB），自动压缩 | -S 500 |
--format | -f | 输出格式：png\ | jpg\ | webp\ | original | -f webp |
--output | -o | 输出路径 | -o output.png |
--aspect-ratio | -a | 目标宽高比 | -a 16:9 |
--fit | - | 适应模式 | --fit cover |
适应模式说明
| 模式 | 说明 |
|---|
cover | 填充整个区域（可能裁剪，默认） |
contain | 完整放入区域内（可能留白） |
fill | 拉伸填充 |
inside | 完整放入（仅缩小） |
outside | 完全覆盖（仅放大） |
使用示例
示例 1：按指定尺寸调整
node resize_image.js input.png -w 800 -h 600 -o output.png
示例 2：按比例缩放
node resize_image.js input.png -s 0.5 -o output.png
示例 3：压缩到指定大小
node resize_image.js input.png -S 500 -o output.jpg
示例 4：指定宽高比裁剪
node resize_image.js input.png -a 16:9 -o output.png
示例 5：最大尺寸限制（保持比例）
node resize_image.png input.png --max-width 1920 --max-height 1080 -o output.png
示例 6：转换为 WebP 并压缩
node resize_image.js input.png -f webp -q 80 -o output.webp
典型工作流程
流程 1：生成网站缩略图
- 读取原始图片
- 限制最大宽度为 1200px，保持比例
- 压缩到 ≤300KB
- 输出为 JPEG 格式
node resize_image.js photo.jpg --max-width 1200 -S 300 -f jpg -o thumbnail.jpg
流程 2：生成社交媒体图片
- 读取原始图片
- 调整为 1080×1080 正方形
- 压缩到 ≤500KB
node resize_image.js input.png -w 1080 -h 1080 -S 500 -o instagram.png
流程 3：生成 16:9 横版图片
- 读取原始图片
- 按 16:9 比例裁剪（居中）
- 压缩到 ≤200KB
node resize_image.js input.png -a 16:9 -S 200 -o 16_9.jpg
技能文件结构
image-resizer/
├── SKILL.md # 技能主文件
└── scripts/
├── resize_image.js # 图片处理脚本
└── package.json # 依赖配置
依赖说明
- sharp: 图片处理库，支持 PNG、JPEG、WebP 等格式的转换、裁剪和压缩
