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；
内置提示词方案之外，还可创建、编辑和选择自定义方案。

节点

标准版新增实验功能：制作包分镜加载器使用说明。可读取文件夹 / ZIP 内的 Shotlist，按镜应用提示词、歌曲截取和引用图，并通过原生队列递增依次生成。

加载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 域名白名单

内置的智谱、xFlow、阿里云百炼、DeepSeek 服务域名已自动允许；本机 Ollama 的 localhost、127.0.0.1 或 ::1 无需额外授权。局域网 Ollama 和 OpenAI 兼容服务可通过下方的 lan_endpoints 单独授权。使用新的第三方 API 前，先启动一次 ComfyUI，让插件在用户目录自动创建：

ComfyUI/user/default/ComfyUI-FeiHou-Easy-H3/allowed_api_hosts.json

然后在 hosts 数组内加入 API 的域名（仅域名，不填 https://、路径、端口、通配符或 IP），例如：

{
  "version": 1,
  "hosts": [
    "api.example.com",
    "llm.company.cn"
  ]
}

保存文件并重启 ComfyUI 后，即可在“自定义 API”中填写 https://api.example.com/v1、API Key 和模型。此白名单由本机文件维护，节点设置页无法改写它；这是为了阻止公开的 ComfyUI 服务被诱导请求未授权地址，或将 API Key 发送到恶意服务器。API 设置、模型获取和即时提示词优化路由也只接受运行 ComfyUI 的本机访问。

局域网推理机器（HTTP / Ollama）

在同一文件中保留原有 hosts，增加 lan_endpoints：

{
  "version": 1,
  "hosts": ["api.example.com"],
  "lan_endpoints": [
    "http://192.168.1.20:11434",
    "http://10.0.0.8:8000",
    "https://172.16.1.10:8443"
  ]
}

只接受 10.0.0.0/8、172.16.0.0/12、192.168.0.0/16 内的具体 IPv4 地址，按协议、IP 和端口精确匹配；不支持通配符、CIDR 网段或局域网域名。
白名单条目不带路径、查询参数或密钥。在节点里可填 http://10.0.0.8:8000/v1；Ollama 服务可填 http://192.168.1.20:11434，选择 Ollama 格式。
公网仍须 HTTPS。HTTP 在局域网中也是明文，请仅授权可信服务；HTTPS 证书校验不会关闭，重定向仍被禁止。
修改的是运行 ComfyUI 的机器上的文件。还需让目标服务监听局域网网卡并开放对应防火墙端口；白名单不能解决网络不通。
旧白名单无需重建，缺少 lan_endpoints 等同于未授权任何远程局域网服务。此改动不开放远程设置管理接口，也不影响 RH 版的平台 API。

开发时可自行维护本机的同步配置；本仓库不会提交本机路径、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 行为。

完整许可证和保留声明见 LICENSE 与 NOTICE。软件按“现状”提供，不附带任何担保。