FK_高级贴图编辑器(新)

FK_高级贴图编辑器(新) - the "new" advanced texture editor from juehackr/comfyui_fk_server - is the version of the texture editor you should actually build workflows around. Its predecessor (FK_ShowBaseNode) needed you to base64-encode every image through a separate node and never handed you a result you could wire onward. This one takes IMAGE inputs straight in and returns a composited IMAGE you can keep using. Same family, but it actually slots into a normal graph.

The name "高级贴图" translates to "advanced texture," and the README calls it the author's first real node. The pitch is a texture editor that fuses a depth map while you work - paint or adjust the texture with adjustable properties, while the depth map keeps the layering believable instead of flat-pasting.

How it works

The node sends your background, Depth, and Texture IMAGEs to a web editor session on the pack's local Node.js server, keyed by the token input (a default token ships with the node). The img STRING input is the session handshake - its default value is "等待传入数据..." ("waiting for data"), which is exactly what it says: the editor hasn't received the images yet. Once the session connects, that string updates and the editor UI goes live. Edit the texture, and the node's output (IMAGE) carries the result back into the graph - wire it into a VAE encode, an img2img pass, or a save node.

The pack's included reference workflow wires it the way you should: LoadImage → DepthAnythingPreprocessor → FK_gjttNode2. The Depth input isn't decoration; it's what the "fusion" uses, so grab a real depth map from Depth Anything, MiDaS, or ZoeDepth rather than leaving it empty. There's also an optional TextureMask if you want to clip the texture to a region.

Inputs and outputs that matter

• background, Depth, Texture (IMAGE) - the three layers. Keep them the same resolution; mismatched sizes make the depth fusion do weird things to the layering.
• token - session ID. The default works; change it if editor sessions collide.
• img (STRING) - handshake status, not something you type. It reads "waiting for data" until the editor connects.
• output (IMAGE) - the composited texture result.

Install

Standard pack install, same for every node in it:

cd ComfyUI/custom_nodes
git clone https://github.com/juehackr/comfyui_fk_server.git
pip install -r ComfyUI/custom_nodes/comfyui_fk_server/requirements.txt

Restart ComfyUI, or use ComfyUI Manager and search the pack title. Dependencies are minimal - PyCryptodome and pybase64 - with no model downloads and no API keys for this node. The editor is a web UI, so the pack's Node.js side server has to be up; it starts automatically on launch and runs npm install into its own server/ folder the first time.

Troubleshooting

• Stuck on "waiting for data." The session never connected - the Node.js side server isn't running, or the node hasn't been queued once so the images never reached the editor. Check the ComfyUI terminal for FKServer: lines and queue the workflow at least once.
• Weird layering. Your depth map and background are different sizes, or the depth is empty. Match resolutions and feed a real depth map.
• Nothing shows in the editor. Same session story as above - confirm the token hasn't been changed mid-workflow.

One thing to know going in: this node's implementation sits in the encrypted part of the pack (imgedit.py decrypts at import), so you can't audit exactly what happens between your images and that web server. Plenty of people run it fine, but the honest advice is to treat it as trust-based and test it in a throwaway venv before you lean on it for production work.