MiniMax H3 Prompt Builder 1.8.0：ComfyUI 中的蒙版片段编辑

该插件包自带的参考模式链路：Media Loader → Prompt Builder → MiniMax H3 参考转视频。

蒙版片段编辑

1.8.0 版本回答了 H3 用户经常遇到的问题：只改动片段中的某一处，而让其余画面保持不变。蒙版决定模型可以在哪些区域进行改动，提示词则决定该区域会变成什么样子。

在 Media Loader 中右键点击某个片段并选择 Mask for editing，即可打开蒙版标签页，它会基于该片段当前的修剪、裁剪和镜像状态进行操作。蒙版由像图像编辑器那样堆叠的图层构成，每个新图层都可以将其区域 Add（添加）到下方图层，或从中 Cut（抠除）：

• Auto Mask with SAM：通过提示词和点来创建蒙版。在清晰帧上点击目标，右键点击要排除的内容，并输入它是什么（“绿色夹克”），这样只有点标记下方对应的部分才会被蒙版。在多个帧上运行时，每个标记帧都会重新初始化跟踪，这正是修复漂移蒙版的方法。
• Ellipse、Rectangle 和 Polygon 图层由手工绘制并打关键帧：在另一帧上移动或调整大小，它会跟随主体，支持 Smooth、Linear 或 Ease 插值，以及用于离开画面对象的 Hidden 关键帧。
• Brush 可在单帧、从当前帧到结尾，或整个片段上绘制或擦除。

Use this mask 会将保留范围内的图层合并，并随片段一起保存，使其始终保持可编辑状态，此时卡片会显示 Video 1 · editing。在节点图一侧，RefMod Text Encode 构建编辑内容，新的 Fantastic H3 Edit Composite 节点则把重新生成的区域精确粘贴回原始帧，因此蒙版之外的一切都保持拍摄时的原样。

蒙版功能需要位于 models/checkpoints 中的 SAM 3.1 模型 sam3.1_multiplex_fp16.safetensors。该插件包不会替你下载它。

RefMod 库：创建、编辑、整理并标记可复用的引用包。

更快的 RefMod 编码

RefMod 现在会把展示给文本编码器的图片保存在自己的文件中，因此编码器不再每次运行时都解码它们。较旧的 RefMod 会被解码一次并缓存，库中的 Store encoder frames 操作可将这些帧永久写入旧文件。

Text Encode 上新增的实验性 stack_pictures 设置决定一个 RefMod 有多少张图片会送入编码器：每第四张（之前的行为）、最多八张，或全部。看到更多图片有助于保持身份一致性，并减少多个 RefMod 之间的串扰，代价是占用更多内存和生成时间。

1.8.0 的其他更新

修剪与裁剪编辑器，也用于从片段中直接抽取一帧到图片引用池中。

• 修剪编辑器新增了时间线缩放、显示播放头越过首个保留帧多远的读数、关闭前的未保存更改提示，以及不再会影响到背后节点图的 Ctrl+Z。
• 在任何构建器字段中右键点击已选择的文本，现在除了“将所选内容保存为短语”之外，还会提供 Copy、Cut、Paste 和 Remove。
• Media Loader 中的 Clean up 会删除无人使用的蒙版文件和过时的已保存 latent，保留仍被已保存媒体集和草稿引用的蒙版，并在未使用蒙版超过 500 MB 时主动提示执行。
• voice_description_at_label 会将每个声音 RefMod 保存的描述直接写在其 <Audio n>: 标签之后。
• 新建 RefMod 的短边默认值从 1024 px 改为 768 px。
• 内置指南新增了关于蒙版编辑的 E 部分，README 的发布说明则移至单独的 CHANGELOG.md。

安装

该插件包需要 ComfyUI 0.30.0 或更新版本，以及常用的 H3 模型：用于文本和关键帧工作的 fl2va，以及用于参考模式的 ref2va。视频和音频解码通过 PyAV 完成，正常安装的 ComfyUI 已经自带。

cd ComfyUI/custom_nodes
git clone https://github.com/Adudeguyman/ComfyUI-Fantastic-MiniMaxH3-PromptBuilder

之后请彻底重新启动 ComfyUI，然后在节点菜单中搜索 MiniMax H3。该插件包也可以通过 ComfyUI Manager 搜索 “Fantastic H3 Prompt Builder” 进行安装。

仓库： Adudeguyman/ComfyUI-Fantastic-MiniMaxH3-PromptBuilder
RefMods 指南： REFMODS.md
更新日志： CHANGELOG.md
基础模型： Comfy-Org/MiniMax-H3