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 節點生態系統的相容性。