Extensions/DNF Pixel Perfect Color Lock
ComfyUI Extension

DNF Pixel Perfect Color Lock

Structure-guided three-tone color reduction, source color restoration, and production pixel-art cleanup nodes for ComfyUI.

By yifu23333·Created 2 days ago·Updated about 18 hours ago· 0
yifu23333/ComfyUI-DNF-ColorLock
Nodes
On cloudLocal install
Stars0
Updatedabout 18 hours ago
Readme

DNF Pixel Perfect Color Lock

用于 Krea2 原画转像素工作流的三个确定性节点:

  • DNFSpatialChromaLock:保留生成图的亮度、轮廓与像素结构,只从空间对齐的原画恢复 Cb/Cr 色度;不是 RGB 图片叠加。
  • DNFReferencePaletteFinalize:从原画提取参考调色板,并为彩色像素预留指定颜色槽,避免大面积灰背景耗尽 64 色调色板。
  • DNFPixelPerfectFinalize:只对人物前景恢复原图色度和明暗层次,把全部调色板名额留给人物,并清理断点、孔洞与孤立颗粒后重建连续外轮廓。v2.3 会先按色度归并固有色色族,再把每个色族严格压缩为暗/中/亮三个色阶;color_block_cleanliness 控制色族数量、色度收敛强度与孤立杂色清理。可选的 structure_map 输入接收 Canny 结构图,internal_line_strength 只筛选原画中高可信的盔甲、羽片和服装分界,并使用所属色族的暗阶重建一像素内部线。头部细节单独保护,外轮廓同样复用暗阶,不产生纯黑边或额外色阶。输出原背景成品、纯绿背景成品和人物遮罩。

默认建议:空间色度强度 1.0、色度模糊 1.0;64 色中 48 色预留给彩色区域,阈值 0.06,无抖动、最近邻 4 倍预览。

完美像素精修建议:遮罩阈值 0.065、参考颜色 1.0、参考明暗 0.30、饱和度 1.18、人物颜色上限 48 色、色块整洁度 0.68、内部结构线 0.72、清理 1 次、外轮廓 1 像素、描边强度 0.56

色块整洁度

  • 0.65:保留较多装饰性颜色,适合细节复杂的大尺寸立绘。
  • 0.82:推荐默认值,约 8–9 个固有色色族,每个色族只有暗/中/亮三档。
  • 0.92:强归纳,约 6–7 个固有色色族,并加强孤立色点清理,适合最终游戏小图。

foreground_colors 现在是总颜色安全上限,普通角色建议 36,复杂盔甲与多材质角色建议 48;实际颜色数同时受整洁度控制。纯绿背景不占用人物颜色名额。

v9 交付级工作流原则

  • 原画先用 area 从 1024 汇聚到 256,再用 nearest-exact 放回 1024 后编码为 img2img latent;低降噪也能看到稳定像素网格。
  • Krea2 Turbo 使用 LoRA 1.35、ControlNet 1.65、denoise 0.22,优先保留设计和比例。
  • 生成结果使用 area 1024→256,先聚合每个 4×4 单元内的随机纹理,再进行三色阶归纳。
  • 精简 Canny 同时连接 ControlNet 与 structure_map,让最终像素内部线来自原画结构,而不是后处理猜测。

安装

正式发布后,在 ComfyUI Manager 的 Custom Nodes Manager 中搜索 DNF Pixel Perfect Color Lock 或 Registry ID dnf-pixel-perfect,安装后重启 ComfyUI。

节点位于 DNF/Color LockDNF/Pixel Perfect 分类。它们使用 ComfyUI 环境已有的 PyTorch、NumPy 与 Pillow,不需要额外模型或运行时安装脚本。

Registry 发布

仓库维护者需要在 GitHub Actions secrets 中添加 REGISTRY_ACCESS_TOKEN,然后在 Actions 页手动运行 Publish to Comfy Registry。Registry 路径为 yifu23333/dnf-pixel-perfect,当前版本为 2.3.0