wjluoxiao/XB_ToolBox

XB_ToolBox: An easy-to-use ComfyUI custom node suite that streamlines workflow generation. Featuring exclusive data-flow logic and pioneering experimental kernel optimizations dedicated to the native AMD GPU ecosystem.

📦 什么是 ComfyUI XB-BOX (XB_ToolBox)？

这是一个用于 ComfyUI 的插件集合，ComfyUI 是一个用于本地运行扩散模型的可视化节点界面。XB_ToolBox 加入了一组现成的节点和一个小型仪表板，让新手能更轻松地控制图像与视频生成流程，并将极大型的 3-D 扩散模型塞入消费级 GPU 中运行。

🔑 核心功能 (如 README 所述)

领域	工具箱提供的功能
统一参数中心	Image Parameters Master 与 Video Parameters Master 让您能在同一处设定宽度、高度、批次大小、FPS 等，并自动强制执行安全数值 (例如帧数的 `1+8N` 规则)。
可视化调试	Spatiotemporal Chunk Visualization 显示图像如何分块以及视频帧如何切片，提供 2-D 空间视图与 3-D 时间圆柱视图。
VRAM 节省技巧	Sampler Chunk Master 在潜在空间执行时空分块；Model Block Swap 可将早期的 Transformer 区块卸载至 RAM；VRAM Cleaner 强制执行 PyTorch 垃圾回收与缓存清除。
工作流程人体工学	XB Dashboard Zen 将分散的节点复制到单一控制面板；Dynamic Bus 是一个通用的 N-in/N-out 总线节点，可减少“面条线”混乱。
音乐生成支持	一套封装官方 YuE2 文字转音乐工作流程的节点 (风格提示、歌词、乐谱工作台、转录输入、封面准备)。它们仅将字符串/参数传递给官方 YuE2 节点，保持所有内容都在设备端运行。
辅助工具	Storyboard Image Slicer (基于网格的图像分割)、VRAM Calculator & Data Radar (估算不同量化下的内存使用量) 以及一组 VRAM Optimizer 节点。

🛠️ 如何安装

ComfyUI Manager – 搜索 XB_ToolBox 并点击 Install (推荐)。
手动安装 – 将仓库克隆到 ComfyUI 安装目录下的 custom_nodes 文件夹：
```
git clone https://github.com/wjluoxiao/XB_ToolBox.git
```

此扩展功能不需要任何额外的 Python 包；它可与标准的 ComfyUI 构建版本搭配使用。

🎯 谁会受益？

AI 初学者：希望在单一位置调整图像/视频参数，而无需翻找许多分散节点的人。
使用大型 3-D 扩散模型 (14-22 B 参数) 的艺术家：需要 VRAM 节省技巧以避免在消费级 GPU 上出现 OOM 错误的人。
音乐生成爱好者：已经在使用官方 YuE2 节点，并希望在风格、歌词与乐谱处理上有更方便 UI 的人。

📜 授权条款

Apache-2.0 – 可自由使用、修改与重新分发。