%20(1).png)
ComfyUI Ranbooru 插件保姆级教程
1. 插件简介
ComfyUI Ranbooru 是一个专门为 ComfyUI 设计的插件，它的主要作用就像一个"随机图片标签抽取机"。这个插件的目的是添加一个节点，可以从各种图片网站（叫做 booru）随机获取一组标签。
插件原地址： https://github.com/Inzaniak/comfyui-ranbooru
它能给我们带来什么效果？
- 帮你测试不同的 AI 模型，就像给模型出各种各样的"考题"
- 自动生成随机的关键词组合，让你的 AI 画图更有创意
- 从图片网站抓取真实的标签，让你知道别人都用什么词来描述图片
- 节省你手工输入关键词的时间，特别适合批量测试
2. 如何安装
安装就像往文件夹里放东西一样简单：
- 打开你的 ComfyUI 安装目录
- 找到
custom_nodes文件夹（就是放插件的地方） - 在这个文件夹里打开命令行窗口
- 输入命令：
git clone https://github.com/Inzaniak/comfyui-ranbooru.git - 重启 ComfyUI，插件就会自动加载
3. 节点逐一解析
3.1 Ranbooru 节点 - 随机标签抽取器
这个节点就像一个"标签抽奖机"，它会从图片网站随机抽取一些标签给你用。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Booru | booru | 下拉选择 | Gelbooru | 选择从哪个图片网站抓标签，就像选择去哪家店买东西 | 指定要查询的 booru 网站源 | 选择 "Gelbooru" 或 "Danbooru" 等 |
| Tags | tags | 文本输入 | 留空或填基础标签 | 搜索的关键词，就像在搜索框里输入你想找的东西 | 用于过滤搜索结果的标签 | 输入 "anime girl" 或 "landscape" |
| Remove Tags | remove_tags | 文本输入 | 留空 | 不想要的标签，就像告诉店员"我不要这个" | 从结果中排除的标签列表 | 输入 "nsfw" 或 "gore" |
| Max Tags | max_tags | 数字输入 | 10-20 | 最多抓取多少个标签，就像限制购物车里的商品数量 | 返回标签的最大数量 | 设置为 15 表示最多返回15个标签 |
| Rating | rating | 下拉选择 | Safe | 图片的内容等级，就像电影分级一样 | 图片的成熟度评级 | 选择 "safe" 表示只要健康内容 |
| Change Color | change_color | 开关 | False | 要彩色图片还是黑白图片，就像选择彩色电视还是黑白电视 | 控制图片的颜色模式 | 开启表示要彩色图片 |
| Use Last Prompt | use_last_prompt | 开关 | False | 是否使用上次的关键词，就像记住上次的订单 | 是否复用之前的提示词 | 开启后会记住上次的设置 |
| Return Picture | return_picture | 开关 | False | 是否同时返回图片，就像买东西时要不要包装盒 | 是否在返回标签的同时返回图片 | 开启后会同时输出图片 |
3.2 RanbooruUrl 节点 - 指定图片标签提取器
这个节点就像一个"图片标签识别器"，你给它一张图片的网址，它就告诉你这张图片有什么标签。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Booru | booru | 下拉选择 | Gelbooru | 选择图片来源网站，就像选择去哪家店查商品信息 | 指定图片所在的 booru 网站 | 选择图片对应的网站 |
| URL | url | 文本输入 | 完整网址 | 图片的网址或ID号，就像商品的条形码 | 图片的完整URL或图片ID | 粘贴图片链接或输入图片ID |
| Return Picture | return_picture | 开关 | False | 是否同时返回图片，就像查商品信息时要不要看商品图片 | 是否同时返回图片数据 | 开启后会同时输出图片 |
3.3 RanbooruFolder 节点 - 文件夹随机图片选择器
这个节点就像一个"图片抽奖机"，从你电脑里的文件夹随机选一张图片。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Path | path | 文本输入 | 完整路径 | 图片文件夹的位置，就像告诉别人你家的地址 | 图片文件夹的完整路径 | 输入 "C:/Pictures/anime" |
| Include Subfolders | include_subfolders | 开关 | True | 是否包含子文件夹，就像搜索时要不要翻抽屉里的小盒子 | 是否递归搜索子目录 | 开启后会搜索所有子文件夹 |
3.4 PromptMix 节点 - 关键词混合器
这个节点就像一个"句子搅拌机"，把你的关键词重新排列组合。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Prompt | prompt | 文本输入 | 关键词文本 | 要混合的关键词，就像要搅拌的材料 | 输入的提示词字符串 | 输入 "beautiful girl, long hair, blue eyes" |
| Delimiter | delimiter | 文本输入 | ", " | 分隔符，就像切菜时的刀，决定在哪里切开 | 用于分割词语的分隔符 | 通常使用 ", " 或 " " |
| Mix Type | mix_type | 下拉选择 | Shuffle | 混合方式：随机打乱、倒序、或反向 | 词语重排的方式 | Shuffle=随机排序，Reverse=倒序 |
3.5 PromptLimit 节点 - 关键词数量限制器
这个节点就像一个"关键词剪刀"，帮你控制关键词的数量。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Prompt | prompt | 文本输入 | 关键词文本 | 要限制的关键词，就像要剪短的头发 | 输入的提示词字符串 | 输入一长串关键词 |
| Separator | separator | 文本输入 | ", " | 分隔符，就像理发师的梳子，决定在哪里分开 | 用于分割词语的分隔符 | 通常使用 ", " |
| Limit | limit | 数字输入 | 10 | 最多保留多少个关键词，就像剪头发时说"留10厘米" | 保留的最大词语数量 | 设置为10表示最多保留10个词 |
3.6 PromptRandomWeight 节点 - 随机权重分配器
这个节点就像一个"关键词强调器"，随机给一些关键词加重音。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Prompt | prompt | 文本输入 | 关键词文本 | 要加权重的关键词，就像要强调的重点 | 输入的提示词字符串 | 输入 "girl, dress, flowers" |
| Separator | separator | 文本输入 | ", " | 分隔符，就像断句的标点符号 | 用于分割词语的分隔符 | 使用 ", " 分隔 |
| Min Weight Value | min_weight_value | 小数输入 | 1.0 | 最小权重值，就像音量调节的最小声音 | 权重的最小值 | 设置为1.0表示正常强度 |
| Max Weight Value | max_weight_value | 小数输入 | 1.5 | 最大权重值，就像音量调节的最大声音 | 权重的最大值 | 设置为1.5表示最大强调50% |
| Max Weight Tags | max_weight_tags | 数字输入 | 3 | 最多给几个关键词加权重，就像最多强调几个重点 | 需要加权的最大词语数量 | 设置为3表示最多强调3个词 |
| Order | order | 下拉选择 | random | 选择方式：随机选择或按顺序选择 | 选择词语的顺序方式 | random=随机选择，ordered=按顺序选择 |
3.7 PromptBackground 节点 - 背景描述添加器
这个节点就像一个"背景装饰师"，给你的关键词添加背景描述。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Prompt | prompt | 文本输入 | 主要关键词 | 原始关键词，就像主角 | 原始的提示词 | 输入 "beautiful girl" |
| Background | background | 文本输入 | 背景描述 | 背景相关的描述，就像舞台背景 | 要添加的背景上下文 | 输入 "in a garden, sunset lighting" |
3.8 PromptRemove 节点 - 关键词删除器
这个节点就像一个"关键词橡皮擦"，帮你删除不想要的关键词。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Prompt | prompt | 文本输入 | 原始关键词 | 原始的关键词列表，就像要修改的作文 | 原始的提示词字符串 | 输入包含不想要词语的文本 |
| Words to Remove | words_to_remove | 文本输入 | 要删除的词 | 要删除的关键词，就像要擦掉的错字 | 需要从提示词中移除的词语列表 | 输入 "ugly, bad, nsfw" |
3.9 LockSeed 节点 - 随机种子锁定器
这个节点就像一个"运气锁定器"，让你的随机结果保持一致。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Use Last | use_last | 开关 | True | 是否使用上次的随机种子，就像重复上次的幸运数字 | 锁定到最后使用的随机种子 | 开启后每次都会产生相同的随机结果 |
3.10 TimestampFileName 节点 - 时间戳文件名生成器
这个节点就像一个"文件名打印机"，根据当前时间自动生成文件名。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Filename | filename | 文本输入 | 文件名前缀 | 文件名的开头部分，就像给文件起个小名 | 文件名的前缀部分 | 输入 "myimage_" 会生成 "myimage_20240101_123456" |
4. 使用技巧和建议
新手入门建议：
- 先从 Ranbooru 节点开始，设置 rating 为 "safe"，max_tags 设置为 10-15
- 使用 PromptLimit 节点控制关键词数量，避免太多关键词影响生成质量
- 用 PromptRemove 节点过滤掉不想要的内容，比如 "nsfw, gore, violence"
进阶使用技巧：
- 结合 PromptMix 和 PromptRandomWeight 创造更有趣的关键词组合
- 使用 LockSeed 节点来重现喜欢的结果
- 用 TimestampFileName 节点自动管理生成的文件名
常用工作流程：
- Ranbooru 节点获取随机标签
- PromptRemove 节点删除不想要的内容
- PromptLimit 节点控制关键词数量
- PromptRandomWeight 节点增强重点关键词
- 连接到你的文字转图片节点
5. 常见问题解答
Q: 为什么 Ranbooru 节点不返回结果？
A: 检查网络连接，确保可以访问相关的图片网站。某些地区可能需要特殊的网络设置。
Q: 生成的标签都是英文，怎么办？
A: 这是正常的，因为大多数图片网站都使用英文标签。你可以使用翻译工具或者自己添加中文关键词。
Q: 如何避免生成不合适的内容？
A: 在 rating 参数中选择 "safe"，并使用 PromptRemove 节点过滤敏感词汇。
Q: 关键词太多了怎么办？
A: 使用 PromptLimit 节点限制关键词数量，一般建议控制在 15-20 个以内。
Q: 如何让生成的图片更稳定？
A: 使用 LockSeed 节点锁定随机种子，这样每次生成的结果会更一致。
6. 额外功能和扩展应用
批量测试模型：
这个插件特别适合测试不同的 AI 模型，你可以设置一个工作流程，让它自动生成各种不同的关键词组合，然后批量测试你的模型在不同关键词下的表现。
创意灵感获取：
当你缺乏绘画灵感时，可以使用 Ranbooru 节点随机获取一些标签，说不定会给你意想不到的创意启发。
关键词库建设：
通过长期使用这个插件，你可以积累一个庞大的关键词库，了解哪些关键词组合效果最好。
记住，这个插件的强大之处在于它的随机性和灵活性，多尝试不同的参数组合，你会发现更多有趣的用法！