kijai/ComfyUI-KJNodes

什么是 ComfyUI‑KJNodes？

ComfyUI‑KJNodes 是 ComfyUI（用于构建 Stable Diffusion 及其他生成式 AI 流水线的可视化节点式界面）的插件。该仓库提供了一组额外的节点和 UI 辅助工具，使大型图谱的组织、优化和调试更加容易。

核心理念

特性	说明（用通俗语言）
实用 / QoL 节点	执行常见任务的小型模块（例如设置和获取值、转换连接），避免重复布线相同模式。
模型优化辅助	无需引入重型外部库即可调整模型参数或缓存结果。
最小依赖	仅需 requirements.txt 中列出的包，安装轻量。
子图感知	Set/Get 节点可在嵌套图中工作——父图中设置的值可在任意子图中读取，UI 可在它们之间跳转。
键盘快捷键与鼠标手势	如 D（插入节点）、S（交换节点）、Ctrl+Shift+S/G/L（快速创建 Set/Get），以及中键快捷键可加快图谱编辑。
视觉连接切换	由 Set/Get 对创建的虚拟连接可按需显示或隐藏，有助于保持画布可读性。
画布扩展功能	右键菜单支持在直接连接与 Set/Get 对之间转换、批量转换多个节点，以及从连接菜单直接添加 Set/Get 节点。

安装方法

1. 将仓库克隆到 ComfyUI 安装目录的 custom_nodes 文件夹中。
2. 运行 pip install -r requirements.txt（或使用 README 中显示的便携式安装命令）。
3. 重启 ComfyUI —— 新节点将出现在 KJNodes 分类下。

最近重大更新（2026年3月19日）

作者重写了 Set/Get 系统，使其 向后兼容 并支持新的 Nodes 2.0 格式。亮点包括：

• Set/Get 值在子图间的跨图可见性。
• 右键菜单实现连接与 Set/Get 对之间的转换。
• 一次性批量转换多个输出。
• 新增默认控件值、类型推断和连接可见性模式设置。
• 复制粘贴节点时改进重命名处理。

谁可能使用它？

• 艺术家与提示工程师：构建复杂 Stable Diffusion 工作流，希望以更清晰的方式在多个节点间共享常量（如模型名称、种子）。
• 研究人员：快速原型化新流水线步骤，需要快速、可逆的重连，而不让图谱变得杂乱。
• 高级用户：在 ComfyUI 画布上花费大量时间，欣赏快捷键、视觉提示和子图导航功能。

局限性

• 该插件仅添加 UI/图谱管理功能；不提供新的扩散模型或推理引擎。
• 功能与目标 ComfyUI 版本绑定；若 ComfyUI 核心 API 发生重大变化，节点可能需要更新。

---

TL;DR: ComfyUI‑KJNodes 是一个轻量、依赖少的扩展，为 ComfyUI 用户提供更丰富的实用节点、跨子图智能的 Set/Get 处理，以及多种键盘/鼠标快捷键，让大型 AI 生成图谱保持整洁且易于编辑。