Back to Details

image-resizer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

技能概述

Skill Overview

技能名称： image-resizer
核心功能： 图片尺寸调整和压缩，支持按像素宽高、比例、最大尺寸进行调整，以及智能压缩到指定文件大小
适用场景：
  • 按指定像素尺寸调整图片（如 800×600）
  • 按比例缩放图片（如 50% 缩小、200% 放大）
  • 限制最大尺寸（保持比例，如最大 1920×1080）
  • 指定宽高比裁剪（如 16:9、4:3）
  • 压缩图片到指定大小（如压缩到 ≤500KB）
  • 批量处理多张图片
Skill Name: image-resizer
Core Features: Image resizing and compression, supporting adjustment by pixel width and height, ratio, maximum size, as well as intelligent compression to a specified file size
Applicable Scenarios:
  • Adjust images to specified pixel dimensions (e.g., 800×600)
  • Scale images by ratio (e.g., 50% reduction, 200% enlargement)
  • Limit maximum size (maintain aspect ratio, e.g., maximum 1920×1080)
  • Crop to specified aspect ratio (e.g., 16:9, 4:3)
  • Compress images to specified size (e.g., compress to ≤500KB)
  • Batch process multiple images

脚本使用说明

Script Usage Instructions

安装依赖

Install Dependencies

bash
cd scripts
npm install
bash
cd scripts
npm install

基本用法

Basic Usage

bash
node resize_image.js <输入图片> [选项]
bash
node resize_image.js <input image> [options]

选项说明

Option Description

参数简写说明示例
--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
ParameterShortcutDescriptionExample
--width
-w
Target width (pixels)
-w 800
--height
-h
Target height (pixels)
-h 600
--scale
-s
Scaling ratio
-s 0.5
--max-width
-Maximum width (maintain aspect ratio)
--max-width 1920
--max-height
-Maximum height (maintain aspect ratio)
--max-height 1080
--quality
-q
Output quality 1-100
-q 80
--size
-S
Target file size (KB), automatic compression
-S 500
--format
-f
Output format: png|jpg|webp|original
-f webp
--output
-o
Output path
-o output.png
--aspect-ratio
-a
Target aspect ratio
-a 16:9
--fit
-Fit mode
--fit cover

适应模式说明

Fit Mode Description

模式说明
cover
填充整个区域（可能裁剪，默认）
contain
完整放入区域内（可能留白）
fill
拉伸填充
inside
完整放入（仅缩小）
outside
完全覆盖（仅放大）
ModeDescription
cover
Fill the entire area (may crop, default)
contain
Fit entirely within the area (may leave blank space)
fill
Stretch to fill
inside
Fit entirely (shrink only)
outside
Cover completely (enlarge only)

使用示例

Usage Examples

示例 1：按指定尺寸调整

Example 1: Adjust to specified dimensions

bash
node resize_image.js input.png -w 800 -h 600 -o output.png
bash
node resize_image.js input.png -w 800 -h 600 -o output.png

示例 2：按比例缩放

Example 2: Scale by ratio

bash
node resize_image.js input.png -s 0.5 -o output.png
bash
node resize_image.js input.png -s 0.5 -o output.png

示例 3：压缩到指定大小

Example 3: Compress to specified size

bash
node resize_image.js input.png -S 500 -o output.jpg
bash
node resize_image.js input.png -S 500 -o output.jpg

示例 4：指定宽高比裁剪

Example 4: Crop to specified aspect ratio

bash
node resize_image.js input.png -a 16:9 -o output.png
bash
node resize_image.js input.png -a 16:9 -o output.png

示例 5：最大尺寸限制（保持比例）

Example 5: Maximum size limit (maintain aspect ratio)

bash
node resize_image.png input.png --max-width 1920 --max-height 1080 -o output.png
bash
node resize_image.png input.png --max-width 1920 --max-height 1080 -o output.png

示例 6：转换为 WebP 并压缩

Example 6: Convert to WebP and compress

bash
node resize_image.js input.png -f webp -q 80 -o output.webp
bash
node resize_image.js input.png -f webp -q 80 -o output.webp

典型工作流程

Typical Workflows

流程 1：生成网站缩略图

Workflow 1: Generate website thumbnails

  1. 读取原始图片
  2. 限制最大宽度为 1200px，保持比例
  3. 压缩到 ≤300KB
  4. 输出为 JPEG 格式
bash
node resize_image.js photo.jpg --max-width 1200 -S 300 -f jpg -o thumbnail.jpg
  1. Read original image
  2. Limit maximum width to 1200px, maintain aspect ratio
  3. Compress to ≤300KB
  4. Output as JPEG format
bash
node resize_image.js photo.jpg --max-width 1200 -S 300 -f jpg -o thumbnail.jpg

流程 2：生成社交媒体图片

Workflow 2: Generate social media images

  1. 读取原始图片
  2. 调整为 1080×1080 正方形
  3. 压缩到 ≤500KB
bash
node resize_image.js input.png -w 1080 -h 1080 -S 500 -o instagram.png
  1. Read original image
  2. Adjust to 1080×1080 square
  3. Compress to ≤500KB
bash
node resize_image.js input.png -w 1080 -h 1080 -S 500 -o instagram.png

流程 3：生成 16:9 横版图片

Workflow 3: Generate 16:9 landscape images

  1. 读取原始图片
  2. 按 16:9 比例裁剪（居中）
  3. 压缩到 ≤200KB
bash
node resize_image.js input.png -a 16:9 -S 200 -o 16_9.jpg
  1. Read original image
  2. Crop to 16:9 ratio (center-aligned)
  3. Compress to ≤200KB
bash
node resize_image.js input.png -a 16:9 -S 200 -o 16_9.jpg

技能文件结构

Skill File Structure

image-resizer/
├── SKILL.md                    # 技能主文件
└── scripts/
    ├── resize_image.js         # 图片处理脚本
    └── package.json            # 依赖配置
image-resizer/
├── SKILL.md                    # Skill main file
└── scripts/
    ├── resize_image.js         # Image processing script
    └── package.json            # Dependency configuration

依赖说明

Dependency Description

  • sharp: 图片处理库，支持 PNG、JPEG、WebP 等格式的转换、裁剪和压缩
  • sharp: Image processing library that supports conversion, cropping, and compression of formats such as PNG, JPEG, WebP, etc.