tuzi-compress-image

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Image Compressor

图片压缩工具

Compresses images using best available tool (sips → cwebp → ImageMagick → Sharp).

采用最优可用工具压缩图片（优先级：sips → cwebp → ImageMagick → Sharp）。

Script Directory

脚本目录

Scripts in

scripts/

subdirectory. Replace

${SKILL_DIR}

with this SKILL.md's directory path.

Script	Purpose
`scripts/main.ts`	Image compression CLI

脚本位于

scripts/

子目录中。请将

${SKILL_DIR}

替换为当前SKILL.md文件所在的目录路径。

脚本	用途
`scripts/main.ts`	图片压缩CLI

Preferences (EXTEND.md)

偏好设置（EXTEND.md）

Use Bash to check EXTEND.md existence (priority order):

bash

undefined

使用Bash检查EXTEND.md文件是否存在（优先级顺序）：

bash

undefined

Check project-level first

test -f .tuzi-skills/tuzi-compress-image/EXTEND.md && echo "project"

Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)

test -f "$HOME/.tuzi-skills/tuzi-compress-image/EXTEND.md" && echo "user"


┌────────────────────────────────────────────────────────┬───────────────────┐
│                          Path                          │     Location      │
├────────────────────────────────────────────────────────┼───────────────────┤
│ .tuzi-skills/tuzi-compress-image/EXTEND.md           │ Project directory │
├────────────────────────────────────────────────────────┼───────────────────┤
│ $HOME/.tuzi-skills/tuzi-compress-image/EXTEND.md     │ User home         │
└────────────────────────────────────────────────────────┴───────────────────┘

┌───────────┬───────────────────────────────────────────────────────────────────────────┐
│  Result   │                                  Action                                   │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│ Found     │ Read, parse, apply settings                                               │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│ Not found │ Use defaults                                                              │
└───────────┴───────────────────────────────────────────────────────────────────────────┘

**EXTEND.md Supports**: Default format | Default quality | Keep original preference

test -f "$HOME/.tuzi-skills/tuzi-compress-image/EXTEND.md" && echo "user"


┌────────────────────────────────────────────────────────┬───────────────────┐
│                          路径                          │     位置          │
├────────────────────────────────────────────────────────┼───────────────────┤
│ .tuzi-skills/tuzi-compress-image/EXTEND.md           │ 项目目录          │
├────────────────────────────────────────────────────────┼───────────────────┤
│ $HOME/.tuzi-skills/tuzi-compress-image/EXTEND.md     │ 用户主目录        │
└────────────────────────────────────────────────────────┴───────────────────┘

┌───────────┬───────────────────────────────────────────────────────────────────────────┐
│   结果    │                                  操作                                   │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│  已找到   │ 读取、解析并应用设置                                                     │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│  未找到   │ 使用默认设置                                                              │
└───────────┴───────────────────────────────────────────────────────────────────────────┘

**EXTEND.md支持配置**：默认格式 | 默认质量 | 是否保留原文件偏好

Usage

使用方法

bash

npx -y bun ${SKILL_DIR}/scripts/main.ts <input> [options]

bash

npx -y bun ${SKILL_DIR}/scripts/main.ts <input> [options]

Options

选项

Option	Short	Description	Default
`<input>`		File or directory	Required
`--output`	`-o`	Output path	Same path, new ext
`--format`	`-f`	webp, png, jpeg	webp
`--quality`	`-q`	Quality 0-100	80
`--keep`	`-k`	Keep original	false
`--recursive`	`-r`	Process subdirs	false
`--json`		JSON output	false

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

Examples

示例

bash

undefined

bash

undefined

Single file → WebP (replaces original)

npx -y bun ${SKILL_DIR}/scripts/main.ts image.png

Keep PNG format

npx -y bun ${SKILL_DIR}/scripts/main.ts image.png -f png --keep

Directory recursive

npx -y bun ${SKILL_DIR}/scripts/main.ts ./images/ -r -q 75

JSON output

npx -y bun ${SKILL_DIR}/scripts/main.ts image.png --json


**Output**:

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

undefined

npx -y bun ${SKILL_DIR}/scripts/main.ts image.png --json


**输出示例**:

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

undefined

Extension Support

扩展支持

Custom configurations via EXTEND.md. See Preferences section for paths and supported options.

通过EXTEND.md进行自定义配置。路径及支持的选项请查看偏好设置章节。