%20(1).png)
ComfyUI_CGAnimittaTools 插件完全使用指南
1. 插件简介
ComfyUI_CGAnimittaTools 是一个功能丰富的ComfyUI自定义插件包，由作者在日常使用ComfyUI过程中遇到问题时开发的一系列简单功能节点。
插件GitHub地址： https://github.com/cganimitta/ComfyUI_CGAnimittaTools
这个插件就像一个"万能工具箱"，包含了很多实用的小功能，比如：
- 把3D模型从ComfyUI发送到Blender（就像搭建一座桥梁连接两个软件）
- 从列表中提取想要的内容（就像从购物清单中挑选特定商品）
- 读取文本文件（就像打开一本书来查看内容）
- 批量处理图片和视频（就像流水线一样自动处理大量文件）
- 智能裁剪图片黑边（就像自动修剪照片边框）
2. 如何安装
方法一：使用ComfyUI Manager（推荐）
- 打开ComfyUI，点击右侧的"Manager"按钮
- 选择"Install Custom Nodes"
- 在搜索框中输入"CGAnimittaTools"
- 找到对应插件，点击"Install"
- 重启ComfyUI
方法二：手动安装
- 打开ComfyUI安装目录下的
custom_nodes文件夹 - 在这个文件夹里打开终端/命令行
- 输入命令：
git clone https://github.com/cganimitta/ComfyUI_CGAnimittaTools.git - 重启ComfyUI
3. 节点详细解析
3.1 CGA_BlenderBridge节点 - 连接Blender的桥梁
这个节点就像一个"快递员"，专门负责把ComfyUI中的3D模型"快递"到Blender软件中。想象一下你在ComfyUI中制作了一个3D模型，想要在Blender中进一步编辑，这个节点就能帮你实现无缝传输。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模型输入 | model_input | 3D模型数据 | - | 就像选择要寄送的包裹 | 接收3D模型数据进行传输 | 连接你的3D模型输出节点 |
| 端口号 | port | 数字 | 8080 | 就像快递的收件地址门牌号 | 网络通信端口设置 | 默认8080，如果冲突可以改成8081 |
| 发送模式 | send_mode | 自动/手动 | 自动 | 选择是自动发货还是手动发货 | 控制数据传输的触发方式 | 自动模式会实时传输，手动模式需要点击发送 |
3.2 CGA_ListExtractor节点 - 列表内容提取器
这个节点就像一个"智能挑选器"，能从一堆东西中精准找到你想要的那个。比如你有一个装满苹果的篮子，你想要第3个苹果，这个节点就能帮你准确拿到。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入列表 | input_list | 任意列表 | - | 就像准备挑选的那篮子东西 | 待处理的列表数据 | 连接任何输出列表的节点 |
| 提取位置 | extract_index | 整数 | 0 | 你想要第几个（从0开始数） | 列表中的索引位置 | 想要第一个就填0，第二个填1 |
| 提取模式 | extract_mode | 单个/范围 | 单个 | 是只要一个还是要一段 | 单个元素或范围提取 | 单个模式提取一个，范围模式提取多个 |
3.3 CGA_FolderScanner节点 - 文件夹扫描器
这个节点就像一个"文件夹管家"，能帮你快速查看某个文件夹里有多少个子文件夹，每个子文件夹叫什么名字。就像你打开衣柜，想知道里面有多少个抽屉，每个抽屉的标签是什么。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件夹路径 | folder_path | 文件夹路径 | - | 告诉它你要查看哪个文件夹 | 目标文件夹的完整路径 | 填写如：C:\Users\你的用户名\Pictures |
| 扫描深度 | scan_depth | 整数 | 1 | 要往下挖几层文件夹 | 子文件夹扫描的层级深度 | 1只看直接子文件夹，2还会看子文件夹里的子文件夹 |
| 输出格式 | output_format | 列表/文本 | 列表 | 结果是以列表形式还是文本形式给你 | 输出数据的格式类型 | 列表格式便于后续处理，文本格式便于阅读 |
3.4 CGA_TextFileReader节点 - 文本文件阅读器
这个节点就像一个"贴心的图书管理员"，能帮你打开并阅读任何文本文件的内容。无论是记事本、配置文件还是代码文件，它都能读给你听。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件路径 | file_path | 文件路径 | - | 告诉它你要读哪个文件 | 目标文件的完整路径 | 如：C:\Users\你的用户名\Desktop\memo.txt |
| 编码格式 | encoding | UTF-8/GBK等 | UTF-8 | 选择文件是用什么"语言"写的 | 文本文件的字符编码格式 | 中文文件可能需要GBK，英文文件用UTF-8 |
| 读取模式 | read_mode | 全部/行 | 全部 | 是一次性读完还是一行一行读 | 文件读取的方式 | 全部模式读取整个文件，行模式逐行读取 |
3.5 CGA_FrameExtraction节点 - 帧提取器
这个节点就像一个"视频剪辑师"，能从一段视频中按照你的要求提取出特定的画面。比如你有一段10秒的视频，想要每2秒提取一帧做成动画，这个节点就能帮你实现。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入帧序列 | input_frames | 图像序列 | - | 就像给它一摞照片 | 待处理的帧序列数据 | 连接视频或图像序列输出 |
| 提取速度 | extraction_speed | 小数 | 1.0 | 控制提取的密度，像调节音量大小 | 帧提取的间隔控制参数 | 1.0是正常速度，0.5提取更多帧，2.0提取更少帧 |
| 开始位置 | start_position | 整数 | 0 | 从第几帧开始提取 | 提取的起始帧位置 | 0表示从第一帧开始 |
| 结束位置 | end_position | 整数 | -1 | 提取到第几帧结束 | 提取的结束帧位置 | -1表示提取到最后一帧 |
3.6 CGA_ImageCropper节点 - 图像裁剪器
这个节点就像一个"智能裁缝"，专门负责去掉图片周围的黑边。就像你拍照时不小心拍进了多余的黑色边框，这个节点能自动帮你裁掉。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | input_image | 图像数据 | - | 就像给裁缝一块需要剪裁的布料 | 待处理的图像数据 | 连接任何图像输出节点 |
| 裁剪阈值 | crop_threshold | 0-255 | 30 | 多黑算黑边（数值越小越严格） | 判断黑边的像素亮度阈值 | 30比较宽松，10比较严格 |
| 裁剪模式 | crop_mode | 自动/手动 | 自动 | 让它自己判断还是你来指定 | 裁剪区域的确定方式 | 自动模式智能识别，手动模式需要指定坐标 |
| 边距保留 | margin_keep | 整数 | 5 | 裁剪后保留多少像素的边距 | 裁剪后保留的边缘像素数量 | 5像素比较保险，0会裁剪到边界 |
3.7 CGA_NegativePreset节点 - 负面提示词预设
这个节点就像一个"禁止事项清单"，里面预设了很多常用的负面提示词，告诉AI什么东西不要生成。就像你去餐厅点菜时说"不要放香菜"一样。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 预设类型 | preset_type | 选择菜单 | 通用 | 选择哪种类型的"禁止清单" | 不同场景的负面提示词集合 | 人物、风景、动漫等不同类型 |
| 强度等级 | intensity_level | 1-10 | 5 | 禁止的严格程度 | 负面提示词的权重强度 | 5是中等强度，10是最严格 |
| 自定义添加 | custom_add | 文本 | - | 你还想额外禁止什么 | 用户自定义的负面提示词 | 可以添加特定不想要的元素 |
| 输出格式 | output_format | 文本/列表 | 文本 | 结果是文本还是列表形式 | 输出数据的格式类型 | 文本格式直接连接到提示词，列表格式便于编辑 |
4. 使用技巧和建议
4.1 组合使用技巧
- 文件批处理流程：先用
CGA_FolderScanner扫描文件夹，再用CGA_TextFileReader逐个读取文件，最后用CGA_ListExtractor提取需要的内容 - 视频处理优化：使用
CGA_FrameExtraction提取关键帧后，再用CGA_ImageCropper去除黑边，能大大提高处理效率 - Blender协作：配合
CGA_BlenderBridge和Blender Layer插件，可以实现ComfyUI、Blender、Krita三软件联动
4.2 参数调节建议
- 提取速度：视频较长时建议设置为2.0-3.0，短视频可以用0.5-1.0
- 裁剪阈值：纯黑背景用30，深色背景用10-20
- 扫描深度：文件夹层级多时谨慎设置，避免扫描时间过长
4.3 性能优化建议
- 批处理大量文件时，建议分批进行，避免内存占用过高
- 使用
CGA_FrameExtraction时，先确定需要的帧数，避免提取过多无用帧 - 文本文件读取时，大文件建议使用"行"模式逐行处理
5. 常见问题解答
Q1：BlenderBridge连接失败怎么办？
A1： 检查以下几点：
- 确保Blender已经安装了对应的接收插件
- 检查端口号是否被其他程序占用
- 确认防火墙没有阻止连接
Q2：文件夹扫描节点读取不到文件夹？
A2： 可能的原因：
- 文件夹路径写错了（注意斜杠方向）
- 文件夹权限不足
- 文件夹不存在或已被删除
Q3：图像裁剪效果不理想？
A3： 调节建议：
- 降低裁剪阈值数值（让判断更严格）
- 增加边距保留值（保留更多边缘）
- 尝试手动模式指定裁剪区域
Q4：帧提取速度太慢怎么办？
A4： 优化方法：
- 增大提取速度参数值（减少提取帧数）
- 缩小提取范围（设置开始和结束位置）
- 先降低输入视频分辨率
Q5：负面提示词预设不够用？
A5： 解决方案：
- 使用自定义添加功能补充特定词汇
- 组合多个预设类型
- 调整强度等级以匹配需求
6. 进阶应用案例
6.1 自动化视频处理流程
结合多个节点创建一个完整的视频处理管道：
- 使用
CGA_FolderScanner扫描视频文件夹 - 用
CGA_FrameExtraction提取关键帧 - 用
CGA_ImageCropper去除黑边 - 批量处理完成后输出到指定文件夹
6.2 3D工作流优化
通过CGA_BlenderBridge实现：
- 在ComfyUI中生成3D模型
- 实时传输到Blender进行细节调整
- 在Blender中渲染高质量图像
- 返回ComfyUI进行后期处理
6.3 文本处理自动化
利用文本相关节点：
- 扫描包含配置文件的文件夹
- 批量读取各个配置文件
- 提取特定参数用于生成任务
- 实现配置驱动的自动化生成
这个插件的强大之处在于各个节点的灵活组合，通过合理的工作流设计，可以大大提高ComfyUI的使用效率和自动化程度。记住，熟练掌握这些基础节点后，就可以创建出复杂而高效的自动化流程！