Image Optimizer Tool

v1.0.0

图片批量压缩和格式转换工具,支持批量调整大小、压缩质量、转换格式,预览模式和撤销功能!

0· 335· 1 versions· 0 current· 0 all-time· Updated 12h ago· MIT-0

Install

openclaw skills install image-optimizer-tool

image-optimizer - 图片批量压缩和格式转换工具

图片批量压缩和格式转换工具,支持多种操作模式,预览模式和撤销功能!

功能特性

  • 批量调整图片大小:按宽度、高度或最大尺寸等比例缩放
  • 批量压缩图片质量:可调节压缩级别(1-100)
  • 批量转换图片格式:PNG ↔ JPEG ↔ WebP 互转
  • 预览模式:不实际修改文件,只显示操作预览
  • 撤销功能:自动备份原始文件,支持一键撤销
  • 递归处理:支持处理子文件夹中的图片

安装

# 安装依赖
pip install Pillow

使用方法

基本用法

# 压缩当前目录下所有 JPEG 图片,质量 85
python source/image_optimizer.py --quality 85

# 调整图片宽度最大为 1920px
python source/image_optimizer.py --max-width 1920

# 转换所有图片为 WebP 格式
python source/image_optimizer.py --format webp

# 预览模式(不实际修改)
python source/image_optimizer.py --quality 80 --preview

# 撤销上次操作
python source/image_optimizer.py --undo

详细参数

--directory DIRECTORY, -d DIRECTORY
                        要处理的目录(默认:当前目录)
--quality QUALITY, -q QUALITY
                        压缩质量 1-100(默认:85)
--max-width MAX_WIDTH   最大宽度(像素)
--max-height MAX_HEIGHT 最大高度(像素)
--max-size MAX_SIZE     最大边长(像素,同时限制宽高)
--format {png,jpeg,webp}, -f {png,jpeg,webp}
                        输出格式
--recursive, -r         递归处理子文件夹
--preview, -p           预览模式,不实际修改文件
--undo, -u              撤销上次操作
--output-dir OUTPUT_DIR
                        输出目录(不覆盖原文件)
--extensions EXTENSIONS
                        要处理的文件扩展名,逗号分隔(默认:jpg,jpeg,png,webp)

示例

# 压缩当前目录所有图片,质量 80,最大宽度 1920px
python source/image_optimizer.py -q 80 --max-width 1920

# 转换为 WebP 格式并保存到新文件夹
python source/image_optimizer.py -f webp --output-dir ./optimized

# 递归处理所有子文件夹
python source/image_optimizer.py -q 75 -r

# 只处理 PNG 文件
python source/image_optimizer.py -q 90 --extensions png

支持的格式

  • 输入:JPEG, PNG, WebP, BMP, TIFF
  • 输出:JPEG, PNG, WebP

注意事项

  • 原始文件会自动备份到 ./.image_optimizer_backup/ 目录
  • 撤销功能只能撤销最近一次操作
  • WebP 格式支持透明度,JPEG 不支持
  • 大图片处理可能需要较长时间

Version tags

latestvk977f8prxrsyaj6qhzm249evd582wzht

Runtime requirements

🖼️ Clawdis