ComfyUI-Hyperflow：原生移植 MiniMax-H3 的 8 步音视频 LoRA，无需修改 ComfyUI 内核

160 0

ComfyUI-Hyperflow 是一个专为 ComfyUI 设计的节点包，用于运行 Video Rebirth 发布的 HyperFlow——MiniMax-H3 视频+音频 8 步 LoRA。该包将原始 diffusers 实现完整移植到 ComfyUI 原生 MiniMax-H3 模型上，不修改任何核心文件，也不依赖自定义采样器。其核心价值在于保留了官方配方中的双时间 (t, r) 条件机制，这是独立 LoRA 版本无法复现的关键特性。

GitHub：https://github.com/Saganaki22/ComfyUI-Hyperflow
模型：https://huggingface.co/drbaph/Hyperflow-Comfyui
独立版：https://huggingface.co/drbaph/MiniMax-H3-Turbo-Lora-ComfyUI

若用户不愿安装自定义节点，可使用 drbaph/MiniMax-H3-Turbo-Lora-ComfyUI 提供的独立 LoRA 文件（如 minimax_h3_hyperflow_8step_v1.0_comfyui_bf16.safetensors），通过官方 Load LoRA 节点直接加载。但需注意：这些文件仅应用主干 LoRA，缺失双时间条件，输出会偏离官方发布模型。

ComfyUI-Hyperflow：原生移植 MiniMax-H3 的 8 步音视频 LoRA，无需修改 ComfyUI 内核

技术实现：无侵入式补丁与权重适配

HyperFlow 适配器在官方基座之上包含两部分：rank 256 的未合并 bf16 LoRA 分支，以及双时间 (t, r) 条件机制（每步以积分区间端点 r = 1 – sigma_next 作为条件）。本节点包仅替换原生模型中的 time_embedder(t_vals) 调用，将其替换为混合嵌入，并通过 ComfyUI 自身的权重适配机制应用 LoRA。

这种设计带来三大优势：

量化兼容：int8/融合算子基座中无法挂钩的 LoRA 目标会被自动检测并改经 merge 路径应用，控制台明确报告 “N fused/int8 targets via merge”。
内存管理一致：模型卸载、内存可视化器表现与普通 MODEL 补丁完全相同。
基座自动检测：节点自动识别完整基座（含 time_embedder）或剪枝/曲线基座（无 time_embedder），强制匹配对应权重文件，不匹配时明确报错。

安装与工作流配置

安装步骤：

克隆仓库至 ComfyUI/custom_nodes/ComfyUI-Hyperflow
从 Hugging Face 下载转换后的权重文件至 models/hyperflow/，或启用节点 download_if_missing 开关自动获取
重启 ComfyUI

标准工作流：

Load Diffusion Model (MiniMax-H3)
  → ApplyHyperFlow            (MODEL → MODEL + SIGMAS)
  → [可选] Model Attention Backend        (稠密注意力，含 int8 支持)
  → [可选] Model Sparse Attention         (sol-attn/sla/vsa)
  → SamplerCustomAdvanced + guider + Euler    (接入 SIGMAS 输出)

关键配置说明：

SIGMAS 来源：ApplyHyperFlow 输出训练好的 9 点 sigma 网格，必须接入 SamplerCustomAdvanced 替代 BasicScheduler。双时间端点由 sample_sigmas 推导，与原生 H3 最终层机制相同。
lora_mode：默认 bypass（运行时应用，与参考实现一致）；merge 模式显存占用最低，但在量化基座上精度会变软。
Sol-Attn 稀疏注意力：官方验证配方对应 start_percent=0.25, dense_blocks="0,1", tau=1.0, extra_tokens=0。SLA 为不同方法，仅建议配合专用权重使用。
高级选项：ApplyHyperFlowAdvanced 提供 gate 与 sigma 网格覆盖，用于消融实验；默认值精确复现官方模型。

许可与兼容性注意事项

权重许可：转换后的权重文件是 MiniMax-H3 衍生作品，遵循 MiniMax H3 社区许可协议。
代码许可：节点包代码为 Apache-2.0，schedule/embedder 移植部分衍生自 HyperFlow 与 diffusers 代码（详见 THIRD_PARTY_NOTICES.md）。
文件格式：仅接受保留完整自描述头（gate、sigma 网格、rank）的转换后 .safetensors 文件；原始 diffusers 格式会被明确拒绝，加载时绝不进行转换。
编译器兼容：在模型编译器因 patched MiniMax-H3 前向而崩溃的 ComfyUI 版本上，节点仅对自身模型调用禁用编译器（aimdo malloc-graph）。
采样 shift：H3 默认视频 shift 12 / 音频 shift 3；仅在需要非默认值时，才需在 ApplyHyperFlow 后添加核心 ModelSampling 节点。