ComfyUI-CleanFreak：一键拯救“面条式”工作流，按功能角色自动规整布局，支持 1200+ 节点智能分类

在 ComfyUI 中构建复杂工作流时，我们常陷入这样的困境：节点越来越多，连线错综复杂如乱麻，查找特定功能节点如同大海捞针。现有的布局工具往往只解决对齐问题，却忽略了功能逻辑的分组。

• GitHub：https://github.com/shootthesound/comfyui-CleanFreak

CleanFreak 是一款专为 ComfyUI 设计的整理插件，它能根据节点的功能本质（如加载、编码、采样、输出），一键将杂乱的工作流规整为清晰、标准化的布局。无论你的工作流多么复杂，CleanFreak 都能让它瞬间变得井井有条。

核心亮点：智能、美观、无损

1. 智能功能分区，1200+ 节点全覆盖

CleanFreak 内置了强大的分类引擎，支持官方原生节点及 Impact-Pack, WAS Node Suite, ControlNet Aux, IPAdapter_plus 等主流社区插件。它将节点自动归入以下标准分区：

• Loaders (加载类)：模型、VAE、LoRA、ControlNet 等。
• Encoders (编码类)：CLIP/T5 文本编码、VAE 编码。
• Conditioning (条件控制)：条件合并、ControlNet 应用、引导设置。
• Samplers (采样器)：各类采样器、调度器、噪声生成。
• Decoders & Post (解码与后处理)：VAE 解码、超分、模糊、缩放。
• Outputs (输出类)：图片保存、预览、动图导出。
• Misc (杂项)：未识别节点单独成列，避免干扰主流程。

2. 自适应布局与彩色分组卡片

• 自适应宽度：每列宽度自动适配该分区内最宽的节点，窄节点自动居中，整齐划一。
• 彩色视觉引导：启用“+ 分组”模式后，每个功能区自动生成低饱和度的专属彩色卡片，一眼即可区分功能模块。
• 执行顺序排序：同列内节点按 ComfyUI 执行逻辑排序，保存/预览类节点固定置于底部，符合直觉。

3. 零风险规整，连线完美保留

• 仅改坐标：插件只修改节点位置和画布分组列表，绝不改动连线、输入输出及其他属性。
• 无损操作：基于节点 ID 存储连线，规整后工作流功能完全不变，放心使用。
• 支持撤销：若不满意，直接使用 Ctrl+Z 即可回退到原始布局。

4. 持续学习的分类规则

• 五级优先级匹配：会话临时覆盖 > 用户全局规则 > 内置预设 > 节点原生 Category > 类名正则匹配。
• 自定义编辑：通过右键菜单打开交互式弹窗，可手动调整任意节点的分类，并保存为全局规则。插件会随着你的使用不断“学习”，越来越懂你的习惯。
• 子图解包：支持一键解包嵌套的子图/分组，将其扁平化后重新规整，彻底理清深层结构。

快速开始

1. 安装插件

将 comfyui-CleanFreak 文件夹复制到 ComfyUI 目录：

ComfyUI/custom_nodes/comfyui-CleanFreak

重启 ComfyUI 或刷新浏览器。

2. 使用方式

在画布空白处右键（注意不要点在节点上），选择以下任一功能：

• ✨ 按角色规整（横向/纵向）：仅重新排列节点位置，不创建分组。
• ✨ 按角色规整 + 分组（横向/纵向）：重新排列并生成彩色功能分组卡片（推荐）。
• ✨ 解包子图/分组 + 规整 + 分组：先展开所有嵌套容器，再进行全面规整。
• ✨ 查看并编辑分类规则：手动调整节点分类，保存个性化规则。

3. 布局模式说明

• 横向模式：从左到右依次为 加载 → 输入 → 提示词 → 编码 → 条件 → 采样 → 解码 → 后处理 → 输出。
• 纵向模式：从上到下顺序同上，适合作垂直长屏显示。

为什么你需要 CleanFreak？

高级配置

• 配置文件路径：ComfyUI/user/cleanfreak/role_overrides.json
• API 接口：
  • GET /cleanfreak/overrides：获取自定义规则。
  • POST /cleanfreak/overrides：保存新规则。
  • POST /cleanfreak/overrides/clear：清空已保存规则。