OmniChar ComfyUI 节点：一个 .char 文件跨 MiniMax H3、FLUX.2 与 Krea 2 复用
OmniChar 发布官方 ComfyUI 节点包，可加载可移植的 .char 文件，并在 MiniMax H3、FLUX.2 与 Krea 2 工作流中复用同一角色身份。
.char 文件，其中保存角色的引用图像、锁定的描述，以及（若已存在）训练好的 LoRA，然后在普通工作流中把该身份送入图像与视频模型。该节点包列出的支持范围包括 MiniMax H3、Krea 2、FLUX.2 dev 以及 FLUX.2 Klein 9B / 4B。
画布上的 OmniChar 节点：Load Character、Decode Character，以及把解析后的角色交给采样器的引用节点。
一个 .char 文件里装着什么
.char 描述的是一个角色，而不是一张图像。它保存参考照片、与照片绑定的描述，通常还有一个训练好的 LoRA，因此同一个人可以在任何接受引用的模型中重建。角色存放在 ComfyUI/models/characters/，加载器只会列出该文件夹中的内容。
引用按用途分组。Encode Character 把面部、身体和服装镜头各分入三个槽位，因此面部始终是第一个引用，提示词编号也遵循这一顺序。Decode Character 把该文件还原为提示词加一份解析后的引用列表，这才是采样器实际看到的内容。
节点
| 节点 | 输入 | 输出 |
|---|---|---|
| Load Character | char、char_path | char |
| Decode Character | char、style、clip、prompt、arch、max_references、size_from、fit | conditioning、references、refs、sheet、prompt |
| Character Reference | refs、index | image、role、count |
| Character References Split | refs | image_0 到 image_4、count |
| Character Reference Latent | conditioning、refs、vae | conditioning |
| Apply Character LoRA | model、clip、char、strength、arch、min_key_coverage | model、clip |
| Encode Character | name、description、resolution、face/body/cloths（各三个槽位） | char |
| Save Character | char、filename、overwrite | path |
引用的传递方式取决于模型。接受单一批处理的模型读取 references。带编号引用槽位的模型（MiniMax H3 就是其中之一）通过 Character References Split 节点拆分 refs，或为每个槽位使用一个 Character Reference 节点。以 Latent 形式读取引用的编辑类模型（例如 FLUX.2）则把 refs 接入 Character Reference Latent 节点，并同时连接到正向条件与负面条件。
节点包自带的工作流
仓库中附带三个示例工作流：一个用面部、身体和衣橱引用构建 .char，一个驱动 FLUX.2 Klein 9B 生成图像，还有一个驱动 MiniMax H3 生成视频。
MiniMax H3 引用身份示例：左侧是各自独立的引用槽位，右侧是已生成的画面。
安装
该节点包需要 ComfyUI 以及 Python 3.10 或更高版本，并从 requirements.txt 拉取其读取器。
cd ComfyUI/custom_nodes
git clone https://github.com/omnichar/ComfyUI-Omnichar
cd ComfyUI-Omnichar
pip install -r requirements.txt之后重新启动 ComfyUI，然后在节点菜单中搜索 Character。把 INLINE_CHARACTERS_DIR 指向 OmniChar Studio 的角色文件夹，即可让 Studio 与这些节点读取相同的 .char 文件。
获取方式
节点包： omnichar/ComfyUI-Omnichar
Studio 应用： omnichar/OmniChar
网站： omnichar.org
Python SDK： pip install omnichar-sdk
基础模型： Comfy-Org/MiniMax-H3、black-forest-labs/FLUX.2-klein-9b
评论
使用 GitHub 登录后即可参与讨论。