ComfyUI-自定义脚本

⚠️ 虽然这些扩展大部分都能正常工作，但我目前非常忙碌，无法及时跟进这里的所有内容，感谢您的耐心！

安装

1. 克隆仓库： git clone https://github.com/pythongosssss/ComfyUI-Custom-Scripts.git
   到你的 ComfyUI custom_nodes 目录中。

   脚本随后会自动安装所有自定义脚本和节点。
   它会尝试使用符号链接和连接点来避免复制文件，并保持文件的最新状态。

• 卸载方法：
  • 删除 custom_nodes 中克隆的仓库
  • 确保 web/extensions/pysssss/CustomScripts 也被移除

更新

1. 导航到克隆的仓库，例如 custom_nodes/ComfyUI-Custom-Scripts
2. git pull

功能

自动补全

提供嵌入和自定义词汇的自动补全功能。你可以通过点击列表上的信息图标查看嵌入详情。
通过设置定义你的自定义词汇列表。

你可以使用“加载”按钮快速默认为 danbooru 标签，或者加载/管理其他自定义词汇列表。

自动排列图

添加了一个菜单选项，可以按照执行顺序自动排列图，这使得非常宽的图也能整齐排列！

始终吸附网格

增加了一个设置，使移动节点时始终吸附网格。

[测试] “更好”的加载器列表

添加了自定义的 Lora 和 Checkpoint 加载节点，这些节点能够显示预览图片。只需在文件旁边放置一个 png 或 jpg 文件，鼠标悬停时就会在列表中显示（例如 sdxl.safetensors 和 sdxl.png）。
也可以通过设置启用子文件夹：

添加了一个“示例”小部件，用于加载示例提示、触发词等：

