H3 Ripple

H3 Ripple 是一款专为 MiniMax H3 FL2VA 模型设计的 LoRA。其核心功能是将用户在特定选定帧（锚定帧）上进行的图像编辑，平滑且一致地传播并应用到整个现有的视频镜头中。该工具通过 ComfyUI 节点提供支持，允许用户上传外部编辑好的图像，或直接对接 Qwen Image 2.1 等本地图像编辑模型进行自动化处理。

系统环境与依赖要求

要运行 H3 Ripple，需要构建一个完整的本地生成环境，具体依赖如下：

• 基础框架：当前版本的 ComfyUI，并需安装 ComfyUI-WepeNerd 自定义节点。
• 核心模型：兼容的 MiniMax H3 FL2VA 权重文件、H3 文本编码器以及视频 VAE。
• LoRA 权重：H3 Ripple LoRA 文件。若使用附带的高级工作流，还需额外下载 Pika H3 Flex LoRA。
• 本地编辑组件（可选）：若选择本地编辑器工作流，还需部署 Qwen Image 2.1 模型及其配套的文本编码器和 VAE。

核心工作流与操作步骤

H3 Ripple 提供了两种主要的工作流模式，以适应不同的操作习惯与硬件条件：

1. H3 Ripple Simple（外部编辑模式）：
   • 从时间线中提取锚定帧并下载。
   • 在外部图像编辑软件中完成修改，确保构图和主体元素保持一致。
   • 将编辑后的图像上传回 ComfyUI 的对应节点卡片中。此模式适用于 90 帧（约 3.75 秒）的视频片段，通常设置一个锚点。
2. H3 Ripple — Local Editor（本地自动化编辑模式）：
   • 直接在 ComfyUI 画布中连接 Qwen Image 2.1 节点。
   • 输入编辑指令，由本地模型自动完成对两个锚定帧的修改，随后无缝衔接视频渲染。此模式适用于 124 帧（约 5.17 秒）的视频片段。

标准操作流程：

首先，将 minimax_H3_Ripple-v1.safetensors 文件放置于 ComfyUI/models/loras/H3/ 目录下。随后，导入官方提供的 JSON 工作流文件，并在加载器中指定对应的模型路径。在 Ripple Clip 节点中，配置源视频、时间窗口、输出分辨率及裁剪范围，并精确定位锚点。完成锚点图像编辑后，保持 Ripple Apply 节点的默认传播提示不变，直接运行工作流即可生成并对比源视频与编辑后的结果。

关键参数配置建议

为保证生成的稳定性与效率，工作流内置了经过验证的默认参数配置，用户可根据自身硬件性能进行微调：

• LoRA 强度：Ripple 与 Pika H3 Flex LoRA 的权重强度均建议设为 1.0。
• H3 采样设置：6 步采样，使用 lcm 采样器、simple 调度器，CFG（分类器自由引导）值设为 1。
• 本地编辑器设置：Qwen Image 2.1 建议配置为 25 步采样，使用 euler 采样器、simple 调度器，CFG 值为 1。
• 输出规格：默认保存的输出大小约为 1 MP（百万像素）。若硬件显存受限，可在 Ripple Clip 节点中适当降低分辨率。帧率统一设定为 24 fps。

技术局限性与注意事项

在实际工程应用中，H3 Ripple 的生成效果高度依赖于源视频素材的质量以及编辑锚点的一致性。当视频中存在快速运动、物体遮挡或摄像机视角发生剧烈变化时，算法在维持编辑特征贯穿整个镜头时会面临较大挑战。此外，由于生成模型的固有特性，输出的视频帧可能会在用户预期修改的区域之外，发生细微的细节改变。因此，在复杂场景下，可能需要多次调整锚点位置或编辑指令以达到最佳效果。