ComfyUI-PixelArt-Detector 插件保姆级教程

1. 插件简介

插件地址： https://github.com/dimtoneff/ComfyUI-PixelArt-Detector

这个插件就像是一个专门处理像素画的魔法工具箱！它能帮你把普通图片变成复古的像素画风格，就像把现代照片变成80年代游戏机里的画面一样。

主要功能：

• 把图片变成像素画风格（就像马赛克效果，但更精细）
• 换颜色调色板（比如把彩色图片变成只有4种颜色的Game Boy风格）
• 自动检测图片的最佳像素尺寸（找到图片本来的"像素格子"大小）
• 保存成各种格式（WebP、JPEG等）
• 添加抖动效果（让颜色过渡更自然，像老式打印机的效果）

2. 如何安装

1. 打开终端或命令提示符
2. 进入你的 ComfyUI 安装目录下的 custom_nodes 文件夹
3. 运行以下命令：

git clone https://github.com/dimtoneff/ComfyUI-PixelArt-Detector

4. 重启 ComfyUI

3. 节点详细解析

3.1 PixelArtLoadPalettes 节点（调色板加载器）

这个节点就像一个颜色盒子，里面装着各种复古游戏机的颜色方案，比如Game Boy的绿色调、NES的经典色彩等。

参数详解：

3.2 PixelArtAddDitherPattern 节点（抖动图案添加器）

这个节点就像给图片加上老式打印机的点阵效果，让颜色过渡看起来更有复古感。

参数详解：

3.3 PixelArtDetectorConverter 节点（像素画调色板转换器）

这是插件的核心节点，就像一个全能的图片处理工厂，能把任何图片变成像素画风格。

参数详解：

3.4 PixelArtDetectorToImage 节点（像素画检测转图片）

这个节点就像一个图片侦探，能自动找到图片的真实像素尺寸，然后输出标准的图片格式。

参数详解：

3.5 PixelArtDetectorSave 节点（像素画检测保存）

这个节点就像一个专业的图片保存器，不仅能检测像素尺寸，还能保存成各种格式。

参数详解：

3.6 JavaScript扩展功能（前端功能）

这个插件还包含一个前端JavaScript扩展，让你可以直接把生成的WebP或JPEG图片拖拽到ComfyUI界面中，自动加载保存在图片里的工作流。

功能说明：

4. 使用技巧和建议

4.1 新手入门建议

1. 从简单开始：先用默认设置，只改变调色板类型
2. 尺寸设置：如果不想改变图片大小，把宽度和高度都设为0
3. 调色板选择：GAMEBOY适合单色调效果，NES适合彩色像素画

4.2 进阶技巧

1. 颜色减少：开启"reduce_colors_before_palette_swap"能得到更干净的效果
2. 抖动效果：使用floyd-steinberg抖动能让颜色过渡更自然
3. 网格预览：使用调色板加载器的网格功能可以一次性预览所有调色板效果

4.3 性能优化

1. 算法选择：Image.quantize是最快的，OpenCV.kmeans最慢但效果最好
2. 网格扫描：grid_pixelate_grid_scan_size设为1最精细但很慢，建议用2-4
3. 尝试次数：OpenCV的attempts和iterations不要设太高，会很慢

5. 常见问题解答

Q1: 为什么我的图片变得很模糊？

A: 可能是resize设置的尺寸太小了，试试把resize_w和resize_h设为0，或者设置更大的数值。

Q2: 颜色转换效果不明显怎么办？

A: 试试开启"reduce_colors_before_palette_swap"选项，或者降低"reduce_colors_max_colors"的数值。

Q3: 处理速度太慢怎么办？

A: 选择"Image.quantize"算法，把grid_pixelate_grid_scan_size设为2以上，减少OpenCV的attempts数值。

Q4: 如何获得更多调色板？

A: 去https://lospec.com/palette-list 下载1px版本的调色板，放到插件的palettes/1x/目录下。

Q5: 保存的图片无法拖拽加载工作流？

A: 确保"save_exif"选项是开启的，并且ComfyUI没有禁用元数据功能。

6. 推荐工作流程

6.1 基础像素画转换

1. 加载图片 → PixelArtDetectorConverter → 预览图片
2. 调整palette选择不同风格
3. 如果需要保存，连接PixelArtDetectorSave节点

6.2 高质量像素画制作

1. 加载图片 → PixelArtLoadPalettes（选择调色板）
2. → PixelArtDetectorConverter（开启reduce_colors_before_palette_swap）
3. → PixelArtAddDitherPattern（添加抖动效果）
4. → PixelArtDetectorSave（保存最终结果）

6.3 批量调色板预览

1. PixelArtLoadPalettes（开启render_all_palettes_in_grid）
2. → PixelArtDetectorConverter
3. → 预览图片节点（查看所有调色板效果对比）

7. 总结

这个插件是ComfyUI中处理像素画的神器，包含了6个功能强大的节点，能够满足从简单的调色板转换到复杂的像素画制作的各种需求。通过合理搭配这些节点，你可以轻松制作出各种复古风格的像素画作品。

记住最重要的一点：多实验，多尝试不同的参数组合，每个图片的最佳设置都可能不同！