%20(1).png)
ComfyUI Dream Project 插件完全教程
1. 插件简介
插件地址： https://github.com/alt-key-project/comfyui-dream-project
ComfyUI Dream Project 是一个专门为制作动画视频而设计的插件包，就像是给 ComfyUI 装上了一套专业的动画制作工具箱。这个插件可以帮你：
- 制作流畅的动画视频：就像用手机拍延时摄影一样，但更专业
- 控制图片的运动轨迹：让图片可以放大缩小、左右移动，就像摄像机镜头一样
- 调节颜色和亮度变化：让画面颜色随时间变化，营造不同氛围
- 生成各种曲线效果：控制动画的节奏，比如快慢变化、波浪起伏等
- 批量处理图片序列：一次性处理成百上千张图片，最后合成视频
2. 如何安装
方法一：ComfyUI Manager 安装（推荐）
- 打开 ComfyUI Manager
- 搜索 "Dream Project Animation"
- 点击安装即可
方法二：手动安装
- 进入 ComfyUI 的
custom_nodes文件夹 - 运行命令：
git clone https://github.com/alt-key-project/comfyui-dream-project.git - 进入插件文件夹：
cd comfyui-dream-project - 安装依赖：
pip install -r requirements.txt - 重启 ComfyUI
3. 节点详细解析
3.1 Frame Counter (Simple) 节点 - 简单帧计数器
这个节点就像一个计时器，告诉系统现在播放到第几帧了，总共要播放多少帧。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_index | frame_index | 0-无限大 | 0 | 现在播放到第几帧了，就像视频进度条的位置 | 当前帧索引，从0开始计数 | 制作10秒动画，30fps，那么第5秒时这里应该是150 |
| total_frames | total_frames | 1-86400000 | 100 | 总共要播放多少帧，就像视频总长度 | 动画序列的总帧数 | 10秒30fps的视频总共300帧 |
| frames_per_second | frames_per_second | 1-无限大 | 25 | 每秒播放多少帧，数字越大动画越流畅 | 帧率，影响动画播放速度和流畅度 | 电影一般24fps，游戏60fps，这里建议30fps |
3.2 Frame Counter (Directory) 节点 - 目录帧计数器
这个节点会自动数一个文件夹里有多少张图片，然后决定从第几帧开始。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| directory_path | directory_path | 文件夹路径 | 空字符串 | 图片存放的文件夹位置，就像家庭住址 | 目标目录的绝对路径 | /Users/用户名/Pictures/动画帧/ |
| pattern | pattern | 文件匹配模式 | * | 要找什么样的文件，*表示所有文件 | 文件名匹配模式，支持通配符 | .jpg 只找jpg图片，frame_.png 找以frame_开头的png |
| indexing | indexing | numeric/alphabetic order | numeric | 按数字排序还是字母排序 | 文件排序方式 | 有frame_1.jpg, frame_10.jpg时，数字排序更合理 |
| total_frames | total_frames | 2-86400000 | 100 | 动画总帧数 | 完整动画序列的帧数 | 同上 |
| frames_per_second | frames_per_second | 1-无限大 | 30 | 每秒帧数 | 动画播放帧率 | 同上 |
3.3 Frame Counter Info 节点 - 帧计数器信息
这个节点就像一个仪表盘，显示动画播放的各种状态信息。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 连接其他帧计数器节点 | 输入的帧计数器对象 | 连接Simple或Directory帧计数器 |
输出信息：
- frames_completed: 已完成多少帧
- total_frames: 总帧数
- first_frame: 是否第一帧
- last_frame: 是否最后一帧
- elapsed_seconds: 已播放秒数
- remaining_seconds: 剩余秒数
- total_seconds: 总秒数
- completion: 完成百分比
3.4 Frame Counter Offset 节点 - 帧计数器偏移
这个节点可以让动画提前或延后几帧开始，就像调整视频的起始时间。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 要调整的帧计数器 | 输入的帧计数器对象 | 连接其他帧计数器节点 |
| offset | offset | 整数 | -1 | 偏移多少帧，负数表示提前，正数表示延后 | 帧偏移量 | -10表示提前10帧开始，+5表示延后5帧 |
3.5 Frame Counter Time Offset 节点 - 帧计数器时间偏移
和上面类似，但是用秒数来调整，更直观。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 要调整的帧计数器 | 输入的帧计数器对象 | 连接其他帧计数器节点 |
| offset_seconds | offset_seconds | 浮点数 | 0.0 | 偏移多少秒，负数提前，正数延后 | 时间偏移量（秒） | -2.5表示提前2.5秒，+1.0表示延后1秒 |
3.6 Frame Count Calculator 节点 - 帧数计算器
这个节点帮你算出指定时长需要多少帧，就像计算器一样。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| hours | hours | 0-23 | 0 | 小时数 | 时长的小时部分 | 制作1小时视频就填1 |
| minutes | minutes | 0-59 | 0 | 分钟数 | 时长的分钟部分 | 制作30分钟视频就填30 |
| seconds | seconds | 0-59 | 10 | 秒数 | 时长的秒数部分 | 制作45秒视频就填45 |
| milliseconds | milliseconds | 0-59 | 0 | 毫秒数 | 时长的毫秒部分 | 一般用不到，保持0即可 |
| frames_per_second | frames_per_second | 1-无限大 | 30 | 每秒帧数 | 目标帧率 | 30fps是常用值 |
3.7 File Count 节点 - 文件计数器
这个节点数一个文件夹里有多少个符合条件的文件。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| directory_path | directory_path | 文件夹路径 | 空字符串 | 要统计的文件夹位置 | 目标目录路径 | /Users/用户名/Pictures/ |
| patterns | patterns | 文件模式 | .jpg|.png|*.jpeg | 要统计什么类型的文件，用|分隔多个类型 | 文件匹配模式，支持多个模式 | .mp4|.avi 统计视频文件 |
3.8 Sine Curve 节点 - 正弦波曲线
这个节点产生像波浪一样上下起伏的数值变化，常用于制作平滑的循环动画。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间基准 | 帧计数器输入 | 连接帧计数器节点 |
| max_value | max_value | 浮点数 | 1.0 | 波峰的最高值，就像海浪最高点 | 正弦波的最大值 | 用于缩放时，1.2表示最大放大20% |
| min_value | min_value | 浮点数 | 0.0 | 波谷的最低值，就像海浪最低点 | 正弦波的最小值 | 用于缩放时，0.8表示最小缩小到80% |
| periodicity_seconds | periodicity_seconds | 浮点数 | 10.0 | 多少秒完成一个完整的波浪循环 | 正弦波的周期（秒） | 5.0表示每5秒重复一次波浪 |
| phase | phase | -1到1 | 0.0 | 波浪的起始位置偏移 | 相位偏移 | 0.5表示从波浪中间开始 |
3.9 Saw Curve 节点 - 锯齿波曲线
这个节点产生像锯齿一样的数值变化，从最小值直线上升到最大值，然后突然跳回最小值。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间基准 | 帧计数器输入 | 连接帧计数器节点 |
| max_value | max_value | 浮点数 | 1.0 | 锯齿的最高点 | 锯齿波的最大值 | 用于旋转时，360表示最大转360度 |
| min_value | min_value | 浮点数 | 0.0 | 锯齿的最低点 | 锯齿波的最小值 | 0表示从0度开始 |
| periodicity_seconds | periodicity_seconds | 浮点数 | 10.0 | 多少秒完成一个锯齿循环 | 锯齿波的周期 | 2.0表示每2秒重复一次 |
| phase | phase | -1到1 | 0.0 | 锯齿的起始位置 | 相位偏移 | 0.5表示从中间开始上升 |
3.10 Triangle Curve 节点 - 三角波曲线
这个节点产生三角形状的数值变化，从最小值上升到最大值，再下降回最小值。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间基准 | 帧计数器输入 | 连接帧计数器节点 |
| max_value | max_value | 浮点数 | 1.0 | 三角形的顶点值 | 三角波的最大值 | 用于亮度调节时，2.0表示最亮是原来2倍 |
| min_value | min_value | 浮点数 | 0.0 | 三角形的底部值 | 三角波的最小值 | 0.5表示最暗时还有一半亮度 |
| periodicity_seconds | periodicity_seconds | 浮点数 | 10.0 | 多少秒完成一个三角形循环 | 三角波的周期 | 8.0表示每8秒完成一次明暗变化 |
| phase | phase | -1到1 | 0.0 | 三角形的起始位置 | 相位偏移 | 0.25表示从上升阶段的1/4处开始 |
3.11 Linear Curve 节点 - 线性曲线
这个节点产生直线变化，从起始值匀速变化到结束值，就像匀速直线运动。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间基准 | 帧计数器输入 | 连接帧计数器节点 |
| initial_value | initial_value | 浮点数 | 0.0 | 起始值，动画开始时的数值 | 线性插值的起始值 | 制作淡入效果时，从0开始 |
| final_value | final_value | 浮点数 | 100.0 | 结束值，动画结束时的数值 | 线性插值的结束值 | 制作淡入效果时，到1.0结束 |
3.12 Beat Curve 节点 - 节拍曲线
这个节点根据音乐节拍产生脉冲，就像跟着音乐打拍子。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间基准 | 帧计数器输入 | 连接帧计数器节点 |
| bpm | bpm | 浮点数 | 100.0 | 每分钟多少拍，就像心跳频率 | 节拍速度（每分钟节拍数） | 120表示每分钟120拍，比较快的节奏 |
| time_offset | time_offset | 浮点数 | 0.0 | 节拍的时间偏移 | 节拍起始时间偏移 | 0.5表示延后半秒开始打拍 |
| measure_length | measure_length | 1-无限大 | 4 | 一小节有几拍，常见的是4拍 | 每小节的拍数 | 4表示四四拍，3表示三四拍 |
| low_value | low_value | 浮点数 | 0.0 | 非节拍时的数值 | 节拍间隔的基础值 | 0表示不在节拍上时数值为0 |
| high_value | high_value | 浮点数 | 1.0 | 节拍时的数值 | 节拍点的峰值 | 1.0表示节拍时数值为1 |
| invert | invert | yes/no | no | 是否反转节拍 | 是否反转节拍模式 | yes表示在非节拍时数值高 |
| power | power | 0.25-4 | 2.0 | 节拍强度的幂次，影响节拍的尖锐程度 | 节拍衰减的幂指数 | 数值越大节拍越尖锐 |
| accent_1 | accent_1 | 1-24 | 1 | 第几拍有重音 | 重音节拍位置 | 1表示每小节第1拍有重音 |
| accent_2 | accent_2 | 0-24 | 0 | 第二个重音位置，0表示无 | 第二个重音节拍位置 | 3表示第3拍也有重音 |
| accent_3 | accent_3 | 0-24 | 0 | 第三个重音位置 | 第三个重音节拍位置 | 可以设置复杂的重音模式 |
| accent_4 | accent_4 | 0-24 | 0 | 第四个重音位置 | 第四个重音节拍位置 | 最多支持4个重音位置 |
3.13 Triangle Event Curve 节点 - 三角事件曲线
这个节点在指定时间产生一个三角形脉冲，就像一个短暂的尖峰。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间基准 | 帧计数器输入 | 连接帧计数器节点 |
| max_value | max_value | 浮点数 | 1.0 | 尖峰的最高值 | 三角脉冲的峰值 | 2.0表示在事件时数值达到2 |
| min_value | min_value | 浮点数 | 0.0 | 平时的基础值 | 三角脉冲的基础值 | 0表示平时数值为0 |
| width_seconds | width_seconds | 浮点数 | 1.0 | 尖峰持续多少秒 | 三角脉冲的宽度（秒） | 0.5表示尖峰持续半秒 |
| center_seconds | center_seconds | 浮点数 | 10.0 | 尖峰出现在第几秒 | 三角脉冲的中心时间 | 5.0表示在第5秒时出现尖峰 |
3.14 Smooth Event Curve 节点 - 平滑事件曲线
和上面类似，但是产生更平滑的钟形脉冲。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间基准 | 帧计数器输入 | 连接帧计数器节点 |
| max_value | max_value | 浮点数 | 1.0 | 脉冲的最高值 | 平滑脉冲的峰值 | 1.5表示事件时数值达到1.5 |
| min_value | min_value | 浮点数 | 0.0 | 平时的基础值 | 平滑脉冲的基础值 | 0.2表示平时数值为0.2 |
| width_seconds | width_seconds | 浮点数 | 1.0 | 脉冲持续时间 | 平滑脉冲的宽度 | 2.0表示脉冲持续2秒 |
| center_seconds | center_seconds | 浮点数 | 10.0 | 脉冲出现时间 | 平滑脉冲的中心时间 | 8.0表示在第8秒出现脉冲 |
3.15 WAV Curve 节点 - 音频波形曲线
这个节点可以读取音频文件，把音频的波形转换成数值变化。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间基准 | 帧计数器输入 | 连接帧计数器节点 |
| wav_path | wav_path | 文件路径 | audio.wav | 音频文件的位置 | WAV音频文件路径 | /Users/用户名/Music/bgm.wav |
| scale | scale | 浮点数 | 1.0 | 音频强度的放大倍数 | 音频振幅的缩放因子 | 2.0表示把音频强度放大2倍 |
3.16 CSV Curve 节点 - CSV曲线
这个节点可以从CSV表格文件读取预设的数值变化。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间基准 | 帧计数器输入 | 连接帧计数器节点 |
| csvfile | csvfile | 文件路径 | 空字符串 | CSV文件的位置 | CSV数据文件路径 | /Users/用户名/data.csv |
| first_column_type | first_column_type | seconds/frames | seconds | 第一列是秒数还是帧数 | 时间列的数据类型 | seconds表示第一列是时间（秒） |
| interpolate | interpolate | true/false | true | 是否在数据点之间平滑过渡 | 是否进行线性插值 | true表示数据点间平滑连接 |
| csv_dialect | csv_dialect | 方言选项 | excel | CSV文件的格式类型 | CSV解析方言 | excel表示标准Excel格式 |
3.17 CSV Generator 节点 - CSV生成器
这个节点把数值变化保存到CSV文件，用于调试或数据分析。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间基准 | 帧计数器输入 | 连接帧计数器节点 |
| value | value | 浮点数 | 0.0 | 要记录的数值 | 需要记录的数值输入 | 连接其他曲线节点的输出 |
| csvfile | csvfile | 文件路径 | 空字符串 | 保存CSV文件的位置 | 输出CSV文件路径 | /Users/用户名/output.csv |
| csv_dialect | csv_dialect | 方言选项 | excel | CSV文件格式 | CSV输出格式 | excel是最通用的格式 |
3.18 Sample Image as Palette 节点 - 图片采样调色板
从图片中随机取色，生成调色板。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片 | 必需连接 | 要取色的图片 | 输入图像数据 | 连接加载的图片 |
| samples | samples | 1-4096 | 1024 | 取多少个颜色点 | 采样点数量 | 256个点够用，太多会慢 |
| seed | seed | 0-最大整数 | 0 | 随机种子，相同种子得到相同结果 | 随机数生成种子 | 改变数字得到不同颜色组合 |
3.19 Sample Image Area as Palette 节点 - 图片区域采样调色板
从图片的特定区域取色。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片 | 必需连接 | 要取色的图片 | 输入图像数据 | 连接加载的图片 |
| samples | samples | 1-4096 | 256 | 取多少个颜色点 | 采样点数量 | 根据需要调整 |
| seed | seed | 0-最大整数 | 0 | 随机种子 | 随机数生成种子 | 控制取色的随机性 |
| area | area | 9个区域选项 | center | 从图片哪个区域取色 | 图像区域选择 | top-left取左上角颜色 |
3.20 Palette Color Align 节点 - 调色板颜色对齐
让一个调色板的颜色向另一个调色板靠拢。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| palette | palette | 调色板 | 必需连接 | 要调整的调色板 | 源调色板数据 | 连接采样节点 |
| target_align | target_align | 调色板 | 必需连接 | 目标调色板 | 目标调色板数据 | 连接另一个调色板 |
| alignment_factor | alignment_factor | 0.0-10.0 | 0.5 | 对齐强度，0不变，1完全对齐 | 颜色对齐系数 | 0.3表示轻微调整 |
3.21 Palette Color Shift 节点 - 调色板颜色偏移
调整调色板中颜色的RGB比例。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| palette | palette | 调色板 | 必需连接 | 要调整的调色板 | 输入调色板数据 | 连接调色板节点 |
| red_multiplier | red_multiplier | 0.0-100.0 | 1.0 | 红色倍数 | 红色通道乘数 | 2.0让红色更鲜艳 |
| green_multiplier | green_multiplier | 0.0-100.0 | 1.0 | 绿色倍数 | 绿色通道乘数 | 0.5减少绿色 |
| blue_multiplier | blue_multiplier | 0.0-100.0 | 1.0 | 蓝色倍数 | 蓝色通道乘数 | 1.5增强蓝色 |
| fixed_brightness | fixed_brightness | yes/no | yes | 是否保持亮度不变 | 亮度保持选项 | yes避免过亮过暗 |
3.22 Analyze Palette 节点 - 分析调色板
分析调色板的颜色特征。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| palette | palette | 调色板 | 必需连接 | 要分析的调色板 | 输入调色板数据 | 连接调色板节点 |
输出信息：
- brightness: 平均亮度
- contrast: 对比度
- redness: 红色程度
- greenness: 绿色程度
- blueness: 蓝色程度
3.23 Compare Palettes 节点 - 比较调色板
比较两个调色板的差异。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| a | a | 调色板 | 必需连接 | 第一个调色板 | 调色板A数据 | 连接调色板节点 |
| b | b | 调色板 | 必需连接 | 第二个调色板 | 调色板B数据 | 连接另一个调色板 |
3.24 Image Color Shift 节点 - 图片颜色偏移
直接调整图片的RGB颜色。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片 | 必需连接 | 要调色的图片 | 输入图像数据 | 连接图片 |
| red_multiplier | red_multiplier | 0.0以上 | 1.0 | 红色倍数 | 红色通道乘数 | 1.2增强红色 |
| green_multiplier | green_multiplier | 0.0以上 | 1.0 | 绿色倍数 | 绿色通道乘数 | 0.8减少绿色 |
| blue_multiplier | blue_multiplier | 0.0以上 | 1.0 | 蓝色倍数 | 蓝色通道乘数 | 1.5增强蓝色 |
3.25 Image Brightness Adjustment 节点 - 图片亮度调整
调整图片的整体亮度。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片 | 必需连接 | 要调整的图片 | 输入图像数据 | 连接图片 |
| factor | factor | 0.0以上 | 1.0 | 亮度倍数，1.0不变 | 亮度调整系数 | 1.5变亮50%，0.5变暗50% |
3.26 Image Contrast Adjustment 节点 - 图片对比度调整
调整图片的对比度。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片 | 必需连接 | 要调整的图片 | 输入图像数据 | 连接图片 |
| factor | factor | 0.0以上 | 1.0 | 对比度倍数 | 对比度调整系数 | 1.3增强对比度，0.7降低对比度 |
3.27 Image Motion 节点 - 图片运动
制作图片的缩放和移动动画。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片 | 必需连接 | 要运动的图片 | 输入图像数据 | 连接图片 |
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间控制 | 帧计数器输入 | 连接帧计数器 |
| zoom | zoom | -10到10 | 0.0 | 缩放速度，正数放大负数缩小 | 每秒缩放系数 | 0.1表示每秒放大10% |
| x_translation | x_translation | -10到10 | 0.0 | 水平移动速度 | 每秒水平移动系数 | 0.5表示每秒向右移动 |
| y_translation | y_translation | -10到10 | 0.0 | 垂直移动速度 | 每秒垂直移动系数 | -0.3表示每秒向上移动 |
| mask_1_feather | mask_1_feather | 0以上 | 0 | 遮罩1的羽化程度 | 第一个遮罩的边缘软化 | 10让边缘更柔和 |
| mask_1_overlap | mask_1_overlap | 0以上 | 0 | 遮罩1的重叠区域 | 第一个遮罩的重叠像素 | 5增加重叠区域 |
| mask_2_feather | mask_2_feather | 0以上 | 10 | 遮罩2的羽化程度 | 第二个遮罩的边缘软化 | 调整遮罩效果 |
| mask_2_overlap | mask_2_overlap | 0以上 | 5 | 遮罩2的重叠区域 | 第二个遮罩的重叠像素 | 控制遮罩范围 |
| mask_3_feather | mask_3_feather | 0以上 | 15 | 遮罩3的羽化程度 | 第三个遮罩的边缘软化 | 最柔和的遮罩 |
| mask_3_overlap | mask_3_overlap | 0以上 | 5 | 遮罩3的重叠区域 | 第三个遮罩的重叠像素 | 控制最外层遮罩 |
| noise | noise | 图片(可选) | 无 | 背景噪声图片 | 可选的噪声背景 | 连接噪声生成节点 |
| output_resize_width | output_resize_width | 0以上 | 0 | 输出宽度，0表示不改变 | 输出图像宽度 | 512固定输出宽度 |
| output_resize_height | output_resize_height | 0以上 | 0 | 输出高度，0表示不改变 | 输出图像高度 | 512固定输出高度 |
3.28 Noise from Palette 节点 - 调色板噪声
根据调色板生成彩色噪声图片。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| palette | palette | 调色板 | 必需连接 | 颜色来源 | 调色板数据输入 | 连接调色板节点 |
| width | width | 1-8192 | 512 | 图片宽度 | 生成图像宽度 | 常用512或1024 |
| height | height | 1-8192 | 512 | 图片高度 | 生成图像高度 | 保持宽高比 |
| blur_amount | blur_amount | 0.0-1.0 | 0.3 | 模糊程度 | 噪声模糊系数 | 0.5更柔和，0.1更锐利 |
| density | density | 0.1-1.0 | 0.5 | 噪声密度 | 噪声点密度 | 1.0最密集，0.2稀疏 |
| seed | seed | 0-最大整数 | 0 | 随机种子 | 噪声生成种子 | 改变得到不同噪声 |
3.29 Noise from Area Palettes 节点 - 区域调色板噪声
根据9个区域的不同调色板生成噪声。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| area_sharpness | area_sharpness | 0.0-1.0 | 0.5 | 区域边界清晰度 | 区域过渡锐度 | 1.0边界清晰，0.0边界模糊 |
| width | width | 1-8192 | 512 | 图片宽度 | 生成图像宽度 | 根据需要设置 |
| height | height | 1-8192 | 512 | 图片高度 | 生成图像高度 | 保持合适比例 |
| blur_amount | blur_amount | 0.0-1.0 | 0.3 | 模糊程度 | 噪声模糊系数 | 调整噪声柔和度 |
| density | density | 0.1-1.0 | 0.5 | 噪声密度 | 噪声点密度 | 控制噪声疏密 |
| seed | seed | 0-最大整数 | 0 | 随机种子 | 噪声生成种子 | 控制随机性 |
| top_left_palette | top_left_palette | 调色板(可选) | 无 | 左上角区域调色板 | 左上区域颜色源 | 连接调色板节点 |
| top_center_palette | top_center_palette | 调色板(可选) | 无 | 上中区域调色板 | 上中区域颜色源 | 可选连接 |
| top_right_palette | top_right_palette | 调色板(可选) | 无 | 右上角区域调色板 | 右上区域颜色源 | 可选连接 |
| center_left_palette | center_left_palette | 调色板(可选) | 无 | 左中区域调色板 | 左中区域颜色源 | 可选连接 |
| center_palette | center_palette | 调色板(可选) | 无 | 中心区域调色板 | 中心区域颜色源 | 可选连接 |
| center_right_palette | center_right_palette | 调色板(可选) | 无 | 右中区域调色板 | 右中区域颜色源 | 可选连接 |
| bottom_left_palette | bottom_left_palette | 调色板(可选) | 无 | 左下角区域调色板 | 左下区域颜色源 | 可选连接 |
| bottom_center_palette | bottom_center_palette | 调色板(可选) | 无 | 下中区域调色板 | 下中区域颜色源 | 可选连接 |
| bottom_right_palette | bottom_right_palette | 调色板(可选) | 无 | 右下角区域调色板 | 右下区域颜色源 | 可选连接 |
3.30 Image Sequence Loader 节点 - 图片序列加载器
从文件夹加载图片序列。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间控制 | 帧计数器输入 | 连接帧计数器 |
| directory_path | directory_path | 文件夹路径 | 空字符串 | 图片文件夹位置 | 图像序列目录路径 | /Users/用户名/frames/ |
| pattern | pattern | 文件模式 | * | 文件名匹配模式 | 文件匹配模式 | .jpg或frame_.png |
| indexing | indexing | numeric/alphabetic order | numeric | 文件排序方式 | 文件索引方式 | numeric按数字排序 |
| default_image | default_image | 图片(可选) | 无 | 找不到文件时的默认图片 | 默认图像输入 | 连接备用图片 |
3.31 Image Sequence Saver 节点 - 图片序列保存器
保存动画帧到文件夹。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间控制 | 帧计数器输入 | 连接帧计数器 |
| image | image | 图片 | 必需连接 | 要保存的图片 | 输入图像数据 | 连接处理后的图片 |
| directory_path | directory_path | 文件夹路径 | 输出目录 | 保存位置 | 输出目录路径 | /Users/用户名/output/ |
| prefix | prefix | 文件前缀 | frame | 文件名前缀 | 文件名前缀字符串 | "scene1_"生成scene1_001.png |
| digits | digits | 整数 | 5 | 文件名数字位数 | 序号补零位数 | 5表示00001,00002格式 |
| at_end | at_end | 3个选项 | stop output | 动画结束时的行为 | 序列结束处理方式 | stop output停止保存 |
| filetype | filetype | 3个选项 | png | 保存的文件格式 | 输出文件格式 | png质量好，jpg文件小 |
3.32 FFMPEG Video Encoder 节点 - 视频编码器
把图片序列合成视频文件。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| sequence | sequence | 动画序列 | 必需连接 | 图片序列数据 | 动画序列输入 | 连接Image Sequence Saver |
| name | name | 文件名 | video | 视频文件名 | 输出视频文件名 | "my_animation"生成my_animation.mp4 |
| framerate_factor | framerate_factor | 0.01-100.0 | 1.0 | 帧率倍数 | 帧率调整系数 | 2.0让视频播放快一倍 |
| remove_images | remove_images | true/false | true | 是否删除原图片 | 是否清理源图像 | true节省空间，false保留原图 |
3.33 Image Sequence Tweening 节点 - 图片序列补间
在现有帧之间插入过渡帧，让动画更流畅。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| sequence | sequence | 动画序列 | 必需连接 | 要处理的序列 | 输入动画序列 | 连接序列节点 |
| multiplier | multiplier | 2-10 | 2 | 插帧倍数 | 帧数倍增系数 | 2表示每两帧间插入1帧 |
3.34 Image Sequence Blend 节点 - 图片序列混合
对动画序列进行模糊混合处理。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| sequence | sequence | 动画序列 | 必需连接 | 要处理的序列 | 输入动画序列 | 连接序列节点 |
| fade_in | fade_in | 0.01-0.5 | 0.1 | 淡入强度 | 前向混合系数 | 0.2让过渡更明显 |
| fade_out | fade_out | 0.01-0.5 | 0.1 | 淡出强度 | 后向混合系数 | 0.15调整混合效果 |
| iterations | iterations | 1-10 | 1 | 处理次数 | 混合迭代次数 | 2次处理更柔和 |
3.35 Build Prompt 节点 - 构建提示词
构建带权重的文本提示词。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| partial_prompt | partial_prompt | 部分提示词(可选) | 无 | 之前的提示词 | 输入的部分提示词 | 连接其他Build Prompt |
| added_prompt | added_prompt | 文本 | 空字符串 | 要添加的提示词 | 新增提示词文本 | "beautiful landscape" |
| weight | weight | 浮点数 | 1.0 | 这个提示词的权重 | 提示词权重系数 | 1.5表示更重要 |
3.36 Finalize Prompt 节点 - 完成提示词
完成提示词构建，输出最终文本。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| partial_prompt | partial_prompt | 部分提示词 | 必需连接 | 构建好的提示词 | 输入的部分提示词 | 连接Build Prompt |
| adjustment | adjustment | 3个选项 | raw | 权重调整方式 | 权重标准化方法 | raw保持原始权重 |
| clamp | clamp | 0.1以上 | 2.0 | 权重限制值 | 权重上限值 | 2.0限制最大权重 |
| adjustment_reference | adjustment_reference | 0.1以上 | 1.0 | 调整参考值 | 权重调整基准 | 1.0作为标准权重 |
3.37 Random Prompt Words 节点 - 随机提示词
从文本中随机选择词语。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| partial_prompt | partial_prompt | 部分提示词(可选) | 无 | 之前的提示词 | 输入的部分提示词 | 可选连接 |
| words | words | 文本 | 空字符串 | 词语库，每行或用分隔符分开 | 候选词语文本 | "red,blue,green,yellow" |
| separator | separator | 文本 | , | 词语分隔符 | 词语分隔字符 | 逗号或换行符 |
| samples | samples | 1-100 | 1 | 选择多少个词 | 随机选择数量 | 3表示选3个词 |
| min_weight | min_weight | -10到10 | 1.0 | 最小权重 | 随机权重下限 | 0.5表示最小权重0.5 |
| max_weight | max_weight | -10到10 | 1.0 | 最大权重 | 随机权重上限 | 1.5表示最大权重1.5 |
| seed | seed | 0-最大整数 | 0 | 随机种子 | 随机选择种子 | 改变得到不同组合 |
3.38 String Input 节点 - 字符串输入
简单的文本输入节点。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| value | value | 文本 | 空字符串 | 输入的文本内容 | 字符串值 | 输入任何文本 |
3.39 Text Input 节点 - 多行文本输入
多行文本输入节点。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| value | value | 多行文本 | 空字符串 | 输入的多行文本 | 多行字符串值 | 可以输入段落文本 |
3.40 Float Input 节点 - 浮点数输入
浮点数输入节点。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| value | value | 浮点数 | 0.0 | 输入的小数 | 浮点数值 | 1.5, 0.75, -2.3等 |
3.41 Int Input 节点 - 整数输入
整数输入节点。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| value | value | 整数 | 0 | 输入的整数 | 整数值 | 10, -5, 100等 |
3.42 Big Image Switch 节点 - 大图片开关
在最多10个图片输入中选择一个。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| select | select | 0-9 | 0 | 选择第几个输入 | 输入选择索引 | 0选第一个，1选第二个 |
| on_missing | on_missing | previous/next | previous | 找不到时的处理方式 | 缺失输入处理方式 | previous向前找，next向后找 |
| input_0到input_9 | input_0到input_9 | 图片(可选) | 无 | 10个可选的图片输入 | 可选图像输入 | 连接不同的图片 |
3.43 Big Latent Switch 节点 - 大潜在空间开关
在最多10个潜在空间输入中选择一个。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| select | select | 0-9 | 0 | 选择第几个输入 | 输入选择索引 | 选择不同的潜在空间 |
| on_missing | on_missing | previous/next | previous | 找不到时的处理方式 | 缺失输入处理方式 | 自动寻找可用输入 |
| input_0到input_9 | input_0到input_9 | 潜在空间(可选) | 无 | 10个可选的潜在空间输入 | 可选潜在空间输入 | 连接不同的潜在空间 |
3.44 Big Text Switch 节点 - 大文本开关
在最多10个文本输入中选择一个。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| select | select | 0-9 | 0 | 选择第几个输入 | 输入选择索引 | 选择不同的文本 |
| on_missing | on_missing | previous/next | previous | 找不到时的处理方式 | 缺失输入处理方式 | 自动寻找可用文本 |
| input_0到input_9 | input_0到input_9 | 文本(可选) | 无 | 10个可选的文本输入 | 可选文本输入 | 连接不同的文本 |
3.45 Big Float Switch 节点 - 大浮点数开关
在最多10个浮点数输入中选择一个。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| select | select | 0-9 | 0 | 选择第几个输入 | 输入选择索引 | 选择不同的数值 |
| on_missing | on_missing | previous/next | previous | 找不到时的处理方式 | 缺失输入处理方式 | 自动寻找可用数值 |
| input_0到input_9 | input_0到input_9 | 浮点数(可选) | 无 | 10个可选的浮点数输入 | 可选浮点数输入 | 连接不同的数值 |
3.46 Big Int Switch 节点 - 大整数开关
在最多10个整数输入中选择一个。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| select | select | 0-9 | 0 | 选择第几个输入 | 输入选择索引 | 选择不同的整数 |
| on_missing | on_missing | previous/next | previous | 找不到时的处理方式 | 缺失输入处理方式 | 自动寻找可用整数 |
| input_0到input_9 | input_0到input_9 | 整数(可选) | 无 | 10个可选的整数输入 | 可选整数输入 | 连接不同的整数 |
3.47 Big Palette Switch 节点 - 大调色板开关
在最多10个调色板输入中选择一个。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| select | select | 0-9 | 0 | 选择第几个输入 | 输入选择索引 | 选择不同的调色板 |
| on_missing | on_missing | previous/next | previous | 找不到时的处理方式 | 缺失输入处理方式 | 自动寻找可用调色板 |
| input_0到input_9 | input_0到input_9 | 调色板(可选) | 无 | 10个可选的调色板输入 | 可选调色板输入 | 连接不同的调色板 |
3.48 Boolean To Float 节点 - 布尔转浮点数
根据布尔值选择两个浮点数之一。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| boolean | boolean | true/false | false | 判断条件 | 布尔值输入 | 连接条件判断节点 |
| on_true | on_true | 浮点数 | 1.0 | 条件为真时的值 | 真值对应的浮点数 | 条件成立时输出1.0 |
| on_false | on_false | 浮点数 | 0.0 | 条件为假时的值 | 假值对应的浮点数 | 条件不成立时输出0.0 |
3.49 Boolean To Int 节点 - 布尔转整数
根据布尔值选择两个整数之一。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| boolean | boolean | true/false | false | 判断条件 | 布尔值输入 | 连接条件判断节点 |
| on_true | on_true | 整数 | 1 | 条件为真时的值 | 真值对应的整数 | 条件成立时输出1 |
| on_false | on_false | 整数 | 0 | 条件为假时的值 | 假值对应的整数 | 条件不成立时输出0 |
3.50 Calculation 节点 - 数学计算
执行复杂的数学计算。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| expression | expression | 数学表达式 | a + b + c - (r * s * t) | 要计算的数学公式 | 数学表达式字符串 | "sin(a) + cos(b) * 2" |
| a_int | a_int | 整数(可选) | 0 | 变量a的整数值 | 整数变量a | 用于表达式中的a |
| b_int | b_int | 整数(可选) | 0 | 变量b的整数值 | 整数变量b | 用于表达式中的b |
| c_int | c_int | 整数(可选) | 0 | 变量c的整数值 | 整数变量c | 用于表达式中的c |
| r_float | r_float | 浮点数(可选) | 0.0 | 变量r的浮点值 | 浮点数变量r | 用于表达式中的r |
| s_float | s_float | 浮点数(可选) | 0.0 | 变量s的浮点值 | 浮点数变量s | 用于表达式中的s |
| t_float | t_float | 浮点数(可选) | 0.0 | 变量t的浮点值 | 浮点数变量t | 用于表达式中的t |
3.51 Laboratory 节点 - 实验室
超级数字生成器，用于实验和调试。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间控制 | 帧计数器输入 | 连接帧计数器 |
| key | key | 文本 | 随机值 | 这个数值的标识名 | 数值标识键 | "brightness_control" |
| seed | seed | 0-最大整数 | 0 | 随机种子 | 随机数生成种子 | 控制随机性 |
| renew_policy | renew_policy | every frame/first frame | every frame | 更新策略 | 数值更新策略 | every frame每帧都变 |
| min_value | min_value | 浮点数 | 0.0 | 最小值 | 数值范围下限 | 设置数值下限 |
| max_value | max_value | 浮点数 | 1.0 | 最大值 | 数值范围上限 | 设置数值上限 |
| mode | mode | 4种模式 | random uniform | 生成模式 | 数值生成模式 | uniform均匀分布 |
| step_size | step_size | 浮点数(可选) | 0.1 | 步长大小 | 数值变化步长 | 控制变化幅度 |
3.52 Common Frame Dimensions 节点 - 常用帧尺寸
计算常用的视频尺寸。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| size | size | 尺寸选项 | 1920 | 基础尺寸 | 基准分辨率 | 1920对应1080p |
| aspect_ratio | aspect_ratio | 比例选项 | 16:9 | 宽高比 | 画面宽高比例 | 16:9是常用比例 |
| orientation | orientation | wide/tall | wide | 横向还是竖向 | 画面方向 | wide横屏，tall竖屏 |
| divisor | divisor | 除数选项 | 8 | 尺寸除数 | 分辨率缩放因子 | 8表示缩小8倍 |
| alignment | alignment | 1-512 | 64 | 对齐像素 | 像素对齐数值 | 64保证兼容性 |
| alignment_type | alignment_type | 3种类型 | ceil | 对齐方式 | 像素对齐方式 | ceil向上对齐 |
3.53 String Tokenizer 节点 - 字符串分词器
把文本按分隔符分割，选择其中一个部分。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| text | text | 多行文本 | 空字符串 | 要分割的文本 | 输入文本字符串 | "apple,banana,orange" |
| separator | separator | 文本 | , | 分隔符 | 文本分割字符 | 逗号、空格或其他符号 |
| selected | selected | 0以上 | 0 | 选择第几个部分 | 选择的分词索引 | 0选第一个，1选第二个 |
3.54 Log File 节点 - 日志文件
把信息记录到日志文件。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| frame_counter | frame_counter | 帧计数器 | 必需连接 | 时间信息 | 帧计数器输入 | 连接帧计数器 |
| log_directory | log_directory | 文件夹路径 | 输出目录 | 日志保存位置 | 日志目录路径 | /Users/用户名/logs/ |
| log_filename | log_filename | 文件名 | dreamlog.txt | 日志文件名 | 日志文件名称 | "animation.log" |
| stdout | stdout | true/false | true | 是否同时显示在控制台 | 控制台输出开关 | true在屏幕上也显示 |
| active | active | true/false | true | 是否启用日志 | 日志功能开关 | false关闭日志功能 |
| clock_has_24_hours | clock_has_24_hours | true/false | true | 时间格式 | 时间显示格式 | true用24小时制 |
| entry_0到entry_7 | entry_0到entry_7 | 日志条目(可选) | 无 | 8个可选的日志输入 | 可选日志条目输入 | 连接其他日志节点 |
3.55 String to Log Entry 节点 - 字符串转日志条目
把文本转换为日志条目。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| text | text | 文本 | 空字符串 | 要记录的文本 | 日志文本内容 | "Processing frame completed" |
| label | label | 文本(可选) | 空字符串 | 文本标签 | 日志条目标签 | "Status: " |
3.56 Int to Log Entry 节点 - 整数转日志条目
把整数转换为日志条目。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| value | value | 整数 | 0 | 要记录的整数 | 整数值 | 当前帧数或其他数值 |
| label | label | 文本 | 空字符串 | 数值标签 | 数值描述标签 | "Current frame: " |
3.57 Float to Log Entry 节点 - 浮点数转日志条目
把浮点数转换为日志条目。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| value | value | 浮点数 | 0 | 要记录的浮点数 | 浮点数值 | 当前缩放比例或其他数值 |
| label | label | 文本 | 空字符串 | 数值标签 | 数值描述标签 | "Zoom level: " |
3.58 Log Entry Joiner 节点 - 日志条目合并器
合并多个日志条目。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| entry_0到entry_3 | entry_0到entry_3 | 日志条目(可选) | 无 | 4个可选的日志条目 | 可选日志条目输入 | 连接不同的日志节点 |
4. 使用技巧和建议
4.1 制作基础动画的步骤
- 先用 Frame Counter (Simple) 设置动画长度和帧率
- 用各种 Curve 节点控制参数变化
- 连接到 Image Motion 节点制作运动效果
- 用 Image Sequence Saver 保存每一帧
- 最后用 FFMPEG Video Encoder 合成视频
4.2 曲线选择建议
- Sine Curve: 适合循环动画，如呼吸效果、波浪运动
- Linear Curve: 适合简单的渐变，如淡入淡出
- Beat Curve: 适合配合音乐的节奏动画
- Triangle Event: 适合突发事件，如闪光效果
4.3 性能优化
- 合理设置帧率，不要盲目追求高帧率
- 图片尺寸适中，太大会影响处理速度
- 复杂动画可以分段制作再合并
5. 常见问题解答
Q: 为什么我的动画不流畅？
A: 检查帧率设置，建议30fps。同时确保图片尺寸不要太大。
Q: 如何制作循环动画？
A: 使用 Sine Curve 或 Triangle Curve，设置合适的周期时间。
Q: CSV文件格式要求？
A: 第一列是时间（秒或帧），第二列是数值，用逗号分隔。
Q: 音频文件支持什么格式？
A: 目前只支持未压缩的WAV格式音频文件。
Q: 如何调试动画参数？
A: 使用 CSV Generator 节点记录数值变化，用Excel等软件查看曲线。
6. 完整节点统计
节点分类统计：
- 帧计数器相关： 7个节点
- 曲线生成： 10个节点
- 颜色处理： 9个节点
- 图像处理： 4个节点
- 序列处理： 6个节点
- 提示词处理： 3个节点
- 输入节点： 4个节点
- 开关节点： 7个节点
- 数学计算： 2个节点
- 日志工具： 6个节点
7. 高级使用技巧
7.1 制作复杂动画的工作流程
- 规划阶段：确定动画时长、帧率、分辨率
- 时间控制：设置Frame Counter作为时间基准
- 参数控制：用各种Curve节点控制动画参数
- 图像处理：用Image Motion等节点制作视觉效果
- 序列输出：用Image Sequence Saver保存帧序列
- 后期处理：用Tweening、Blend等节点优化动画
- 视频合成：用FFMPEG Video Encoder生成最终视频
7.2 性能优化建议
- 合理设置分辨率：不要盲目追求4K，1080p通常够用
- 控制帧率：30fps是性能和质量的平衡点
- 分段渲染：长动画可以分段制作再合并
- 清理临时文件：及时删除中间文件节省空间
7.3 调试技巧
- 使用Laboratory节点：实验不同参数组合
- CSV Generator记录数据：把曲线数据导出分析
- Log File追踪进度：监控渲染进度和问题
- Switch节点快速切换：在不同效果间快速切换
8. 常见问题解答
Q: 动画卡顿怎么办？
A: 检查帧率设置，降低分辨率，或使用Tweening节点增加中间帧。
Q: 颜色效果不理想？
A: 尝试调整Palette相关节点的参数，或使用Image Color Shift直接调整。
Q: 如何制作循环动画？
A: 使用周期性曲线（Sine、Triangle等），确保起始和结束状态一致。
Q: 视频文件太大？
A: 调整FFMPEG编码参数，或使用jpg格式代替png保存帧。
Q: 如何同步音频？
A: 使用WAV Curve节点读取音频文件，让动画跟随音频节拍。
教程完成！ 本教程已完整覆盖ComfyUI Dream Project插件的全部58个节点，提供了从基础使用到高级技巧的完整指南。虽然该插件已停止更新，但对于学习ComfyUI动画制作原理仍然具有重要价值。