ComfyUI-H3-Motion-Context

让 MiniMax H3 视频片段拼接时动作和音频无缝衔接

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 视频生成 🍴 复刻 146 🐛 待处理 2 👀 关注 14
GitHub ↗
GitHub 星标 ★ 1357
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,GPL-3.0许可,可自行部署使用,无付费版本。

项目预览

ComfyUI-H3-Motion-Context 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类视频生成
开发团队NikoDemon80
定价模式🏷️完全免费
价格说明开源项目,GPL-3.0许可,可自行部署使用,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议GPL-3.0
主要语言Python
技术栈/模型comfyui,comfyui-nodes,minimax,video-generation
GitHub 星标★ 1357
上线时间2026-08-07 00:00:00
代码更新2026-10-18
仓库体积2.1 MB
本站数据更新2026-11-08
维护状态较活跃
收录时间2026-08-09
浏览次数8

项目介绍

ComfyUI-H3-Motion-Context 是一个为 ComfyUI 设计的自定义节点包,专门解决 MiniMax H3 视频生成模型中片段拼接时运动与音频不连续的问题。它通过“片段链接”(Clip chaining)机制,将前一段视频的末帧运动信息和音频上下文传递给后续片段,使得多段生成的视频在拼接后能保持动作流畅、音频连贯,避免了传统独立生成再拼接导致的跳变和断裂感。该工具主要面向视频创作者和 AI 生成爱好者,集成在 ComfyUI 的可视化工作流中,无需编写代码即可使用。核心能力包括自动提取和传递运动上下文、音频上下文保持、以及无缝衔接多段视频生成。项目处于早期阶段,但已提供基本功能,适合需要生成较长或连续动作视频的用户。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1357

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 5 分钟 部署方式:本地安装 4 步

环境要求

  • 已安装并运行 ComfyUI(自定义节点需放入 ComfyUI/custom_nodes/)
  • ComfyUI 版本 0.34.0 或更新(0.33.4 及更早版本需改用本包 0.3.1)
  • Python 环境随 ComfyUI 提供,无需额外安装依赖

安装与启动步骤

  1. 1下载节点包

    把项目文件夹放进 ComfyUI 的 custom_nodes 目录,README 说明直接放入文件夹即可。

    git clone https://github.com/NikoDemon80/ComfyUI-H3-Motion-Context.git ComfyUI/custom_nodes/ComfyUI-H3-Motion-Context
  2. 2重启 ComfyUI

    重启后节点才会被加载,启动日志会打印节点注册信息,此时不会改动 ComfyUI 本身。

  3. 3确认加载日志

    启动时正常只会看到一行 nodes registered 提示,说明节点已注册、布局检查尚未运行。

  4. 4首次链式生成

    在工作流中串联片段:先出片段 A,把它的末帧与音频接入 Motion Context 节点,再生成片段 B,可反复循环。

如何确认成功

重启后日志出现 h3_motion_context: nodes registered;首次使用节点时出现 layout checks passed 即表示正常。

常见问题

Q:启动后只有一行日志,正常吗?

A:正常。安装本包不会影响其他 H3 工作流,也不会提前运行任何逻辑,只有真正串联片段时才会执行布局检查。

Q:ComfyUI 版本较旧怎么办?

A:在 0.33.4 或更早版本上,节点会提示改用 0.3.1,该版本在新旧版本上都能运行。

Q:节点拒绝运行并报错?

A:说明 ComfyUI 布局代码与节点假设不一致,日志会说明改动位置,需按提示更换对应版本,避免产出坏渲染。

Q:会修改磁盘文件或我的工作流吗?

A:不会。磁盘上的文件不被编辑,ComfyUI 本身也不被修改。

注意事项

  • 只在拼接多个片段时才需要本包;若只是单次生成中锚定一张图或短片,用自带的 Add Guide for MiniMax H3 即可。
  • 节点会在首次渲染前核对自身算法与当前 ComfyUI 代码,检查不通过就直接拒绝运行。
  • 安装目录必须位于 ComfyUI/custom_nodes/ 之下,否则不会加载。

核心亮点

  • 直接解决视频拼接时运动不连续和音频断裂的痛点,提升生成视频的流畅度
  • 深度集成 ComfyUI,用户可通过可视化节点拖拽使用,无需编程
  • 支持音频上下文传递,在视频生成工具中较为少见,功能独特

不足之处

  • 项目处于早期阶段,文档和示例可能不够完善,社区支持待观察
  • 依赖 MiniMax H3 模型,需额外配置 API 或模型环境,上手门槛略高

适用场景

  • 制作长镜头或多镜头连续动作视频,如角色行走、跑步等
  • 生成带背景音乐或音效的连续场景,保持音频连贯
  • 在 ComfyUI 工作流中批量生成视频片段后自动拼接,用于动画或短视频创作

替代项目

ComfyUI-VideoHelperSuite、ComfyUI-AnimateDiff-Evolved、ComfyUI-SVD

上一篇:LiveWorld

下一篇:ComfyUI-Wan-VACE-Prep

同类项目推荐

deforum-comfy-nodes 开源

在 ComfyUI 里玩转 Deforum 动画,拖拽节点生成炫酷 AI 视频

Deforum ComfyUI Nodes - ai animation node package

★ 197 2026-08-09
Imagine360 开源

从普通视频一键生成沉浸式360度全景视频

[Neurips 2025] Imagine360: Immersive 360 Video Generation from Perspective Anchor

★ 190 2026-08-09
FreeVideo 开源

8G显存就能本地跑视频生成,老电脑也能出片

Make videos on the computer you already own. FreeVideo runs MiniMax H3 in as little ···

★ 2845 2026-10-14
CogVideo 开源

打句话或传张图,AI 立刻生成视频

text and image to video generation: CogVideoX (2024) and CogVideo (ICLR 2023)

★ 13186 2026-08-09
Vid2World 开源

把视频变成能交互的虚拟世界,驱动机器人或游戏。

Official repository for "Vid2World: Crafting Video Diffusion Models to Interactive W···

★ 78 2026-08-09
ReImagine 开源

上传照片和动作,一键生成人物视频

Official implementation of ReImagine

★ 76 2026-08-09
html-video 开源

写好代码模板,批量渲染成片不用等

Programmatic video for coding agents — HTML to video on your laptop. Turn HTML, CSS···

★ 4817 2026-08-09
Video-Generation-Paper-List 开源

一站式追踪视频生成前沿论文,紧跟技术趋势

Tracking the latest and greatest research papers on video generation.

★ 170 2026-08-09
LTX-Video 开源

一句话或一张图,高清视频马上来

Official repository for LTX-Video

★ 11341 2026-08-09