Comfyui-xbhh-main
A ComfyUI extension with 12 custom nodes.
Nodes (12)
XBHH ComfyUI 套件 🎨
XBHH ComfyUI Kit 是一套功能丰富、设计精美的 ComfyUI 自定义节点和扩展插件集合。它不仅提供了高效的 LoRA 管理工具,还集成了可交互的 Live2D 桌面看板娘。
🆕 v1.2.0 更新亮点 (What's New)
本次重大更新极大地优化了 LoRA 管理系统,为您带来更加流畅、专业的交互体验:
- 🗂️ 全新独立管理器界面:支持一键展开/折叠左侧面板,自适应铺满全屏,视野更加开阔。
- 🌲 树状目录折叠:左侧文件夹列表新增层级折叠功能(▶/▼),再多模型也能清爽收纳。
- ↔️ 列宽自由调节:列表视图支持鼠标拖拽调整每一列的宽度,长文本轻松阅读。
- 🏷️ 智能提示词列:新增专属提示词列,自动判断并标识来源(
[自定义]、[Auto]、[Civitai]),支持将自定义触发词主动清空。 - 🧲 弹窗智能定位:完美修复加载器弹窗超出屏幕边界的问题,自动根据光标位置智能居中显示。
- 📤 预设无损合并:优化了 Plus 版节点的预设导入/导出逻辑,仅导出已启用的模型,导入时采用追加/合并模式而非暴力覆盖。
- 💾 触发词极速存取 (SQLite):引入 SQLite 数据库对 LoRA 触发词进行本地持久化保存,彻底解决加载卡顿,并实现高性能的自动绑定。
- 📝 全新节点 (Prompt Formatter):新增了
prompt_formatter.py节点,专门用于动态组合和格式化带触发词的提示词文本。
✨ 核心功能
🎭 Live2D 桌面看板娘 (Live2D Pet)
直接在 ComfyUI 工作流界面中召唤你的纸面老婆/老公!
- 多引擎支持: 兼容 Live2D V2 (SDK 2.1) 和 V5 (Cubism 4/5) 模型。
- 动态交互: 支持鼠标追踪、点击对话、随机动作及表情切换。
- 换装系统: 支持 V2 模型的一键快速换装(贴图切换)。
- 右键菜单: 便捷切换模型、调整缩放比例、设置灵敏度或暂时隐藏。
- 自动扫描: 自动识别
web/live2d目录下的所有模型文件。
[!TIP] 关于如何添加自己的 Live2D 模型,请参考:Live2D 模型管理指南

🎨 LoRA 高级管理
| 节点 | 功能说明 | | ---------------------------------- | ------------------------------------------------------------------- | | XBHH Multi Lora Loader 🎨 | 支持点击动态增加 LoRA 槽位,支持树形文件夹选择。 | | XBHH Multi Lora Loader Plus 🚀 | 在基础版上增加了 预设导入/导出 功能,支持保存常用的 LoRA 组合。 | | LoRA 预览增强 | 当鼠标悬停在列表或已选 LoRA 上时,实时显示预览图。 |

⚡ 效率工具与文本处理
- xbhh 动态文本 ⚡: 支持使用
%date%,%counter%,%random%等变量进行动态文本替换。 - xbhh XLSX 查看器: 无需打开 Excel,直接在 ComfyUI 内预览
.xlsx文件内容。 - xbhh 空Latent 📐: 提供 15+ 种常用比例预设,自动对齐 8 倍数。
- xbhh 注释节点: 带有层级感和搜索高亮功能的笔记节点,让工作流更清晰。
- xbhh txt 随机抽取: 从特定的文本库中随机挑选提示词关键词。
📦 安装与配置
1. 使用 ComfyUI Manager (推荐)
- 搜索
xbhh-lora并点击安装。
2. 手动安装
cd ComfyUI/custom_nodes
git clone https://github.com/xbhh123456/Comfyui-xbhh-main.git
cd Comfyui-xbhh-main
pip install -r requirements.txt
3. 配置 Live2D 模型
将你的 Live2D 模型文件夹放入 web/live2d/ 目录下即可自动识别。详细路径结构请查看 LIVE2D_GUIDE.md。
📅 路线图
- [x] Live2D V2/V5 引擎集成
- [x] 多 LoRA 预览与管理
- [ ] 更多 Live2D 交互动作(如语音同步)
- [ ] 增加更多实用的图像处理节点
📄 许可证
本项目采用 MIT License。
🙏 致谢
- Live2D 核心库及相关开源实现。
- rgthree-comfy 的 UI 设计理念。
- ComfyUI 官方团队。
如果你喜欢这个项目,欢迎点个 Star 🌟!