ComfyUI-GTSuya-Nodes 插件保姆级教程

1. 插件简介

ComfyUI-GTSuya-Nodes 是一个专门为 ComfyUI 设计的扩展插件，主要功能是添加多种"万能词汇"（wildcards）支持。简单来说，这个插件就像是一个"抽奖机器"，能够帮你从预设的词汇库中随机选择词汇，让你的图片生成更加多样化和有趣。

GitHub 原地址： https://github.com/GTSuya-Studio/ComfyUI-Gtsuya-Nodes

这个插件能给我们带来什么？

想象一下，你想生成不同国家风景的图片，但又不想每次都手动改提示词。这个插件就像一个"词汇魔法盒"，你只需要写一次 __国家__，它就能自动帮你从国家列表中随机选一个，比如今天选"日本"，明天选"法国"，让每次生成的图片都有惊喜感。

除了基本的词汇替换，它还能：

• 从网络图片库（Danbooru）自动获取图片和标签
• 批量处理和替换文本内容
• 随机选择文件夹中的文件

2. 如何安装

方法一：使用 ComfyUI Manager（推荐新手）

1. 打开 ComfyUI
2. 找到 ComfyUI Manager 面板
3. 搜索 "GTSuya-Nodes"
4. 点击安装，等待完成
5. 重启 ComfyUI

方法二：手动安装

1. 找到你的 ComfyUI 安装目录
2. 进入 custom_nodes 文件夹
3. 在这里打开命令行（Windows：按住 Shift 右键选择"在此处打开命令提示符"）
4. 输入命令：git clone https://github.com/GTSuya-Studio/ComfyUI-Gtsuya-Nodes.git
5. 等待下载完成
6. 重启 ComfyUI

准备工作

在 ComfyUI 根目录创建一个名为 "wildcards" 的文件夹，把你的词汇文件放在里面。这就像给你的"词汇魔法盒"准备各种"抽奖券"。

3. 节点详细解析

3.1 Simple wildcards 节点 - 基础词汇抽奖机

这是最基础的节点，就像一个简单的抽奖机。你准备好词汇文件，它帮你随机选择。

使用方法：

右键 → Add Node → GtsuyaStudio → Wildcards → Simple wildcards

参数详解：

工作原理：

1. 你在 wildcards 文件夹放一个叫 国家.txt 的文件
2. 文件里每行写一个国家名：日本、韩国、中国、美国...
3. 在提示词里写 __国家__
4. 节点会自动随机选择一个国家替换

3.2 Simple wildcards (Dir.) 节点 - 自定义位置抽奖机

这个节点就像是一个"移动抽奖机"，你可以指定任意文件夹作为词汇库，不一定要放在 ComfyUI 目录里。

使用方法：

右键 → Add Node → GtsuyaStudio → Wildcards → Simple wildcards (Dir.)

参数详解：

使用技巧：

• 可以把不同类型的词汇放在不同文件夹里管理
• 适合有很多词汇文件需要分类管理的用户

3.3 Wildcards Nodes 节点 - 高级词汇管理器

这个节点就像一个"智能调度中心"，不依赖外部文件，直接在工作流中管理词汇。需要配合其他节点使用。

使用方法：

右键 → Add Node → GtsuyaStudio → Wildcards → Wildcards Nodes

参数详解：

特殊说明：
这个节点需要配合 Hakkun-ComfyUI-nodes 插件的 Random Line 节点使用，就像需要"配套零件"才能工作。

3.4 Danbooru (ID) 节点 - 指定图片信息获取器

这个节点就像一个"图片信息查询机"，你给它一个图片的身份证号码（ID），它就能帮你找到这张图片和相关的描述标签。

使用方法：

右键 → Add Node → GtsuyaStudio → Downloads → Danbooru (ID)

参数详解：

输出内容：

• 图片的网址链接
• 图片的所有标签（可以直接用作提示词）

3.5 Danbooru (Random) 节点 - 随机图片信息获取器

这个节点就像一个"随机图片探索器"，能够从 Danbooru 网站随机获取图片和标签，还可以按照特定主题搜索。

