xbhh 分层注释 📑

ComfyUI is a visual graph, which means the moment a workflow gets real, it becomes a spreadsheet with pixels. The default answer to "what does this group do" is a stock Note node - a single box of text that never stays organized. XBHHLayeredNote is the XBHH kit's answer: a pure-display node that lets you stack multiple collapsible note blocks, each with its own title and content, inside one node. It does zero processing. Its entire job is making your graph legible.

If that sounds trivial, you haven't hit the point where you reopen a workflow from three months ago and spend twenty minutes reverse-engineering which latent you're upscaling. Workflows are shareable PNGs in this ecosystem - the graph is the project file - and comments-in-a-box are how you make them readable by your future self and by anyone you drag the file into.

How it works

The node has no inputs and no outputs - info_schema shows required: {}, optional: {}, and zero return types. It's an output node whose execute method does nothing but return an empty dict. All the actual work happens in its frontend JavaScript (web/js/layeredNote.js), which draws the node, renders your blocks, and handles the expand/collapse behavior. It's pure UI chrome: the backend is just a stub so the node can exist in the graph at all.

You click into a block to edit its title and body, and each block collapses to a header line when you don't need the content. Multiple sections live in one node, so instead of five scattered notes you get one tidy card per workflow stage.

What you'll actually do with it

• Label each workflow stage - "TEXT ENCODE", "SAMPLER", "HIRES PASS" - in a collapsible header.
• Document the model and settings used, so the workflow reads like a changelog.
• Paste your prompt-variation notes or the CivitAI links for each LoRA in one place.

Because it stores its content in the node's widget values, everything you type is saved with the workflow JSON - which, remember, lives inside your output PNG. Drag a generated image back onto the canvas and your notes come back with the graph.

Installing it

It's part of the XBHH kit, so:

cd ComfyUI/custom_nodes
git clone https://github.com/xbhh123456/Comfyui-xbhh-main.git
cd Comfyui-xbhh-main
pip install -r requirements.txt

Or search xbhh-lora in ComfyUI Manager and restart. No models, no extra downloads.

A fair warning

The pack also ships XBHHNoteNode, a simpler single-note-with-search variant - if you want one big note and a global search overlay across your notes, that one's the match. And because both are frontend-heavy, they're a little more fragile than stock nodes when the ComfyUI frontend updates: the kit's UI code is written against the current DOM, and a future core update can break the rendering while the node still "works" in the graph. If a note node ever renders wrong after an upgrade, that's almost certainly the frontend version, not your workflow - it's the same class of pain rgthree-comfy and other UI-heavy packs hit during the Nodes 2.0 era. If all you need is a plain text block, the stock Note is the zero-risk option; reach for this one when legibility is the actual problem.