ComfyUI Image Compressor Node

English | 中文

一个用于图像压缩的ComfyUI自定义节点，支持多种压缩格式和参数调整。

直接拖入ComfyUI

功能特点

• 支持多种图像格式（PNG、WEBP、JPEG）的压缩
• 可调整图像质量和压缩级别
• 支持图像尺寸调整
• 自定义输出路径和文件名前缀
• 显示压缩前后的文件大小
• 支持批量图像处理
• 自动处理透明通道
• 智能处理多种输入格式（RGB/RGBA）

安装方法

1. 将本插件复制到 ComfyUI 的 custom_nodes 目录下
2. 重启 ComfyUI
3. 在节点列表中找到压缩节点:
   • 路径: image/Image Compressor (单图压缩节点)
   • 路径: image/Batch Image Compressor (批量压缩节点)

节点类型

单图压缩节点 (Image Compressor)

输入参数

• images: 输入图像（支持单张或批量图像）
• format: 输出格式选择（PNG/WEBP/JPEG）
• quality: 压缩质量（1-100）
• resize_factor: 尺寸调整因子（0.1-1.0）
• compression_level: 压缩级别（0-9，仅PNG格式有效）
• save_image: 是否保存压缩后的图像文件（默认：是）
• output_prefix: 输出文件名前缀（默认：compressed_）
• output_path: 自定义输出路径
  • 绝对路径：直接使用该路径
    • 例如：D:/my_images/compressed
  • 相对路径：基于 ComfyUI 的 output 目录
    • 例如：my_folder → output/my_folder
    • 例如：compressed/png → output/compressed/png
  • 留空：默认使用 output/compressed 目录

输出信息

• compression_info: 压缩信息字符串，包含:
  • 压缩后的文件大小
  • 原始文件大小
  • 保存路径（如果启用了保存）
  • 压缩比率信息

批量压缩节点 (Batch Image Compressor)

输入参数

• input_path: 输入图像目录路径
  • 支持处理目录下的所有图像文件
  • 自动识别 PNG、JPEG、WEBP 格式
  • 会递归处理子目录中的图像
• save_image: 是否保存压缩后的图像文件（默认：是）
• output_prefix: 输出文件名前缀（默认：compressed_）
• output_path: 自定义输出路径
  • 绝对路径：直接使用该路径
    • 例如：D:/my_images/compressed
  • 相对路径：基于 ComfyUI 的 output 目录
    • 例如：my_folder → output/my_folder
    • 例如：compressed/png → output/compressed/png
  • 留空：默认使用 output/compressed 目录

输出信息

• compression_info: 压缩信息字符串，包含:
  • 压缩后的文件大小
  • 原始文件大小
  • 保存路径（如果启用了保存）
  • 压缩比率信息

通用压缩参数

格式选择 (format)

• PNG: 无损压缩，适合需要保持图像质量的场景

  • 优点：无损压缩，支持透明度
  • 缺点：文件体积相对较大
  • 适用场景：图标、截图、需要保持完美质量的图像
  • 特点：使用compression_level参数控制压缩强度

• WEBP: Google开发的现代图像格式

  • 优点：较好的压缩率，支持有损和无损压缩，支持透明度
  • 缺点：兼容性可能不如PNG和JPEG
  • 适用场景：网页图像、需要在质量和体积间平衡的场景
  • 特点：同时支持quality和alpha_quality参数

• JPEG: 常用的有损压缩格式

  • 优点：高压缩率，文件体积小
  • 缺点：有损压缩，不支持透明度（透明部分会被转换为白色背景）
  • 适用场景：照片、不需要透明度的图像
  • 特点：使用quality参数和优化的子采样设置

质量控制

• quality: 压缩质量（1-100，默认：85）

  • 对 JPEG 和 WEBP 格式有效
  • 值越高，质量越好，文件越大
  • 建议值：
    • 高质量：85-95
    • 平衡质量：75-85
    • 高压缩：60-75

• compression_level: PNG压缩级别（0-9，默认：6）

  • 只对 PNG 格式有效
  • 值越高，压缩率越高，但压缩时间更长
  • 建议值：
    • 快速压缩：3-4
    • 平衡压缩：6
    • 最大压缩：9

• resize_factor: 尺寸调整因子（0.1-1.0，默认：1.0）

  • 1.0 表示保持原始尺寸
  • 小于 1.0 时会按比例缩小图像
  • 可用于通过降低分辨率来减小文件大小

使用建议

1. 格式选择:

   • 需要无损压缩：使用 PNG
   • 网页图像：优先使用 WEBP
   • 照片类图像：使用 JPEG

2. 质量设置:

   • PNG：调整 compression_level，建议使用 6-9
   • WEBP：quality 设置 80-90 可获得较好的平衡
   • JPEG：quality 设置 75-85 通常够用

3. 文件大小优化:

   • 首先尝试调整 quality 参数
   • 如果仍然太大，可以考虑调整 resize_factor
   • 最后考虑更换压缩格式

注意事项

• 输出目录会自动创建
• 文件名包含时间戳和计数器，确保不会覆盖已有文件
• 建议根据具体使用场景选择合适的压缩参数