ComfyUI_cspnodes 插件保姆级教程

1. 插件简介

ComfyUI_cspnodes 是一个由 cerspense 制作的ComfyUI节点包，插件地址：https://github.com/cerspense/ComfyUI_cspnodes

这个插件就像是给你的ComfyUI工具箱增加了10个新工具，让你能够：

• 自动读取文本文件的内容（就像自动翻书机）
• 批量处理文件夹里的图片和视频（就像自动整理相册）
• 用文字生成视频（就像魔法棒一样）
• 把图片的颜色拆分开来（就像把彩色笔拆成红绿蓝三支）
• 调节数值大小（就像调节温度计）
• 把深度图转换成立体效果图（就像把平面地图变成3D地形图）

2. 如何安装

安装这个插件有两种方法：

方法一：通过ComfyUI Manager安装（推荐）

1. 打开ComfyUI，点击右下角的"Manager"按钮
2. 在弹出的窗口中选择"Install Custom Nodes"
3. 搜索"cspnodes"，找到后点击"Install"
4. 重启ComfyUI即可

方法二：手动安装

1. 找到你ComfyUI的安装文件夹
2. 进入"custom_nodes"文件夹
3. 在这里打开命令行，输入：

   git clone https://github.com/cerspense/ComfyUI_cspnodes.git
   

4. 重启ComfyUI

3. 节点详细解析

3.1 TextFileLineIterator 节点 - 文本文件读取器

这个节点就像一个自动翻书机，能够从文本文件中一行一行地读取内容。想象你有一个记录了很多提示词的文本文件，这个节点可以帮你自动逐行读取。

参数详解：

输出：

• 文本内容：返回指定行的文本内容

3.2 ImageDirIterator 节点 - 图片文件夹遍历器

这个节点就像一个智能相册管理员，能够从文件夹中按照你的要求找出图片。

参数详解：

输出：

• 图片列表：选中的图片
• 文件名列表：对应的文件名

3.3 VidDirIterator 节点 - 视频文件夹遍历器

这个节点就像图片遍历器的视频版本，专门用来从文件夹中找视频文件。

参数详解：

输出：

• 视频路径：选中的视频文件路径

3.4 Modelscopet2v 节点 - 文字生成视频魔法师

这个节点就像一个魔法师，能够根据你输入的文字描述生成对应的视频。

参数详解：

输出：

• 视频帧：生成的视频帧序列

3.5 Modelscopev2v 节点 - 视频变换魔法师

这个节点就像一个视频特效师，能够根据你的描述改变现有视频的样子。

参数详解：

输出：

• 转换后的视频帧：处理后的视频帧序列

3.6 SplitImageChannels 节点 - 颜色分离器

这个节点就像一个颜色分离器，能够把彩色图片拆分成红、绿、蓝三个单色图片。

参数详解：

输出：

• 红色通道：图片的红色成分（黑白图）
• 绿色通道：图片的绿色成分（黑白图）
• 蓝色通道：图片的蓝色成分（黑白图）

3.7 RemapRange 节点 - 数值转换器

这个节点就像一个数值转换器，能够把一个范围的数值转换到另一个范围。就像把摄氏度转换成华氏度一样。

参数详解：

输出：

• 转换后的值：重新映射后的数值

3.8 ResizeByImage 节点 - 图片尺寸匹配器

这个节点就像一个裁缝，能够把一张图片改成和另一张图片一样的尺寸。

参数详解：

输出：

• 调整后的图像：尺寸匹配参考图像的新图片

3.9 IncrementEveryN 节点 - 步进计数器

这个节点就像一个楼梯计数器，每走N步才数一次数。

参数详解：

输出：

• 计数值：按步长递增的输出值

3.10 DepthToNormalMap 节点 - 深度图立体化器

这个节点就像一个3D魔法师，能够把平面的深度图转换成有立体感的法线图。

参数详解：

输出：

• 法线图：转换后的法线图像

4. 使用技巧和建议

4.1 文件处理技巧

• 使用TextFileLineIterator时，确保文本文件编码是UTF-8，避免中文乱码
• ImageDirIterator和VidDirIterator支持多级文件夹搜索，使用"**/"前缀可以搜索所有子文件夹
• 批量处理时建议先从小批次开始测试，确认效果后再增加批次大小

4.2 视频生成技巧

• Modelscopet2v生成视频时，提示词要具体明确，避免太抽象的描述
• 视频转换时（Modelscopev2v），strength参数很重要：0.3-0.5适合轻微调整，0.7-0.9适合大幅改变
• 如果显存不足，可以开启enable_vae_slicing节省内存

4.3 图像处理技巧

• SplitImageChannels常用于制作特殊效果，比如提取特定颜色信息
• DepthToNormalMap转换时，先从默认参数开始，再根据效果调整强度
• ResizeByImage保持宽高比，适合批量统一图片尺寸

4.4 数值处理技巧

• RemapRange常用于控制动画参数，比如把0-1的值映射到-10到10的范围
• IncrementEveryN适合制作循环动画，比如每6帧切换一次效果

5. 常见问题解答

5.1 安装问题

Q：安装后找不到节点？
A：重启ComfyUI，如果还是找不到，检查custom_nodes文件夹里是否有ComfyUI_cspnodes文件夹。

Q：节点显示错误？
A：可能缺少依赖，在ComfyUI的控制台查看错误信息，通常需要安装额外的Python包。

5.2 使用问题

Q：文本文件读取乱码？
A：确保文本文件是UTF-8编码，或者在文件开头添加BOM标记。

Q：视频生成太慢？
A：减少推理步数（比如从25减到15），或者开启内存优化选项。

Q：深度图转换效果不好？
A：调整normal_intensity参数，高分辨率图片用较小值（0.5-0.8），低分辨率用较大值（1.5-2.0）。

5.3 性能问题

Q：处理大量图片时卡顿？
A：减少batch_size，或者分批处理。

Q：显存不足？
A：在视频生成节点中开启enable_vae_slicing和enable_forward_chunking。

6. 高级应用场景

6.1 批量内容生成

结合TextFileLineIterator和ImageDirIterator，可以实现：

• 批量读取提示词文件，生成大量不同内容的图片
• 自动从图片库中选择素材进行二次创作

6.2 视频工作流

使用Modelscopet2v和Modelscopev2v可以构建完整的视频制作流程：

• 先用文字生成基础视频
• 再用描述词对视频进行风格转换
• 最后用其他节点进行细节调整

6.3 循环动画制作

利用IncrementEveryN和RemapRange：

• 创建循环变化的参数
• 制作无缝循环的动画效果
• 控制动画的节奏和强度

6.4 特效制作

结合SplitImageChannels和DepthToNormalMap：

• 制作特殊的颜色通道效果
• 创建立体感强的材质贴图
• 制作游戏和动画中的特效素材

这个插件的10个节点各有特色，组合使用可以创造出非常丰富的效果。建议从简单的单个节点开始练习，逐步掌握后再尝试复杂的组合工作流。