JZL - 🔗 MiniMax H3 参考总线（打包）

"JZL - 🔗 MiniMax H3 参考总线（打包）" (Reference Bus Pack) is the tidy-up node for anyone whose H3 workflow has more reference assets than patience: it takes 48 fixed reference ports - 8 characters (角色A–H), 8 scenes (场景A–H), 8 props (道具A–H), 8 audios (音频A–H), 8 videos (视频A–H), and 8 video soundtracks (视频A–H（音频）) - and bundles them into a single JZL_REF_BUS dict on one output wire.

ComfyUI wires carry tensors; when you've got a dozen-plus reference images plus videos plus audio, the node graph becomes a rat's nest of colored spaghetti. A bus collapses that into a single custom type. The pack's sibling node "参考总线（解包）" (RefBusIn) unpacks it on the other side.

How it works

It's a dictionary packer, nothing more. Each input is optional, each is inferred by name (音频-containing ports take AUDIO, everything else IMAGE), and the pack method gathers whatever is connected into a dict keyed by the fixed port names. The custom JZL_REF_BUS type is the safety feature: because out and in share a bespoke type, ComfyUI will only let you connect this bus to the matching unpack node - you can't accidentally wire it into a JZL_REF2VA_BUS port and get silent type confusion.

Output: 参考总线 of type JZL_REF_BUS.

How it fits

The bus is pure transport - the docstring is explicit that it does no scheduling. You typically run it after your asset loading/scene/audio/video routing, and unpack right before the reference encoder. It's the older, manual-tidy alternative to the pack's wireless "global asset pool" (where the Generation Manager routes by name with no wire at all). If you're on the manager workflow, the pool usually makes the bus redundant; if you're hand-building, the bus keeps the graph readable.

How to install it

Part of the JZL-MiniMax-H3 pack - ComfyUI Manager, search "ComfyUI-JZL-MiniMax-H3", or:

cd ComfyUI/custom_nodes
git clone https://github.com/wjluoxiao/ComfyUI-JZL-MiniMax-H3

Restart. No dependencies; it's a pure pass-through node.

Common issues

Unconnected ports simply become None entries in the bus - which the unpack node hands back as None. If a segment silently ignores a character reference, check whether the port was actually connected at the pack end. And remember the two bus types are deliberately incompatible: JZL_REF_BUS (this one, 48 slots) vs JZL_REF2VA_BUS (18 slots, for the ref2va encoder). Mix them up and ComfyUI just won't let the wire connect.