%20(1).png)
ComfyUI-DreamWaltz-G 插件保姆级图文教程
1. 插件简介
DreamWaltz-G 是一个让 ComfyUI 变得更强大的小工具，它就像是给你的画笔加了一个"魔法特效包"。主要用来制作动态效果，让你的图片可以像跳舞一样动起来！
GitHub 地址：com/gt732/ComfyUI-DreamWaltz-G
2. 安装方法
就像在手机上装APP一样简单，只需要三步：
- 打开你的 ComfyUI 文件夹
- 找到
custom_nodes文件夹（没有的话就新建一个） - 在这个文件夹里执行：
git clone https://github.com/gt732/ComfyUI-DreamWaltz-G
3. 节点详细解析
3.1 DreamWaltz 节点
这个节点就像是一个魔法舞蹈编导，它能让你的图片按照特定的节奏动起来。
参数详解：
| 参数名(UI显示) | 参数名(代码里) | 参数值范围 | 建议值 | 通俗解释 | 专业解释 | 使用建议 |
|---|---|---|---|---|---|---|
| 帧数 | num_frames | 1-999 | 16 | 决定动画有多少张画面 | 生成序列的帧数 | 建议从16帧开始尝试，太多会很慢 |
| 运动幅度 | motion_scale | 0-100 | 4 | 动作幅度有多大 | 运动变换的强度系数 | 数值越大动作越夸张 |
| 平滑度 | smoothness | 0-100 | 0.5 | 动作过渡有多自然 | 帧间插值平滑度 | 值越大越圆润，但可能失真 |
3.2 DreamWaltzLoader 节点
这个节点像是一个装载机，负责把你的动画素材准备好。
参数详解：
| 参数名(UI显示) | 参数名(代码里) | 参数值范围 | 建议值 | 通俗解释 | 专业解释 | 使用建议 |
|---|---|---|---|---|---|---|
| 文件路径 | file_path | 文本 | - | 告诉软件去哪里找文件 | 输入文件的路径 | 建议用完整路径 |
| 循环模式 | loop_mode | True/False | True | 是否重复播放 | 是否循环播放序列 | 想要循环就开启 |
4. 使用技巧和建议
- 先用小帧数（比如8帧）测试效果
- 运动幅度建议从小值开始调整
- 如果动画太快，可以增加帧数
- 平滑度调高会让动作更流畅，但也更耗时
5. 常见问题解答
Q: 为什么我的动画很卡顿？
A: 可能是帧数太少或平滑度太低，试着调高这两个值。
Q: 生成很慢怎么办？
A: 可以先降低帧数和图片尺寸来测试。
Q: 为什么有时候会报错？
A: 检查一下文件路径是否正确，以及是否有足够的内存。
6. 进阶提示
- 可以把多个动画效果叠加使用
- 建议保存好成功的参数配置
- 多观察别人分享的作品和设置
希望这份教程能帮助你轻松驾驭 DreamWaltz-G 插件。记住，多尝试才能找到最适合自己的设置！