Extensions/ComfyUI-MiniMaxH3-QwenPrompt
ComfyUI Extension

ComfyUI-MiniMaxH3-QwenPrompt

用本地 Qwen 模型为 MiniMax H3 生成优化提示词的 ComfyUI 节点

By wangminxing2019·Created 10 days ago·Updated 5 days ago· 2
wangminxing2019/ComfyUI-MiniMaxH3-QwenPrompt
Nodes5
On cloudLocal install
CategoryMiniMax H3
Stars2
Updated5 days ago
Readme

ComfyUI-MiniMaxH3-QwenPrompt

用本地 Qwen 模型(通过 llama-cpp-vlm)为 MiniMax H3 生成优化提示词的 ComfyUI 自定义节点包。

提示词严格遵循 MiniMax H3 官方提示词写作指南(来自 MiniMax-AI/MiniMax-H3h3-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 节点包

安装

  1. 进入 ComfyUI 的 custom_nodes 目录:
cd ComfyUI/custom_nodes
git clone https://github.com/wangminxing2019/ComfyUI-MiniMaxH3-QwenPrompt.git
  1. 安装依赖节点包 ComfyUI-llama-cpp_vlm(本节点依赖它加载模型):
git clone https://github.com/JamePeng/ComfyUI-llama-cpp_vlm.git
  1. 重启 ComfyUI,在节点浏览器搜索 MiniMax H3 即可看到节点。

依赖

  • ComfyUI-llama-cpp_vlm:提供 GGUF 模型加载与多模态推理能力(必装)
  • Python 依赖(torchPILnumpy 等)由 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 张参考图(image1image4)或视频帧(video
  • modeAuto:1 张图自动走单图分析,2+ 张图自动按顺序分析并推理内在联系、创意故事
  • 有图片/视频输入时必须选 mmproj 投影器文件

3. 两阶段自定义规则

MiniMax H3 Rule Library (10) 的输出连到 MiniMax H3 Prompt (Qwen) Two-Stagerule_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 内容时如实描述,不添加衣服或修改
  • 描述内容用中文输出,字段名保持英文

来源与许可

本项目按 Apache-2.0 许可发布,详见 LICENSE