# ComfyUI-Gelbooru 插件完全新手教程 ## 1. 插件简介 **GitHub 原地址：** https://github.com/1mckw/Comfyui-Gelbooru 这个插件就像一个"图片自动抓取机"，专门用来从 Gelbooru 和 Rule34 这两个图片网站上随机抓取图片。想象一下，你在网上看图片时，总是要一页一页地翻，很麻烦对吧？这个插件就像请了一个小助手，你只要告诉它"我想要猫的图片"或者"我想要可爱的动物图片"，它就会自动帮你找到并下载这些图片，省去了你手动搜索的时间。 这个插件最大的好处就是： - 可以根据你的喜好自动找图片（比如只要猫的图片，不要狗的图片） - 可以一次性获取多张图片 - 可以过滤掉你不想要的内容 - 支持设置图片的安全等级 ## 2. 如何安装 安装这个插件就像给手机装个新应用一样简单： 1. **找到 ComfyUI 的插件文件夹** - 在你的 ComfyUI 安装目录里找到 `custom_nodes` 文件夹 - 这个文件夹就像一个"插件收纳盒" 2. **下载插件** - 打开命令行工具（Windows 用户打开 CMD 或 PowerShell） - 输入以下命令： ```bash cd custom_nodes git clone https://github.com/1mckw/Comfyui-Gelbooru.git ``` 3. **重启 ComfyUI** - 关闭 ComfyUI 然后重新打开 - 就像重启手机让新应用生效一样 ## 3. 节点详细解析 ### 3.1 Gelbooru (Random) 节点 - 随机图片抓取器 这个节点就像一个"智能图片筛选器"，你告诉它你想要什么样的图片，它就会从 Gelbooru 网站上随机帮你找到符合条件的图片。 #### 3.2 参数详解 | 参数名 (界面显示) | 参数名 (代码里) | 参数值类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | 网站选择 | site | 下拉菜单 | Gelbooru | 就像选择在哪个商店买东西，你可以选择从 Gelbooru 或 Rule34 网站抓取图片 | 指定图片数据源网站 | 选择 "Gelbooru" 获取一般图片，选择 "Rule34" 获取成人向图片 | | 或标签 | OR_tags | 文本框 | cat,dog | 这里填入你想要的图片标签，用逗号分开，只要图片有其中任意一个标签就会被选中 | 逻辑或条件的标签过滤 | 填入 "cat,dog," 表示要么是猫的图片，要么是狗的图片 | | 必须标签 | AND_tags | 文本框 | cute | 这里填入图片必须包含的标签，所有图片都必须有这个标签 | 逻辑与条件的标签过滤 | 填入 "cute," 表示所有图片都必须有可爱这个标签 | | 排除标签 | exclude_tag | 文本框 | animated | 这里填入你不想要的标签，有这个标签的图片会被过滤掉 | 排除特定标签的图片 | 填入 "animated," 表示不要动画图片 | | 用户名 | user_id | 文本框 | 空 | 如果你有 Gelbooru 账户，可以填入用户名，没有就留空 | API 访问的用户身份验证 | 一般新手留空即可 | | 密钥 | api_key | 文本框 | 空 | 如果你有 Gelbooru 的 API 密钥，填入这里，没有就留空 | API 访问的密钥验证 | 一般新手留空即可 | | 安全级别 | Safe | 勾选框 | True | 勾选后只获取安全的图片，就像给图片内容加了个"家长控制" | 过滤安全等级的图片 | 建议勾选，避免获取不合适的图片 | | 可疑级别 | Questionable | 勾选框 | False | 勾选后会包含一些可疑内容的图片，不勾选更安全 | 过滤问题等级的图片 | 新手建议不勾选 | | 明确级别 | Explicit | 勾选框 | False | 勾选后会包含明确的成人内容，不勾选更安全 | 过滤明确成人内容的图片 | 新手建议不勾选 | | 评分 | score | 数字框 | 0 | 设置图片的最低评分，就像设置"至少要多少星级"的图片 | 图片质量评分过滤 | 填入 10 表示只要评分 10 分以上的图片 | | 随机种子 | seed | 数字框 | 42 | 这个数字控制随机性，相同的数字会得到相同的结果 | 伪随机数生成种子 | 想要相同结果就用相同数字，想要不同结果就换个数字 | | 图片数量 | count | 数字框 | 1 | 你想要获取多少张图片 | 批量获取图片的数量 | 填入 3 表示一次获取 3 张图片 | ### 3.3 Rule34 (Random) 节点 - Rule34 随机图片抓取器 这个节点和上面的 Gelbooru 节点基本一样，只是专门从 Rule34 网站抓取图片。Rule34 网站主要是成人向内容，所以使用时要特别注意。 #### 3.4 参数详解 | 参数名 (界面显示) | 参数名 (代码里) | 参数值类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | 或标签 | OR_tags | 文本框 | anime,manga | 填入你想要的图片标签，用逗号分开，有其中任意一个标签的图片都会被选中 | 逻辑或条件的标签过滤 | 填入 "anime,manga," 表示要动画或漫画相关的图片 | | 必须标签 | AND_tags | 文本框 | 1girl | 所有图片都必须包含这个标签 | 逻辑与条件的标签过滤 | 填入 "1girl," 表示所有图片都必须有单个女孩 | | 排除标签 | exclude_tag | 文本框 | nude | 不想要的标签，有这个标签的图片会被过滤掉 | 排除特定标签的图片 | 填入 "nude," 表示不要裸体图片 | | 用户名 | user_id | 文本框 | 空 | Rule34 账户用户名，可选 | API 访问的用户身份验证 | 一般留空即可 | | 密钥 | api_key | 文本框 | 空 | Rule34 的 API 密钥，可选 | API 访问的密钥验证 | 一般留空即可 | | 安全级别 | Safe | 勾选框 | True | 勾选后只获取安全的图片 | 过滤安全等级的图片 | 建议勾选 | | 可疑级别 | Questionable | 勾选框 | False | 勾选后会包含可疑内容的图片 | 过滤问题等级的图片 | 新手建议不勾选 | | 明确级别 | Explicit | 勾选框 | False | 勾选后会包含明确的成人内容 | 过滤明确成人内容的图片 | 新手建议不勾选 | | 评分 | score | 数字框 | 0 | 设置图片的最低评分 | 图片质量评分过滤 | 填入 5 表示只要评分 5 分以上的图片 | | 随机种子 | seed | 数字框 | 42 | 控制随机性的数字 | 伪随机数生成种子 | 想要相同结果就用相同数字 | | 图片数量 | count | 数字框 | 1 | 想要获取多少张图片 | 批量获取图片的数量 | 填入 2 表示一次获取 2 张图片 | ### 3.5 Gelbooru (Fixed Tag) 节点 - 固定标签图片抓取器 这个节点不是随机抓取，而是根据你指定的标签精确抓取图片，就像你在图书馆里按分类找书一样。 #### 3.6 参数详解 | 参数名 (界面显示) | 参数名 (代码里) | 参数值类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | 标签 | tags | 文本框 | landscape | 指定你想要的图片标签，这次不是随机而是精确搜索 | 精确标签搜索 | 填入 "landscape," 获取所有风景图片 | | 页数 | page | 数字框 | 1 | 搜索结果的页数，就像翻书一样 | 分页查询的页码 | 填入 1 表示第一页，填入 2 表示第二页 | | 每页数量 | limit | 数字框 | 10 | 每页显示多少张图片 | 单页返回的图片数量限制 | 填入 10 表示每页显示 10 张图片 | | 用户名 | user_id | 文本框 | 空 | Gelbooru 账户用户名，可选 | API 访问的用户身份验证 | 一般留空即可 | | 密钥 | api_key | 文本框 | 空 | Gelbooru 的 API 密钥，可选 | API 访问的密钥验证 | 一般留空即可 | | 安全级别 | Safe | 勾选框 | True | 勾选后只获取安全的图片 | 过滤安全等级的图片 | 建议勾选 | | 可疑级别 | Questionable | 勾选框 | False | 勾选后会包含可疑内容的图片 | 过滤问题等级的图片 | 新手建议不勾选 | | 明确级别 | Explicit | 勾选框 | False | 勾选后会包含明确的成人内容 | 过滤明确成人内容的图片 | 新手建议不勾选 | | 评分 | score | 数字框 | 0 | 设置图片的最低评分 | 图片质量评分过滤 | 填入 20 表示只要评分 20 分以上的图片 | ## 4. 使用技巧和建议 ### 4.1 标签使用技巧 - **记住加逗号**：每个标签后面都要加逗号，比如 "cat,dog,cute," 而不是 "cat dog cute" - **英文标签**：标签必须用英文，比如用 "cat" 而不是"猫" - **组合使用**：可以把 OR_tags 和 AND_tags 组合使用，比如 OR_tags 填 "cat,dog," AND_tags 填 "cute," 这样就会获取可爱的猫或可爱的狗 ### 4.2 安全使用建议 - **新手建议**：Safe 设置为 True，Questionable 和 Explicit 设置为 False - **内容过滤**：善用 exclude_tag 来排除不想要的内容 - **评分过滤**：设置合适的 score 值来获取高质量图片 ### 4.3 效率提升技巧 - **批量获取**：如果需要多张图片，直接设置 count 参数而不是多次运行 - **种子控制**：使用相同的 seed 值可以获得相同的随机结果，便于调试 - **分页浏览**：使用 Fixed Tag 节点时，可以通过改变 page 参数来浏览不同页面的结果 ## 5. 常见问题解答 ### Q1: 为什么我获取不到图片？ **A1:** 可能的原因： - 网络连接问题，检查你的网络 - 标签拼写错误，确保用英文标签 - 过滤条件太严格，尝试放宽一些条件 ### Q2: 为什么所有图片大小都一样？ **A2:** 这是插件的设计特点，当你获取多张图片时，所有图片都会被调整到和第一张图片相同的大小。 ### Q3: 我需要注册账户吗？ **A3:** 不需要，user_id 和 api_key 是可选的。不填写也能正常使用。 ### Q4: 标签怎么写？ **A4:** 标签必须用英文，每个标签后面都要加逗号，比如："cat,dog,cute," ### Q5: 为什么有时候获取的图片内容不合适？ **A5:** 建议： - 勾选 Safe 选项 - 不勾选 Questionable 和 Explicit 选项 - 使用 exclude_tag 排除不想要的内容 ## 6. 输出内容说明 这个插件会返回以下内容： - **图片本身**：可以直接用于后续的图片处理 - **图片标签**：显示这张图片有哪些标签 - **图片链接**：原图片在网站上的地址 ## 7. 注意事项 1. **网络要求**：需要能够访问 Gelbooru 或 Rule34 网站 2. **内容风险**：这些网站可能包含成人内容，请根据需要设置过滤器 3. **使用频率**：不要过于频繁地请求，以免被网站限制 4. **版权问题**：获取的图片可能有版权，商业使用需谨慎 ## 8. 总结 这个插件就像一个智能的图片收集助手，可以帮你自动从网上找到符合要求的图片。对于需要大量图片素材的创作者来说，这是一个非常实用的工具。记住最重要的几点：正确使用标签、设置合适的安全级别、善用过滤功能，你就能很好地使用这个插件了。
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