这些文件应存储在与模型名称匹配的文件夹中，例如，如果模型是 loras/add_detail.safetensors，则将文件放在 loras/add_detail/*.txt 中。
要快速将生成的图像保存为该模型的预览图，可以在节点上的图像上右键单击，选择“另存为预览”，然后选择要保存预览的模型：

Checkpoint/LORA/嵌入信息

添加了“查看信息”菜单选项，用于查看所选 LoRA 或 Checkpoint 的详细信息。要查看嵌入详情，在使用嵌入自动补全时点击信息按钮即可。

图像约束

添加了一个节点，用于将图像调整为最大和最小尺寸，必要时还可以进行裁剪。

自定义颜色

为节点和组添加了自定义颜色选择器。

页签状态

为窗口添加了页签和标题，生成时页签颜色会发生变化，窗口标题会显示队列中的提示数量。

图像流

添加了一个面板，显示当前会话中已生成的图像。你可以通过 ComfyUI 设置界面控制图像添加的方向和面板的位置，通过面板顶部的滑块调整面板和图像的大小。

KSampler（高级）去噪助手

提供了一种简单的方法，可以在高级采样器上设置自定义去噪参数。

数学表达式

允许使用图中的值来计算复杂的表达式。你可以输入 INT、FLOAT、IMAGE 和 LATENT 类型的值。

其他节点的值可以通过节点的“属性”菜单项或节点标题中的“用于搜索和替换的节点名称”来引用。
支持的运算符：+ - * /（基本运算）//（向下取整除法）**（幂运算）^（异或）%（取模）
支持的函数：floor(num, dp?) floor(num) ceil(num) randomint(min,max)
如果使用 LATENT 或 IMAGE，可以通过 a.width 或 a.height 获取其尺寸，其中 a 是输入名称。

节点查找

添加了一个菜单项，用于跟随/跳转到正在执行的节点，以及一个菜单，可快速跳转到特定类型的节点。

预设文本

添加了一个节点，允许你保存和使用文本预设（例如用于你的“常规”负面提示）。

快速节点

为一些节点添加了多个菜单项，以便快速设置图中的常见部分。

播放声音

当节点被执行时播放声音，可以选择在每次提示后播放，或仅在队列为空时播放以排队多个提示。
你可以通过替换 mp3 文件 ComfyUI/custom_nodes/ComfyUI-Custom-Scripts/web/js/assets/notify.mp3 来自定义声音。

系统通知

当节点执行时，通过浏览器发送系统通知，可以在每次提示后或仅在队列为空时触发，以便排队处理多个提示。

[开发中] 重复器

该节点允许你创建输入节点的N次重复列表，或者从输入节点生成N个输出。
你可以选择是否重复使用输入节点，或者每次创建一个新的实例（例如，检查点加载器希望重复使用，而随机数则需要每次都不同）。 待办事项：为通配符输出添加类型安全检查，以确保与输入匹配。

显示文本

接收来自产生字符串的节点的输入并显示出来，适用于询问器、提示生成器等场景。

在菜单上显示图像

在底部菜单上显示当前正在生成的图像，可通过设置菜单关闭此功能。

字符串函数

支持追加和替换文本。
在“追加”模式下，“tidy_tags”会在各部分之间添加逗号。
“替换”模式支持使用正则表达式进行替换，只需输入 /your regex here/，并可使用 \number 引用捕获组，例如 \1。

触摸支持

为触摸屏设备提供基本支持，虽然不完美，但总比没有好。

小部件默认值

允许你在添加新节点时为小部件指定默认值，这些值可以通过设置菜单进行配置。

工作流

在菜单中添加保存和加载工作流的选项：

工作流动画

添加了将图表导入/导出为SVG和PNG格式的菜单选项，以展示节点视图。

（测试中）重路由原语

提供一个允许重路由原语的节点。
该节点还可以折叠成一个单点，方便拖动。

警告：请勿将普通重路由或原语与这些节点一起使用，因为尚未经过充分测试，此节点已替代了它们的功能。

WD14 标签器

已迁移至：https://github.com/pythongosssss/ComfyUI-WD14-Tagger

锁定节点与组

现已成为ComfyUI的标准功能。
为节点和组添加锁定选项，防止在解锁前被移动

ComfyUI-Custom-Scripts 快速上手指南

ComfyUI-Custom-Scripts 是一个功能丰富的 ComfyUI 扩展包，提供了自动补全、工作流管理、节点增强、图像预览等多种实用脚本和自定义节点，旨在提升绘图工作流的效率与体验。

环境准备

• 系统要求：Windows, Linux, macOS
• 前置依赖：
  • 已安装并配置好 ComfyUI。
  • 已安装 git 命令行工具。
  • Python 环境需满足 ComfyUI 的运行要求。

安装步骤

本扩展通过克隆仓库的方式安装到 ComfyUI 的 custom_nodes 目录。

1. 进入目录 打开终端（Terminal 或 CMD），导航至你的 ComfyUI 安装目录下的 custom_nodes 文件夹：

   cd /path/to/ComfyUI/custom_nodes
   

   (请将 /path/to/ComfyUI 替换为你实际的安装路径)

2. 克隆仓库 执行以下命令下载插件：

   git clone https://github.com/pythongosssss/ComfyUI-Custom-Scripts.git
   

   提示：如果下载速度较慢，可使用国内镜像源加速：

   git clone https://gitee.com/mirrors/ComfyUI-Custom-Scripts.git
   

   注：若使用镜像源，后续更新时需修改 remote 地址或手动同步。

3. 重启 ComfyUI 安装完成后，完全关闭并重新启动 ComfyUI。插件会自动加载所有自定义脚本和节点。

4. 卸载方法（如需）

   • 删除 custom_nodes/ComfyUI-Custom-Scripts 文件夹。
   • 确保 web/extensions/pysssss/CustomScripts 目录也被移除。

基本使用

安装重启后，无需额外配置即可在界面中使用大部分功能。以下是几个核心功能的快速体验：

1. 提示词自动补全 (Autocomplete)

在任意文本输入框（如 Positive Prompt）中输入内容时，会自动弹出嵌入模型（Embeddings）或自定义词汇的建议列表。

• 配置自定义词表：点击菜单 Settings (设置) -> 搜索 Custom Words，可加载 Danbooru 标签或导入自己的词表。
• 查看详情：在补全列表中点击信息图标可查看 Embedding 详情。

2. 一键整理画布 (Auto Arrange Graph)

当节点连线杂乱无章时：

• 右键点击画布空白处。
• 选择 Auto Arrange Graph。
• 系统将按执行顺序自动重新排列所有节点（注意：复杂工作流可能会变得很宽）。

3. 带预览图的模型加载器 (Better Loader Lists)

使用插件提供的自定义 Load Checkpoint 或 Load LoRA 节点：

• 显示预览图：将模型的预览图（.png 或 .jpg）放在模型文件同级目录，文件名保持一致（例如 model.safetensors 对应 model.png）。鼠标悬停在下拉列表的模型名上即可看到预览。
• 保存预览图：在生成图片的节点上右键点击图片，选择 Save as Preview，即可快速将当前生成图设为该模型的预览图。

4. 图像历史记录面板 (Image Feed)

• 界面侧边或底部会出现一个面板，实时显示当前会话生成的所有图片。
• 可在 Settings 中调整面板位置、图片添加方向及尺寸滑块。

5. 其他常用功能速览

• 始终吸附网格：在设置中开启 Always Snap to Grid，移动节点时自动对齐网格。
• 数学表达式节点：使用 Math Expression 节点，可基于图表中的数值进行加减乘除、取整等运算。
• 声音/系统通知：任务完成时播放声音或发送浏览器系统通知（可在设置中配置队列结束通知还是单条通知）。
• 工作流增强：支持将工作流导出为带有节点预览图的 PNG/SVG (Workflow Images)，以及快速保存/加载预设工作流。

注意：部分标记为 [Testing] 或 [WIP] 的功能（如 Repeater, Reroute Primitive）处于测试阶段，使用时请注意兼容性，避免与原生命名相同的节点混用。