Josia流量阀门

JosiaFlowValve (Josia流量阀门) is a bank of five independent on/off switches for wires. Each channel takes any kind of data, and each has a toggle: on, the data passes through untouched; off, the output is None and the branch dies right there. That's the entire node - five valves in a row. It's the kind of plumbing node you don't notice until you've rewired a graph by hand one too many times.

When you'd reach for it

Say you've got a workflow where an optional branch - a detailer, a second ControlNet, an extra image input - should sometimes run and sometimes not. The blunt instrument is bypassing nodes, which is fiddly and easy to forget to undo. The FlowValve gives you a labeled switch that lives in one place: flip it off and the downstream optional input reads None, so whatever is wired after it simply doesn't fire. No deleting wires, no hunting through the graph for the bypass.

It's the manual-routing valve shape from the plumbing playbook, and it plays perfectly with fallback switches (rgthree's "Any Switch" style, or ComfyUI's own first-non-null logic): valve off → None → the fallback skips to its next live input. That combo is how you build "this branch OR that branch" without a node that knows how to be clever about types.

Inputs and outputs

• Five boolean toggles, 通道1–通道5 (Channel 1–5), default all on, labeled with 开/关 (on/off) states.
• Five any-type inputs, 输入1–输入5 (Input 1–5), all optional.
• Five outputs, 输出1–输出5 (Output 1–5).

Because the sockets are ComfyUI's * wildcard type, the node accepts literally anything - an IMAGE, a MODEL, a string, a latent. It never inspects the data, never transforms it. On = original data out, off = None out.

Install

Part of ComfyUI_JosiaNodes, which has zero extra Python dependencies - everything it touches is ComfyUI built-ins. Use ComfyUI Manager (search ComfyUI_JosiaNodes) or:

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

Restart ComfyUI, and it appears under the Josia category with its Chinese label.

Where people get burned

Two gotchas, both real. First, "off" outputs None - so anything downstream that requires a value and wasn't written to tolerate None will error, not silently skip. That's not a bug; it's the contract. Design around it with an optional input or a fallback. Second, a valve left off is invisible in the graph if you don't know to look - you'll chase a "why is this branch dead?" mystery for a while before you remember the toggle. Name your branches, or just keep the switches in one spot you check first.

That said, for the money it's a clean little utility: five independent cuts, zero dependencies, no data mangling. If you've ever wanted "a mute button for this one wire," this is it.