MiniMax-H3 Prompt Rewriter for ComfyUI：本地27B模型驱动的结构化提示词生成节点

MiniMax-H3 Prompt Rewriter 是专为 LightX2V MiniMax-H3 T2VA Prompt Rewriter LoRA 设计的 ComfyUI 自定义节点，将简短多语言提示词转换为符合 H3 格式的英文结构化音视频描述（含镜头序列、声景、配乐）。

• GitHub：https://github.com/pytraveler/MiniMax-H3-Prompt-Rewriter-ComfyUI

工具支持任意语种原始提示，但受模型输入规范限制，最终生成内容统一转为英文，匹配 MiniMax-H3 的文本输入标准。简短文案送入 Qwen3.6-27B 基座搭配改写 LoRA 后，会拆分为镜头视觉描述、环境音效、配乐三类文本，分别对应视频画面、同期音效与背景音乐，最终同步送入 MiniMax-H3 完成音视频生成。

核心架构与资源规划

为什么必须是 Qwen3.6-27B？

MiniMax-H3 的文本编码器（Qwen3-VL-32B截断版）缺少 in_proj_* 线性注意力模块、lm_head 及最终归一化层，无法生成文本。LoRA 适配器仅针对完整 Qwen3.6-27B 训练，强行替换将导致加载失败或输出乱码。

资源需求矩阵

⚠️ 不支持格式：compressed-tensors、modelopt(NVFP4) 因 PEFT 无对应分发器，无法附加 LoRA。节点会在下载前检测 quant_method 并明确报错。

部署与配置实操指南

安装步骤

cd ComfyUI/custom_nodes
git clone https://github.com/pytraveler/MiniMax-H3-Prompt-Rewriter-ComfyUI
# Windows便携版专用：
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\MiniMax-H3-Prompt-Rewriter-ComfyUI\requirements.txt

或通过 ComfyUI-Manager 从注册表安装。

权重管理与复用

• 存储路径：ComfyUI/models/LLM/Qwen3.6-27B/ + MiniMax-H3-Prompt-Rewriter-LoRA/
• 自动扫描：ComfyUI LLM/transformers/diffusers 目录 + HF缓存，已有副本不重复下载
• 自定义模型列表：点击节点 Open model list 编辑 ComfyUI/user/minimax_h3_rewriter/models.json，支持本地绝对路径
• LoRA 复用：若已下载适配器，adapter 参数直接指向文件夹即可

GGUF 路线详解（免pip方案）

1. 模型列表选择 [gguf] 条目
2. Options 节点设置 llama_backend：
   • auto→vulkan（34MB）：NVIDIA/AMD/Intel通用，速度约为CUDA一半
   • cuda（511MB）：仅Windows，NVIDIA卡快2倍
   • cpu（17MB）：纯CPU推理
3. 适配器需用转换后的 .gguf 格式，通过 adapters.gguf.repo 或本地路径指定
4. 性能参考：Q4_K_M + CUDA ≈ 50 tok/s（含适配器），Vulkan ≈ 25 tok/s

关键参数说明