凤希AI - 角色资源数据解析器

Once you've built up a character's reference images in the pack's asset library, you need them in the graph - as tensors, not files. FxAiCharacterAssetsLoad (凤希AI - 角色资源数据解析器) is that bridge. You feed it a comma-separated list of asset paths (the kind the pack's image selector spits out), and it loads every one into an IMAGE batch plus a single grid "contact sheet" image, all scaled down by whatever factor you ask for. It's the load-and-downsample node for the character consistency pipeline.

How it works

The 图片路径列表 (image path list) input expects paths in subdir/filename form, relative to ComfyUI/fxai/image/ - that's the convention the whole pack uses, and it's how the FxAiCharacterAssets panel stores things. Each path is resolved safely (it refuses to escape the asset root, so no path-traversal surprises), loaded, and downscaled by 缩小倍数 (shrink factor). A factor of 1 leaves images as-is; 2 halves each dimension - which is your VRAM lever, since a batch of four 1K character shots eats noticeably less as 512s.

Outputs are the useful triad:

• 图片列表 - the images as a list of IMAGE tensors.
• 网格拼接大图 - the same images tiled into one grid (two columns). This is your at-a-glance "are all four the same character" contact sheet, and it doubles as a single reference image you can feed a reference-aware video model.
• 总数量 - how many loaded, a cheap wiring sanity check.

If a path fails to resolve, it's skipped with a log line (图片不存在 = image not found) rather than aborting the whole load - so a typo in one entry doesn't nuke the batch.

Inputs

• 图片路径列表 - STRING, comma-separated subdir/filename entries. Note it's a forced input: you're meant to wire it from the selector/manager rather than type paths by hand.
• 缩小倍数 - INT, default 1, max 10.

Install

Part of fxai-toolkit (凤希全能节点包), MIT-licensed, by 凤希AI. ComfyUI Manager (search "fxai") or:

cd ComfyUI/custom_nodes
git clone https://github.com/fxai666/fxai-toolkit
# restart ComfyUI

Pack auto-installs soundfile and psutil; no models, no ffmpeg needed for this node.

Gotchas

• The path format is subdir/filename, not absolute paths. Feed it an absolute Windows path and it silently skips every file.
• If the input comes from typing rather than the selector, no trailing commas - the split is naive on commas.
• The grid is always two columns; that's a deliberate contact-sheet layout, not configurable.
• Chinese labels: 缩小倍数 = shrink factor, 总数量 = total count. You'll internalize these fast if you run the whole pack.