使用方法：

右键 → Add Node → GtsuyaStudio → Downloads → Danbooru (Random)

参数详解：

使用前准备：

1. 先在 Danbooru 网站注册账户
2. 申请 API 密钥
3. 获得使用随机数据的权限

3.6 Replace Strings 节点 - 文本替换工具

这个节点就像一个"文本修改器"，能够自动删除或替换文本中的特定词汇。

使用方法：

右键 → Add Node → GtsuyaStudio → Tools → Replace Strings

参数详解：

替换规则格式：

• 旧词|新词 - 把"旧词"替换成"新词"
• 删除词| - 删除"删除词"（竖线后面留空）
• 每行写一个替换规则

举例：

猫|狗
难看|美丽
垃圾|

这样设置后，"猫"会变成"狗"，"难看"会变成"美丽"，"垃圾"会被删除。

3.7 Random File From Path 节点 - 随机文件选择器

这个节点就像一个"文件抽奖机"，能够从指定文件夹中随机选择一个文件。

使用方法：

右键 → Add Node → GtsuyaStudio → Tools → Random File From Path

参数详解：

使用场景：

• 随机选择参考图片
• 随机选择背景音乐
• 随机选择模型文件

4. 使用技巧和建议

4.1 词汇文件制作技巧

• 每个词汇文件用记事本创建，后缀名是 .txt
• 每行写一个词汇，不要有空行
• 文件名要用英文，避免中文字符
• 可以分类创建：颜色.txt、动物.txt、服装.txt等

4.2 提示词编写技巧

• 双下划线要用英文输入法输入
• 词汇名要和文件名完全一致（不包括.txt）
• 可以在一个提示词中使用多个词汇：一个 __颜色__ 的 __动物__ 在 __地点__ 玩耍

4.3 与其他节点配合使用

• 配合 Load Image From URL 节点可以直接加载网络图片
• 配合 Random Line 节点可以实现更复杂的词汇管理
• 配合文本节点可以实现批量文本处理

5. 常见问题解答

Q1: 为什么我的词汇没有被替换？

答： 检查以下几点：

• 词汇文件是否放在正确的文件夹
• 文件名是否和双下划线中的名称一致
• 双下划线是否用英文输入法输入
• 词汇文件是否是 UTF-8 编码

Q2: Danbooru 节点无法使用怎么办？

答： 确保：

• 已经注册 Danbooru 账户
• 已经获取有效的 API 密钥
• API 密钥有访问随机数据的权限
• 网络连接正常

Q3: 替换规则不生效怎么办？

答： 检查：

• 替换规则格式是否正确（旧词|新词）
• 是否用英文的竖线符号 |
• 每行只写一个替换规则
• 文本编码是否为 UTF-8

Q4: 随机文件选择器找不到文件？

答： 确认：

• 文件夹路径是否正确
• 文件夹是否存在
• 文件夹内是否有文件
• 路径中是否有特殊字符

6. 进阶使用建议

6.1 创建词汇库体系

建议按照以下方式组织你的词汇库：

wildcards/
├── 角色/
│   ├── 发色.txt
│   ├── 眼色.txt
│   └── 服装.txt
├── 场景/
│   ├── 室内.txt
│   ├── 户外.txt
│   └── 天气.txt
└── 风格/
    ├── 艺术风格.txt
    └── 时代风格.txt

6.2 工作流搭建建议

1. 先用 Simple wildcards 节点测试基本功能
2. 熟悉后可以尝试 Wildcards Nodes 节点的高级功能
3. 配合 Danbooru 节点可以获取更多创意灵感
4. 用 Replace Strings 节点优化最终输出

6.3 效率提升技巧

• 准备常用的词汇文件模板
• 使用批量替换节点处理大量文本
• 结合随机文件选择器实现自动化工作流
• 定期更新和维护词汇库

这个插件就像给你的 ComfyUI 加装了一个"创意助手"，让图片生成变得更加有趣和多样化。通过合理使用这些节点，你可以创建出更加智能和自动化的图像生成工作流。