wuwukaka/ComfyUI-WanAnimatePlus

ComfyUI‑WanAnimatePlus

是什么 – 一组用于 ComfyUI 的自定义节点，扩展了 WanVideo 流水线。新增多参考图像注入、无缝视频拼接，以及对新模型 SCAIL‑2 和 Bernini 的完整支持。

为何重要 – 原始 WanVideo 工作流仅支持单个参考图像，且难以在多次生成运行之间连续视频。WanAnimatePlus 解决了这些限制，使以下功能成为可能：

• 使用最多 5 个参考图像（prefix_frames）引导生成。
• 通过输入前一段的最后 21 帧，实现连续视频片段无缝连接（transition_video）。
• 使用 Bernini 模型完成视频到视频、参考视频到视频、参考图像到视频、文本到视频任务。
• 与 SCAIL‑2 检查点配合使用，通过专用节点处理参考图像、姿态流、掩码、背景图像和两阶段采样。

主要功能

功能	作用
prefix_frames	接收 1–5 个额外参考图像；节点扩展画布，编码图像，并自动对齐姿态/人脸偏移。
transition_video	获取前一段视频的最后 21 帧，写入生成画布前端，并在解码后裁剪，实现无缝衔接。
Bernini 支持	从源视频、参考视频或参考图像生成条件潜变量；自动检测任务类型（v2v, rv2v, r2v, t2v）。
SCAIL‑2 嵌入	将参考图像、驱动姿态、彩色姿态掩码、可选的前缀/过渡潜变量和背景图像预处理为 SCAIL‑2 模型所需的格式。
官方兼容流节点	WanAnimatePlus SCAIL_2 Flow Embeds、Flow Sampler 和 VAE Decode 暴露与原生 ComfyUI 相同的 MODEL / VAE / CONDITIONING / LATENT / IMAGE 接口，允许使用标准节点连接构建 SCAIL‑2 工作流。
简易采样器节点	WanAnimatePlus Easy Sampler 和 Easy SamplerSettings 隐藏了大量低级采样器参数，但仍使用完整的 WanAnimatePlus 采样器。
内存优化选项	如 force_offload 和 tiled_vae 等选项，可让中等 GPU 运行重型视频模型。

典型用例

• 使用多个视觉参考创建长且连贯的视频序列（例如，角色以多种姿态出现）。
• 扩展现有片段——例如，继续动画或编辑视频末尾。
• 将源视频的运动转移到新主体，同时注入参考图像。
• 使用 SCAIL‑2 模型实现高质量姿态驱动动画，支持可选背景替换。

安装

# 在 ComfyUI 安装目录内
cd ComfyUI/custom_nodes
git clone https://github.com/wuwukaka/ComfyUI-WanAnimatePlus.git
# 重启 ComfyUI 以注册新节点

README 指出，原始 ComfyUI‑WanVideoWrapper 也必须安装，但 不要在同一个工作流中混用 WanAnimatePlus 节点与原始 WanVideo 节点。

快速启动工作流

1. 打开 ComfyUI；新的类别 WanAnimatePlus 将出现。
2. 将标准 WanVideo 链替换为 WanAnimatePlus 的等效节点：
   • WanAnimatePlus ModelLoader
   • WanAnimatePlus VAELoader
   • WanAnimatePlus ContextOptions
   • WanAnimatePlus AnimateEmbeds（现在支持 prefix_frames 和 transition_video 输入）
   • WanAnimatePlus Sampler / Easy Sampler
   • WanAnimatePlus Decode
3. 连接可选输入：
   • 前缀帧 – 最多 5 个参考图像。
   • 过渡视频 – 前一段的最后 21 帧。
   • SCAIL‑2 用：使用 WanAnimatePlus SCAIL_2 Embeds（或流版本）配合姿态图、掩码等。
4. 运行工作流。若提供了过渡片段，输出视频将裁剪掉前置帧，实现平滑延续。

示例资源

• example_workflows/ – 包含多参考生成、视频延续和 SCAIL‑2 使用的预设 JSON 工作流。
• README 中的 RunningHub 链接可让你在免费云实例上试用工作流（使用邀请码可获 1,000 积分）。

项目结构 – 仓库遵循典型的 ComfyUI 自定义节点布局：核心节点定义（nodes.py, nodes_sampler.py）、模型加载辅助、上下文窗口调度和工具模块。所有核心处理逻辑位于 wanvideo/ 子目录中，是原始 WanVideo 代码的分叉版本。

许可证与署名 – Apache‑2.0，附带 NOTICE 文件，致谢上游项目 ComfyUI‑WanVideoWrapper 及其他辅助项目。

---

总结 – 如果你已在使用 ComfyUI 进行视频生成，并需要多参考控制或无缝拼接功能，WanAnimatePlus 提供了一套即插即用的节点，扩展了 WanVideo 流水线，同时保持与官方 ComfyUI 节点生态系统的兼容性。