KJNodes for ComfyUI

目前这是一个相当随机的工具、模型优化和便捷性节点集合，同时尽量保持依赖项最少。

文档主要包含在节点描述和提示工具中。

安装

1. 将此仓库克隆到 custom_nodes 文件夹中。
2. 安装依赖项：pip install -r requirements.txt 或者，如果您使用便携版安装，请在 ComfyUI_windows_portable 文件夹中运行以下命令：

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

JS 扩展：

节点插入（默认热键 D，可配置）和摇动以断开连接（默认禁用，可在设置中启用）：

https://github.com/user-attachments/assets/e81f02e6-9cb0-4cb3-bcdd-67e7bd5bf6fb

节点交换（默认热键 S，可配置）：

https://github.com/user-attachments/assets/735d973e-1b8b-4936-a1fb-29736b9c063a

设置/获取

2026 年 3 月 19 日更新

对设置/获取节点进行了完整重写（据我所知，目前向后兼容）。

2026 年 3 月 19 日变更日志

新功能

• 节点 2.0 支持 — 兼容节点 2.0 以及旧版本。

• 子图支持 — 设置/获取现在可以跨子图边界工作。父图中的设置对所有子图可见，获取节点会向上搜索祖先节点。跨图连接在提示执行期间解析。

• 将连接转换为设置/获取 — 右键点击任意连接中点，将其转换为设置/获取对。

• 转换为链接 — 右键点击 Set 或 Get 节点，可将这对节点转换回直接链接。

• 将输出转换为 Set/Get — 批量操作，可将选中节点的所有输出一次性转换为 Set/Get 对。

• 画布右键菜单 — “将所有选中节点的输出转换为 Set/Get”和“将选中的 Set/Get 转换为链接”。

• 键盘快捷键 — Ctrl+Shift+S（在选中位置或光标处添加 Set），Ctrl+Shift+G（在光标处添加 Get），Ctrl+Shift+L（强制显示所有连接开关）。

• “将所有 Set/Get 转换为链接”设置 — 设置中的一键按钮，可将每个 Set/Get 对替换为直接链接，包括跨子图边界的情况。

• 显示链接设置 — 组合设置（从不 / 选中 / 始终），用于控制何时绘制 Set/Get 对之间的虚拟链接。“选中”模式仅显示当前选中的 Set/Get 节点之间的链接。Ctrl+Shift+L 可临时强制显示所有链接。

• 从连接菜单添加 Set/Get — 从插槽拖拽时，连接菜单中“添加 Reroute”旁边会出现“添加 SetNode”和“添加 GetNode”选项。

• Shift+中键创建 Set/Get — 在输出插槽上 Shift+中键点击可创建连接的 SetNode；在输入插槽上则创建连接的 GetNode。可选设置可覆盖普通中键点击，使其也创建 Set/Get 而非 Reroute。

• 添加配对的 GetNode — 右键点击 SetNode 可添加一个预配置相同名称的配对 GetNode。

• 双击 Get 跳转到 Set — 双击 GetNode 可居中并选中其配对的 SetNode。

• 默认控件值设置 — 控制 Set 节点首次连接时的初始常量值：空（默认）、插槽名称、插槽名称（小写）或插槽名称（大写）。

• 从输出推断类型 — 如果 SetNode 的输入未连接，但其输出连接到类型化输入，则 Set 会采用该类型并相应重新着色。

• Getters 子菜单可导航到子图 — SetNode 的 getter 列表现在包含跨子图的 GetNodes，并可导航到子图中以聚焦它们。

修复

• 粘贴时重命名协调 — 粘贴 Set+Get 对时，GetNodes 现在能正确跟随其 SetNode 的重命名（例如，MODEL -> MODEL_0）。

• 断开连接时重置类型/颜色 — 断开输入或输出现在能正确重置类型和颜色，但仅当两侧均未连接时。

• 仅在粘贴时去除后缀 — validateName 不再去除用户输入名称中故意的 _N 后缀。仅在粘贴时去除，以避免 FOO_0_1_2 累积。

• 连接绘制移至画布层级 — 即使节点在屏幕外或折叠时，可视化链接仍保持可见。

设置

• 设置现在在设置面板中归类于 KJNodes > Set & Get 和 KJNodes > General 类别下。