ComfyUI Danbooru Gallery：ComfyUI无缝接入 Danbooru 的图像搜索与标签管理插件

在使用 Stable Diffusion 和 ComfyUI 进行图像生成时，一个常见需求是：

如何快速找到高质量的参考图？如何准确获取精准描述角色特征的提示词（prompt）？

为此，我们介绍一款高效实用的 ComfyUI 插件 —— ComfyUI Danbooru Gallery。

• GitHub：https://github.com/Aaalice233/ComfyUI-Danbooru-Gallery

它深度集成 Danbooru 图像数据库 API，让你在工作流中直接搜索、浏览、筛选并导入来自 Danbooru 的高质量图像与标签数据，无需跳出界面即可完成素材收集与 prompt 构建。

无论你是做角色复现、风格参考，还是构建训练集，这款工具都能显著提升效率。

核心功能一览

快速安装指南

方法一：通过 ComfyUI Manager 安装（推荐）

1. 打开 ComfyUI → 进入 Manager 界面
2. 点击 “Install Custom Nodes”
3. 搜索 Danbooru Gallery 或 comfyui-danbooru-gallery
4. 点击 Install
5. 重启 ComfyUI

✅ 优点：全自动依赖安装，零配置上手

方法二：命令行自动安装

# 克隆到 custom_nodes 目录
git clone https://github.com/comfyui-extensions/comfyui-danbooru-gallery.git \
  ./ComfyUI/custom_nodes/comfyui-danbooru-gallery

# 进入目录并运行安装脚本
cd comfyui-danbooru-gallery
python install.py

# 重启 ComfyUI

该脚本会自动安装所需依赖并验证环境。

方法三：手动安装（适用于定制化部署）

# 安装依赖
pip install -r requirements.txt

将项目放入：

ComfyUI/custom_nodes/comfyui-danbooru-gallery/

然后重启 ComfyUI。

使用方法：三步完成图像引入

1. 添加节点
   在 ComfyUI 工作流中添加 Danbooru Images Gallery 节点。
2. 打开画廊
   双击节点启动内置 Web 界面，进入搜索面板。
3. 搜索与导入
   • 输入标签（如：solo girl red_hair school_uniform）
   • 设置内容分级、每页数量、是否排除模糊图像等
   • 浏览瀑布流结果，点击目标图像即可将其 URL 和标签自动写回节点输出

后续可通过其他节点下载图像或提取 prompt 内容，无缝融入生成流程。

实用功能详解

✅ 中英对照系统：打破语言壁垒

对于中文用户而言，Danbooru 的英文标签体系一直是个门槛。本插件提供完整的中文化支持：

• 中文搜索：输入“蓝眼少女”，自动匹配 blue_eyes, 1girl
• 智能补全：输入 blu，提示“blue_eyes (蓝眼睛)”
• 悬浮翻译：鼠标悬停标签，显示中文释义
• 批量翻译缓存：高频标签本地缓存，响应更快

支持数据源：

• zh_cn/all_tags_cn.json：JSON 格式键值对
• zh_cn/danbooru.csv：标准标签翻译表
• zh_cn/wai_characters.csv：角色名中英映射

📌 提示：你也可以扩展自己的翻译文件，实现个性化术语匹配。

✅ 收藏与认证：跨设备同步你的灵感库

登录 Danbooru 账户后：

• 可标记喜欢的图像为“收藏”
• 收藏状态本地缓存 + 云端同步
• 下次打开仍可访问历史收藏

设置方式：

用户名: your_username
API Key: 在 Danbooru 设置页获取

插件会自动校验连接状态和权限有效性。

✅ 高级过滤与安全控制

✅ 与其他节点集成

Danbooru Images Gallery 输出字段包括：

• image_url: 高清图像链接
• tags: 完整标签列表（可选类别）
• rating: 内容分级
• score: Danbooru 评分
• creator: 作者信息

这些输出可轻松传递给以下节点：

• 图像下载器（Download Image）
• 文本处理器（Prompt Builder）
• 训练数据准备管道

非常适合用于：

• 构建 fine-tuning 数据集
• 复现特定角色外观
• 分析流行视觉趋势

项目结构说明

ComfyUI-Danbooru-Gallery/
├── __init__.py                 # 插件注册入口
├── danbooru_gallery.py         # 后端逻辑：API 请求、标签处理
├── install.py                  # 智能安装脚本
├── requirements.txt            # Python 依赖清单
├── pyproject.toml              # 项目元信息
├── js/
│   └── danbooru_gallery.js     # 前端交互界面
├── zh_cn/                      # 中文翻译资源
│   ├── all_tags_cn.json        # JSON 格式主词典
│   ├── danbooru.csv            # CSV 格式补充
│   └── wai_characters.csv      # 角色专有名词映射
├── cache/                      # 缓存目录（图像缩略图、翻译结果）
└── README.md                   # 使用文档

开发者友好：模块清晰，易于二次开发或新增数据源。

故障排查建议

📌 小技巧：开启 调试模式 可查看详细日志输出，便于定位问题。