ComfyUI Fantastic MiniMax H3 Prompt Builder：让 H3 提示词编写变得简单直观

192 0

MiniMax H3 是一个强大的视频生成模型，但它对提示词的要求极其严格：需要结构化的段落、精确的镜头时间、说话者 ID 以及复杂的参考媒体标签（如 <Picture 1>）。官方推荐的改写模型（H3-Context-IR）并未开源，导致许多用户在手动编写提示词时频频出错，渲染失败率高。

GitHub：https://github.com/Adudeguyman/ComfyUI-Fantastic-MiniMaxH3-PromptBuilder

ComfyUI Fantastic MiniMax H3 Prompt Builder 是一个手工驱动的替代方案，通过填空式模板、实时语法检查和可视化的媒体加载器，让普通用户也能轻松驾驭 H3 的全部潜力。

该插件包包含三个关键节点，均位于 conditioning → video_models 类别下：

MiniMax H3 Prompt Builder：
- 主编辑器：提供五种模式（T2VA, I2VA, FL2VA, L2VA, Reference）的专用模板。
- 实时检查：在你输入时即时标记错误（如镜头编号混乱、时间戳缺失、未引用的参考媒体），避免渲染后才发现问题。
- 智能辅助：一键插入格式正确的镜头标签、相机运动描述和对话格式。
- 提示词库：支持保存、分类、搜索和重新加载提示词，保留完整的编辑状态而非纯文本，方便迭代优化。
MiniMax H3 Media Loader：
- 拖放管理：将图像、视频和音频拖入即可自动分组。
- 标签可视化：每个媒体文件都会显示其对应的标签（如 <Picture 2>），点击缩略图即可将标签直接插入提示词编辑器，无需手动记忆编号。
- 预设系统：保存常用的参考媒体组合，一键重新加载，极大提升重复性工作的效率。
MiniMax H3 Reference Splitter（可选）：
- 为希望跳过 Prompt Builder、直接使用原生节点的高级用户提供的媒体分散工具。

告别“黑盒”报错：原生 H3 节点在提示词格式错误时往往静默失败或给出晦涩的错误信息。Prompt Builder 会在你编写阶段就拦截所有常见错误（如红色错误必须修复，琥珀色警告建议优化）。
结构化思维引导：编辑器强制你按照 H3 的逻辑思考：先定义镜头，再填充描述，最后关联参考。这种结构化流程能显著提升生成视频的连贯性和可控性。
参考媒体零失误：H3 的参考标签编号规则复杂（涉及图片、视频、音频的混合排序）。Media Loader 自动处理这些逻辑，确保你插入的 <Audio 1> 确实指向你上传的那段声音。
全模式覆盖：无论是纯文本生成（T2VA）、首帧动画（I2VA）、首尾帧控制（FL2VA）还是复杂的参考驱动（Reference Mode），都有对应的优化模板。

安装：
- 通过 ComfyUI Manager 搜索 “Fantastic MiniMax H3 Prompt Builder” 安装，或手动克隆至 custom_nodes 目录。
- 重要：安装后需完全重启 ComfyUI。
- 确保已安装 PyAV 或 ffmpeg 以支持参考视频处理（pip install av）。
基本工作流：
- 添加 MiniMax H3 Prompt Builder 节点。
- 点击 Edit prompt...，选择模式（如 FL2VA）。
- 填写字段（首帧、尾帧、镜头描述等），右侧面板会实时显示生成的结构化提示词。
- 点击 Save to node。
- 将 Builder 的 prompt 输出连接到 H3 采样器节点。
- 若使用参考图，可通过 Media Loader 拖入图片，点击缩略图插入标签，并将 Builder 的 picture_1 等输出连接到 H3 节点的对应输入。
提示词库使用：
- 编写好满意的提示词后，点击编辑器标题栏的 ☰ Library -> Save current prompt。
- 下次需要类似风格时，直接从库中加载，所有字段自动恢复，只需微调即可。