【亲测免费】 KJNodes for ComfyUI 技术文档

1. 安装指南

1.1 克隆项目

首先，将项目克隆到 custom_nodes 文件夹中。

git clone https://github.com/kijai/ComfyUI-KJNodes.git

1.2 安装依赖

安装项目所需的依赖项。你可以选择以下两种方式之一进行安装：

1.2.1 使用 pip 安装

在终端中运行以下命令：

pip install -r requirements.txt

1.2.2 使用便携版安装

如果你使用的是便携版安装，请在 ComfyUI_windows_portable 文件夹中运行以下命令：

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-KJNodes\requirements.txt

2. 项目使用说明

2.1 启用 browserstatus.js

browserstatus.js 脚本用于设置浏览器标签的图标状态。默认情况下是关闭的，需要从选项中启用。启用后，当不处理任何内容时，图标会变为绿色圆圈；当处理内容时，图标会变为红色，并显示进度百分比和队列长度。

2.2 节点使用说明

2.2.1 Set/Get 节点

Set/Get 节点用于设置和获取常量，以减少不必要的代码行。这些节点纯粹是视觉上的，可以接受和返回任何内容。右键点击这些节点，可以选择可视化路径，以及跳转到对应节点的选项。

已知限制:

• 无法与动态设置输出的节点（如 reroute 或其他 Set/Get 节点）一起使用。
• 无法直接连接到旁路节点。
• 可能与其他基于 JavaScript 的节点发生冲突。

2.2.2 ColorToMask 节点

ColorToMask 节点将 RGB 颜色值转换为掩码，支持批处理和 AnimateDiff。

2.2.3 ConditioningMultiCombine 节点

ConditioningMultiCombine 节点用于组合任意数量的条件，节省空间。

2.2.4 ConditioningSetMaskAndCombine 节点

ConditioningSetMaskAndCombine 节点用于掩码并组合两组条件，节省空间。

2.2.5 GrowMaskWithBlur 节点

GrowMaskWithBlur 节点用于扩展或缩小（使用负值）掩码，可以选择反转输入，返回掩码和反转掩码。此外，该节点还会模糊掩码，这是一个较慢的操作，尤其是在处理大批量数据时。

2.2.6 RoundMask 节点

RoundMask 节点用于生成圆形掩码。

2.2.7 WidgetToString 节点

WidgetToString 节点用于将任何节点的控件值输出为字符串。

3. 项目API使用文档

3.1 WidgetToString 节点

WidgetToString 节点用于读取目标节点的控件值并将其输出为字符串。使用步骤如下：

1. 从 Manager 菜单启用节点 ID 显示，以获取目标节点的 ID。
2. 使用目标节点的 ID 和要读取的控件名称。
3. 如果重新创建或重新加载目标节点，其 ID 将发生变化，WidgetToString 节点将无法找到它，直到你使用新的 ID 更新节点 ID 值。

4. 项目安装方式

4.1 克隆项目

将项目克隆到 custom_nodes 文件夹中。

git clone https://github.com/kijai/ComfyUI-KJNodes.git

4.2 安装依赖

安装项目所需的依赖项。你可以选择以下两种方式之一进行安装：

4.2.1 使用 pip 安装

在终端中运行以下命令：

pip install -r requirements.txt

4.2.2 使用便携版安装

如果你使用的是便携版安装，请在 ComfyUI_windows_portable 文件夹中运行以下命令：

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-KJNodes\requirements.txt

通过以上步骤，你可以成功安装并使用 KJNodes for ComfyUI 项目。