ComfyUI-FeiHou-Easy-H3
Modified MiniMax H3 Easy node for ComfyUI with embedded 9-image, 3-video, and 3-audio references.
Nodes (7)
MiniMax H3 with the whole reference gallery built in
The model room that packs your H3 bundle
The debug LoRA stack that feeds Easy H3
Bring your own loader chain into the bundle
The bridge back to boring, standard nodes
See what your prompt actually became
One transformer to serve both passes
ComfyUI-FeiHou-Easy-H3
English | 中文
这是一个将参考媒体加载内嵌到主节点内的 MiniMax H3 ComfyUI 节点包。
主节点把参考媒体加载全部收进节点内部，不再需要外接 Load Image、Load Video、Load Audio 节点：
- 9 个图片槽位，固定 3 × 3 九宫格；
- 3 个视频槽位；
- 3 个独立音频槽位；
- 点击槽位选择文件，也可以把文件直接拖入槽位；
- 图片和视频在节点内预览，音频显示文件名；
- 已上传文件随工作流记录，重新打开工作流后仍可恢复；
- 参考模式继续支持在提示词里输入
@选择<Picture i>、<Video i>、<Audio i>； - 视频原有音轨仍与该视频自动配对，3 个音频槽位作为独立参考音频；
- 默认 24 FPS、10 秒；参考图尺寸可选短边 480、544、640、736、768、832、928、1024、1088；
- 高级选项提供“强制卸载（含采样后缓存回收）”和可选“完整低显存分块（实验）”：前者在采样器结束、VAE 解码前回收未使用的缓存，后者对 H3 的 QKV、注意力、MLP/SwiGLU 和输出头执行完整分块；启用后不要再串联
ModelAttentionBackend / comfy kitchen attention； - 提示词优化支持智谱、xFlow-API 聚合、Ollama、阿里云、DeepSeek 和自定义 OpenAI/Gemini/Ollama 兼容 API；
- 内置提示词方案之外，还可创建、编辑和选择自定义方案。
节点
加载LoRA（旁路，仅模型）（用于调试）：完全沿用FeiHou LoRA Stack (Merge/Extract)的原生画布堆栈样式，可动态添加、启停、排序多个 LoRA；FeiHou Easy H3 Loader：从左侧接收 LoRA 堆栈，并在内部加载 FL2VA/REF2VA 模型和应用 LoRA，同时加载文本编码器、视频 VAE 和音频 VAE；ComfyUI-FeiHou-Easy-H3：主生成节点及内嵌媒体面板；FeiHou Easy H3 Model Adapter：接入外部标准 ComfyUI 模型加载链；FeiHou Easy H3 Output：拆出 Conditioning、Latent、视频 VAE、音频 VAE、FPS 和最终提示词；FeiHou Easy H3 提示词预览：显示 H3 Context 携带的最终扩写 / 反推提示词。
节点分类为 FeiHou Easy H3，类名使用独立的 FeiHouEasyH3* 前缀，可与原版 ComfyUI-MiniMaxH3-Easy 同时安装，不会发生节点 ID 或提示词优化路由冲突。
使用
- 把当前
Easy H3整个文件夹放到ComfyUI/custom_nodes/；也可以将目录改名为ComfyUI-FeiHou-Easy-H3。 - 更新到包含官方 MiniMax H3 节点的新版 ComfyUI。
- 重启 ComfyUI，并在
FeiHou Easy H3分类中添加节点。 - 把“加载LoRA（旁路，仅模型）（用于调试）”放在 Loader 左侧，将它的
lora_stack输出接到 Loader 左侧的“LoRA 堆栈”输入；Loader 再连接主节点。LoRA 不再串联到主节点的model输出链路上。 - 选择“参考生成视频”模式后，九宫格、3 个视频槽和 3 个音频槽都会启用。
提示词配置位于 ComfyUI“设置”左侧的 🐵Easy H3 独立插件分组。API 设置和“提示词优化规则”直接显示在右侧设置页，不再打开二级窗口；Base URL 可修改，API Key 粘贴后自动保存，预置服务不附带 Key 或模型。主节点关闭“高级选项”时不显示、也不执行 API 和提示词方案；打开后先选择已配置的 API 接口，再选择方案。API 未启用时方案不生效。API 密钥保存在 ComfyUI 用户目录下的本插件配置文件中，不随工作流导出。
开发时可自行维护本机的同步配置；本仓库不会提交本机路径、API Key、上传媒体或输出元数据。
在“图生或首尾帧”模式下，只使用九宫格前两个图片槽：一张图按高级选项作为首帧或尾帧，两张图作为首尾帧。切换模式不会删除已选的其他参考素材，返回参考模式后可继续使用。
媒体限制
- 参考图片：最多 9 张；
- 参考视频：最多 3 个；
- 独立参考音频：最多 3 个；
- 参考模式至少需要一张图片或一个视频，不能只提供音频；
- 视频帧和同步音轨的编码、排序及标签规则与 ComfyUI 官方
MiniMax H3 Reference to Video节点一致。
改编、致谢与许可
本项目是改编版本，并非独立重写。H3 节点上游来源为 nkxx188/ComfyUI-MiniMaxH3-Easy，原作者为 nkxx188，采用 MIT License；其 MIT 文本和版权声明保留在 LICENSES/MIT-ComfyUI-MiniMaxH3-Easy.txt。上游项目要求对实质性复用或改编保留作者与项目署名；本仓库已在节点头部、README、NOTICE 和 Release 中明确保留该声明。
节点的 API 服务配置、模型发现和提示词优化实现借鉴自 yawiii/ComfyUI-Prompt-Assistant，原作者为 yawiii，采用 GNU GPL v3。由于本仓库包含该来源的改编内容，整个仓库按 GNU GPL v3 发布。
“完整低显存分块（实验）”包含来自 matlowai/ComfyUI-MAINodes 的 H3 Streamed Blocks 衍生实现，版权归 MATLOWAI，采用 GPL-3.0-or-later。保留的源文件、完整许可证与改动说明见 NOTICE、third_party/mainodes_h3_streamed_blocks.py 和 LICENSES/GPL-3.0-or-later-ComfyUI-MAINodes.txt。
FeiHou 的改动包括：固定 9 图 / 3 视频 / 3 音频的内嵌媒体面板、上传与工作流持久化、FeiHou LoRA Stack 接入、ComfyUI 设置页内的 API 与提示词规则管理、服务/模型选择、运行时提示词扩写/反推，以及提示词预览输出。参考素材的 conditioning 规则及数量限制仍遵循 ComfyUI 官方 MiniMax H3 Reference to Video 行为。