ComfyUI-MiniMaxH3-QwenPrompt
用本地 Qwen 模型为 MiniMax H3 生成优化提示词的 ComfyUI 节点
Nodes (5)
ComfyUI-MiniMaxH3-QwenPrompt
用本地 Qwen 模型(通过 llama-cpp-vlm)为 MiniMax H3 生成优化提示词的 ComfyUI 自定义节点包。
提示词严格遵循 MiniMax H3 官方提示词写作指南(来自 MiniMax-AI/MiniMax-H3 的 h3-prompt-writing skill),支持文生视频(T2VA)、图生视频(I2VA)、首尾帧(FL2VA)、尾帧(L2VA)和全参考(Ref2VA)等模式。
功能
包含 5 个节点(都在 MiniMax H3 分类下):
| 节点 | 说明 |
|------|------|
| MiniMax H3 Prompt (Qwen) | 纯文本提示词生成,自包含模型选择 + 采样参数,对话保持原语言 |
| MiniMax H3 Prompt (Qwen) Multimodal | 图片/视频参考提示词,4 个图片输入 + 1 个视频输入,Auto 模式按图片数量自动切换单图分析/多图故事 |
| MiniMax H3 Prompt (Qwen) Two-Stage | 两阶段:先用自定义规则生成中间提示词(可查看),再改写成 H3 格式 |
| Qwen Chat (Multi-turn) | 多轮对话,记住上下文连续问答,带 enable_thinking 开关 |
| MiniMax H3 Rule Library (10) | 预存 10 条自定义规则,active_index 一键切换,配合 Two-Stage 使用 |
工作流示意
flowchart LR
UP["user_prompt<br/>简单描述"] --> P1["MiniMax H3 Prompt"]
UP --> P2["MiniMax H3 Prompt Multimodal"]
IMG["image1-4 / video"] --> P2
UP --> P3["MiniMax H3 Prompt Two-Stage"]
RL["Rule Library (10)"] -->|selected_rule| P3
P1 -->|positive / negative| GEN["MiniMax H3 生成节点"]
P2 -->|positive / negative| GEN
P3 -->|positive / negative| GEN
P3 -.->|stage1_prompt 中间结果| VIEW["可查看"]
UP2["user_input"] --> CHAT["Qwen Chat"]
CHAT -->|response / history| OUT["对话输出"]
已验证环境
- ComfyUI(Windows 便携版)
- 本地 Qwen3.5 GGUF 模型(通过 llama-cpp-python 加载)
ComfyUI-llama-cpp_vlm节点包
安装
- 进入 ComfyUI 的
custom_nodes目录:
cd ComfyUI/custom_nodes
git clone https://github.com/wangminxing2019/ComfyUI-MiniMaxH3-QwenPrompt.git
- 安装依赖节点包
ComfyUI-llama-cpp_vlm(本节点依赖它加载模型):
git clone https://github.com/JamePeng/ComfyUI-llama-cpp_vlm.git
- 重启 ComfyUI,在节点浏览器搜索
MiniMax H3即可看到节点。
依赖
- ComfyUI-llama-cpp_vlm:提供 GGUF 模型加载与多模态推理能力(必装)
- Python 依赖(
torch、PIL、numpy等)由 ComfyUI 内置环境提供,无需额外安装
示例工作流
example_workflows/ 目录提供 3 份可直接导入 ComfyUI 的工作流:
| 文件 | 使用的节点 | 用途 |
|------|-----------|------|
| minimax_h3_qwen_prompt_t2v.json | MiniMax H3 Prompt (Qwen) | 纯文本提示词生成 |
| minimax_h3_qwen_prompt_multimodal.json | MiniMax H3 Prompt (Qwen) Multimodal | 图片/视频参考提示词 |
| minimax_h3_qwen_prompt_twostage.json | MiniMax H3 Prompt (Qwen) Two-Stage + Rule Library | 两阶段自定义规则提示词 |
导入方式:在 ComfyUI 中把 JSON 文件拖进画布,或使用菜单「Workflow → Open」。
使用说明
1. 纯文本提示词(T2VA)
在 MiniMax H3 Prompt (Qwen) 节点里:
model选你的 Qwen GGUF 模型user_prompt输入简单描述,如"一只橘猫在夕阳下的花园里追蝴蝶"- 输出
positive_prompt连接到 MiniMax H3 生成节点
2. 图片/视频参考
在 MiniMax H3 Prompt (Qwen) Multimodal 节点里:
- 连入 1 到 4 张参考图(
image1到image4)或视频帧(video) mode选Auto:1 张图自动走单图分析,2+ 张图自动按顺序分析并推理内在联系、创意故事- 有图片/视频输入时必须选
mmproj投影器文件
3. 两阶段自定义规则
MiniMax H3 Rule Library (10) 的输出连到 MiniMax H3 Prompt (Qwen) Two-Stage 的 rule_text:
- 阶段 1:按你的自定义规则生成中间提示词(
stage1_prompt输出可查看) - 阶段 2:把中间提示词改写成 MiniMax H3 官方格式
4. 多轮对话
Qwen Chat (Multi-turn) 节点:
user_input输入一句话,response输出回复,history输出完整对话历史clear_history勾选运行一次清空历史enable_thinking默认关闭(加速),勾选开启(质量更好)
模型要求
- 纯文本提示词 / 对话:任意 Qwen 系列 GGUF 模型(如 Qwen3.5-9B-GGUF)
- 图片/视频参考:需带
mmproj投影器的多模态 GGUF 模型,chat_handler选对应类型(如Qwen3.5)
提示词规则
- 说话内容/对话/歌词保持原文原语言,不翻译
- 图片含 NSFW 内容时如实描述,不添加衣服或修改
- 描述内容用中文输出,字段名保持英文
来源与许可
- 提示词规范来自 MiniMax-AI/MiniMax-H3 的
h3-prompt-writingskill - 模型加载依赖 ComfyUI-llama-cpp_vlm
本项目按 Apache-2.0 许可发布,详见 LICENSE。