Josia分组控制

If you've ever cleaned out a big workflow, you know the pain this kills: to try one sampler path instead of another you have to right-click a dozen nodes inside a group and pick Bypass, then remember which ones you touched. Josia分组控制 (JosiaGroupControllerG) is a single on-canvas box that flips whole ComfyUI groups between enabled and bypassed - no wires, no right-clicking, no deleting. It's part of the JosiaNodes pack from the Bilibili creator JeekAI (吉客AI), a Chinese-friendly utility set aimed at low-end GPUs, and its display name and UI are entirely in Chinese. The closest thing in the English ecosystem is rgthree's Fast Groups Bypasser; this one does the same job with a different twist - you hand-pick which groups appear, and you can add them by color.

It doesn't touch your data

Here's the thing that trips people up first: check the node's inputs and outputs and there are none. The Python class is a bare placeholder with OUTPUT_NODE = True and an empty run() that just returns {}. Every line of actual logic lives in web/js/group_controller.js. That means it costs zero compute, takes zero wires, and never reruns downstream on queue - which is exactly why people keep it in permanent workflows. You can't wire it to anything and you don't need to.

What the JS does instead is reach into the live graph, find the groups you've assigned to its slots, and set every member node's node.mode to bypass (LiteGraph mode 4) or back to active. That's the same mechanism as right-click → Bypass, just applied across a group in one click - so the state stays visible everywhere: the nodes go gray, native bypass from any other tool still works, and group rows show green (enabled), red (skipped) or orange (partially skipped) status. The groups you chose, and their toggle states, are serialized with the workflow, so reopening restores everything.

The controls that matter

• − / + slots (1–20): each slot holds one group picked from a dropdown. Drop a group, and it won't reappear in the other slots - no duplicates. Shrinking the count hides slots without forgetting their settings.
• Color match: pick a group color and one click adds every group on the canvas with that color. This is the neat bit - ComfyUI's native palette (red, brown, green, blue, cyan, purple, yellow, black…) becomes a filter, so color-coded workflows sort themselves.
• 单选模式 (single-select): mutual exclusion between the groups in this node. Enabling one auto-bypasses the rest - a poor man's A/B switch over whole sections, handy when you're comparing two pipelines that can't run together.
• Clicking a group row also centers the canvas on that group, which is a nicer navigation aid than you'd expect.

Installing it

Same as any custom node. ComfyUI Manager → search ComfyUI_JosiaNodes, or:

cd ComfyUI/custom_nodes
git clone https://github.com/Josia-doit/ComfyUI_JosiaNodes

Restart ComfyUI and you should see [JosiaNodes] ✅ JosiaNodes 加载成功 in the console. The pack has zero Python dependencies beyond what ComfyUI ships - nothing to pip install. The only install gotcha specific to this node: it lives entirely in the frontend, so keep web/js/group_controller.js in place. Delete or move the web folder and the node renders as a dumb shell that does nothing.

Troubleshooting

Search for it as Josia分组控制 (or class JosiaGroupControllerG) under the "Josia" category - it's grouped with 多组控制 (auto-scans all groups) and 单组控制 (one group at a time); this G variant is the curated picker, so don't expect it to list every group automatically. If a toggled group doesn't gray out, one clue is worth knowing: because toggling is a frontend operation, it depends on the current canvas behavior for how groups store their members - the code has explicit shims for different ComfyUI versions, but a big frontend change is the natural place this kind of node would break. If nothing responds at all, your browser console will usually show a JS error from a stale file - refresh hard, and make sure you restarted ComfyUI after updating the pack. And remember there's a companion canvas patch in the same pack (settings → Josia节点设置) that adds corner-resizing and one-click group bypass buttons to the group title bar - worth a look if you want bypass controls on every group instead of in one node.