xbhh 注释节点 📝

ComfyUI's stock Note node is a text box. Fine for a one-liner, useless when your workflow documentation grows into paragraphs - or when you have twelve notes across a graph and need to find the one that mentions your VAE settings. XBHHNoteNode is the XBHH kit's upgraded note: it pairs a big multiline note field with a search box, and the search doesn't just filter the text - it opens a global results panel that surfaces matching content across all your XBHH note nodes in the workflow. It's still a note; it just behaves like a documentation tool instead of a sticky.

The larger point is the same one that made rgthree-comfy and the other UI packs popular: as ComfyUI graphs get bigger, the friction stops being the generation and starts being navigation and legibility. A workflow that ships inside a PNG is a project file, and a project file that documents itself is one you can still read in three months.

How it works

Like the kit's layered note, the backend is a stub - execute returns an empty dict, no inputs consumed, no outputs produced. All behavior is frontend JavaScript (web/js/noteNode.js). The note field is where you write; the search field is where you type. When you type in search, the frontend scans the note content, highlights matches, and pops a floating results panel that lists which of your XBHH notes matched. Click a result and it jumps you to that node.

Everything you type is stored in the node's widget values, so your notes persist in the workflow JSON and ride along inside the metadata of any PNG you save - drag the image back into ComfyUI and the documentation comes with it.

The inputs

• search - the query box. No min/max, just a string. Type and get highlights/results.
• note - your actual note, multiline.

That's the whole schema: required: { search, note }, no optional fields, no outputs, is_output_node: true. There is nothing to wire - you drop it on the canvas and type.

Installing it

Part of the XBHH kit:

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 heavy dependencies.

Choosing between this and the layered note

The kit gives you two note nodes and they're not redundant:

• XBHHNoteNode - one big note plus search/highlight and the global results panel. The one to pick when your note is long and you need to find things inside it.
• XBHHLayeredNote - multiple collapsible titled blocks in one node. The one to pick when your workflow has several distinct sections each needing a label.

Both are frontend-driven, so both carry the same caveat: when ComfyUI's UI layer changes (the Nodes 2.0 era broke a lot of frontend-heavy packs), a rendering glitch is usually the core update, not your graph. If you need bulletproof and boring, the stock Note always works. If you need to actually find your own documentation, this one's worth the dependency.