tuzi-compress-image：高效图像压缩工具，支持WebP/PNG/JPEG格式转换与批量处理

tuzi-compress-image by tuziapi/tuzi-skills

74 周安装量

24 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/tuziapi/tuzi-skills --skill tuzi-compress-image

图像处理命令行工具性能优化

🇨🇳中文介绍

图像压缩器

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

脚本目录

脚本位于 scripts/ 子目录中。请将 ${SKILL_DIR} 替换为此 SKILL.md 文件的目录路径。

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

偏好设置 (EXTEND.md)

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

# 首先检查项目级别
test -f .tuzi-skills/tuzi-compress-image/EXTEND.md && echo "project"

# 然后检查用户级别（跨平台：$HOME 在 macOS/Linux/WSL 上均适用）
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 │ 用户主目录 │ └────────────────────────────────────────────────────────┴───────────────────┘

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

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

🇺🇸English

Image Compressor

Compresses images using best available tool (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

Preferences (EXTEND.md)

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

# 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

Usage

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`

Examples

# 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)

Extension Support

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

Weekly Installs

Repository

tuziapi/tuzi-skills

GitHub Stars

First Seen

Mar 5, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

openclaw58

opencode45

gemini-cli45

github-copilot45

amp45

cline45