%20(1).png)
ComfyUI-DataCleaning 插件完全新手教程
1. 插件简介
原始地址： https://github.com/Jacky-MYQ/comfyui-DataCleaning
ComfyUI-DataCleaning 是一个超级实用的图片处理插件，就像给你的 ComfyUI 装了一个专业的图片修剪工具。它主要能帮你做两件事：
- 图片裁剪：就像用剪刀把照片剪成你想要的形状和大小
- 图片调整大小：就像把照片放大或缩小到合适的尺寸
这个插件最大的特点是保护你的个人数据安全，你可以在本地处理图片，不用担心隐私泄露。而且操作超级简单，就算是第一次用 ComfyUI 的朋友也能轻松上手。
2. 如何安装
方法一：手动安装（推荐新手）
- 打开你的 ComfyUI 安装文件夹
- 找到
custom_nodes文件夹（就像一个专门放插件的抽屉） - 把这个插件下载到该文件夹里
- 打开命令行，输入：
pip install Pillow（这是插件需要的小工具）
方法二：使用 ComfyUI-Manager（更简单）
- 在 ComfyUI 界面中找到 Manager 管理器
- 搜索 "DataCleaning"
- 点击安装即可
3. 节点详细解析
3.1 图片裁剪节点 (Image Crop Node)
这个节点就像一个智能剪刀，能让你精确地剪切图片的任何部分。
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 选择图片 | select_images | 按钮操作 | - | 就像打开相册选照片一样 | 文件选择器功能 | 点击按钮选择要处理的图片，或者直接拖拽图片到节点上 |
| 裁剪框 | crop_box | 可调整区域 | 根据需要 | 就像在照片上画一个框，框里的部分会被保留 | 定义裁剪区域的坐标 | 用鼠标拖拽调整框的大小和位置 |
| 删除按钮 | delete_button | 按钮操作 | - | 就像垃圾桶，不要的图片可以扔掉 | 删除选中的图片 | 点击图片下方的删除按钮 |
| 保存按钮 | save_button | 按钮操作 | - | 就像保存文档一样，把处理好的图片存起来 | 保存单张图片 | 点击图片下方的保存按钮 |
| 保存路径 | save_img_path | 文件夹路径 | 自定义路径 | 就像选择把文件放在哪个文件夹里 | 设置图片保存的目录路径 | 输入你想保存图片的文件夹路径，比如 "C:\我的图片\" |
| 批量保存 | save_images | 按钮操作 | - | 就像一键保存所有照片 | 批量保存所有处理过的图片 | 处理完所有图片后点击这个按钮 |
3.3 图片大小调整节点 (Image Resize Node)
这个节点就像一个神奇的放大镜和缩小器，能让图片变大或变小。
3.4 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | input_image | 图片文件 | - | 就像把照片放进相框一样 | 接收需要调整大小的图片 | 连接其他节点的图片输出 |
| 目标宽度 | target_width | 数字 | 512-1024 | 就像设置照片的宽度有多少厘米 | 设置输出图片的宽度像素 | 输入 512 表示图片宽度为 512 像素 |
| 目标高度 | target_height | 数字 | 512-1024 | 就像设置照片的高度有多少厘米 | 设置输出图片的高度像素 | 输入 512 表示图片高度为 512 像素 |
| 保持比例 | keep_aspect | 开关 | True | 就像保持照片不变形，人不会变胖变瘦 | 保持图片的长宽比例 | 打开后图片不会变形，关闭后可能会拉伸 |
| 缩放模式 | resize_mode | 选择列表 | "Lanczos" | 就像选择不同的放大镜质量 | 图片缩放的算法方式 | Lanczos 质量最好，Nearest 速度最快 |
3.5 数据清理节点 (Data Cleaning Node)
这个节点就像一个智能清洁工，能帮你整理和清理图片数据。
3.6 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入文件夹 | input_folder | 文件夹路径 | 自定义路径 | 就像选择要整理的相册文件夹 | 指定包含图片的源文件夹 | 输入图片所在的文件夹路径 |
| 输出文件夹 | output_folder | 文件夹路径 | 自定义路径 | 就像选择整理好的照片放在哪里 | 指定处理后图片的保存位置 | 输入你想保存处理后图片的文件夹 |
| 清理模式 | clean_mode | 选择列表 | "auto" | 就像选择不同的清理方式 | 设置数据清理的方式 | auto 自动清理，manual 手动选择 |
| 图片格式 | image_format | 选择列表 | "jpg" | 就像选择照片的格式 | 设置输出图片的文件格式 | jpg 适合照片，png 适合透明图片 |
| 质量设置 | quality | 数字 | 85 | 就像设置照片的清晰度 | 设置图片压缩质量 | 100 最清晰但文件大，50 文件小但不太清晰 |
4. 使用技巧和建议
4.1 新手使用建议
- 先试试单张图片：刚开始使用时，建议先用一张图片测试，熟悉了再批量处理
- 备份原图：处理之前记得备份原始图片，就像复印文件一样
- 合理设置保存路径：建议创建专门的文件夹来保存处理后的图片
4.2 效果优化技巧
- 裁剪时注意构图：裁剪时要注意保持画面的美观和完整性
- 调整大小时保持比例：除非有特殊需要，建议总是保持图片比例
- 选择合适的质量：如果是用于网络分享，质量 75-85 就够了；如果是打印，建议 90-100
4.3 批量处理技巧
- 统一命名：处理前给图片统一命名，方便管理
- 分批处理：如果图片很多，建议分批处理，避免软件卡顿
- 定期清理：定期清理临时文件，保持系统整洁
5. 常见问题解答
Q1: 插件安装后找不到节点？
A: 重启 ComfyUI，然后在节点列表中搜索 "DataCleaning" 或 "数据清理"。
Q2: 处理大图片时软件很慢？
A: 这是正常现象，大图片需要更多时间处理。建议先缩小图片尺寸再处理。
Q3: 保存的图片质量不好？
A: 检查质量设置，建议设置为 85-95 之间。数字越大质量越好，但文件也越大。
Q4: 批量处理时出错？
A: 检查保存路径是否正确，确保文件夹存在且有写入权限。
Q5: 裁剪后的图片尺寸不对？
A: 检查是否开启了"保持比例"选项，关闭后可以自由调整尺寸。
6. 进阶使用建议
6.1 工作流程优化
建议的使用流程： 1. 先用裁剪节点处理构图 2. 再用调整大小节点统一尺寸 3. 最后用数据清理节点整理输出
6.2 与其他节点配合
这个插件可以很好地与以下节点配合使用： - 图片加载节点：作为数据源 - 图片保存节点：作为输出端 - 批处理节点：提高处理效率
6.3 性能优化
- 合理设置批处理大小：一次处理 10-20 张图片比较合适
- 定期清理缓存：避免占用过多内存
- 使用 SSD 存储：提高文件读写速度
这个插件虽然功能简单，但非常实用，特别适合需要批量处理图片的朋友。记住，熟能生巧，多练习几次就能熟练掌握了！