Power Artist Loader

一个为 ComfyUI 设计的自定义节点，可同时加载多个画师名称并智能组合到提示词中，支持独立权重控制和实时预览。

更新功能2025-10-09

1. 修复刷新后节点重置，现在会保留上一次的设置状态
2. 新增权重左右拖动改变数值的功能
3. 修复字数过多，导致预览显示超出框外的bug，现在可在预览框内滚动显示
4. 右键菜单去掉strength0.5等3个低频使用功能项
5. 修改权重范围为-1.00-3.00，可使用负权重

特性

核心功能

• 多画师管理 - 动态添加/删除画师槽位，支持无限扩展
• 独立权重控制 - 每个画师 -1.00-3.00 精确权重调节
• 悬停预览 - 鼠标悬停在下拉菜单即可预览画师风格图片和关键词
• 批量开关 - 一键启用/禁用所有画师
• 智能合并 - 自动格式化为 SD 权重语法：(artist:1.2)

界面特点

• 可视化开关和权重滑块
• 右键快捷菜单
• 支持画师名称区域内悬停预览

安装

方法 : Git Clone

cd ComfyUI/custom_nodes
git clone https://github.com/hanL34/ComfyUI-Power-Artist-Loader.git
cd ComfyUI-Power-Artist-Loader

## 使用说明

### 添加画师
1. 点击节点底部的 **➕ Add Artist** 按钮
2. 点击画师名称区域打开下拉菜单
3. 鼠标悬停可预览画师风格（需配置预览图）
4. 点击选择画师

### 调整权重
**方法 1**: 点击左右箭头按钮，每次 ±0.05  
**方法 2**: 点击数值区域，直接输入精确值  
**方法 3**: 在数值区域按住左键拖动调节

### 快捷操作
- **Toggle All** - 批量启用/禁用所有画师
- **右键菜单** - 快速设置常用权重值（0.5/1.0/1.5）
- **圆形开关** - 单个画师启用/禁用

## 自定义画师库

### CSV 格式
编辑 `artists.csv` 文件添加自定义画师：

```csv
画师名称,关键词,预览图文件名
Akira Toriyama,akira toriyama style anime dragon ball,toriyama.jpg
Your Artist,custom keywords here,custom.jpg

添加预览图

1. 将图片放入 images/ 目录
2. 图片命名与 CSV 中的文件名一致
3. 推荐尺寸：200-400px 宽度，JPG/PNG 格式

动态重载

修改 CSV 后刷新浏览器页面（F5），无需重启 ComfyUI，暂不支持内置R快捷键更新。

高级功能

API 端点

# 获取画师列表
GET /power_artist_loader/artists

# 获取预览图
GET /power_artist_loader/images/{image_name}

节点输入

{
    "text": "基础提示词（可选）",
    "artist_1": {
        "on": true,
        "artist": "Akira Toriyama",
        "strength": 1.2
    }
}

节点输出

return ("keywords",)

文件结构

ComfyUI-Power-Artist-Loader/
├── __init__.py                 # 节点注册入口
├── nodes.py                    # 后端逻辑和 API
├── artists.csv                 # 画师数据库
├── images/                     # 预览图目录
│   ├── toriyama.jpg
│   └── ...
├── web/
│   └── js/
│       └── power_artist_loader.js  # 前端交互
└── README.md

故障排除

节点未出现

• 检查文件路径：ComfyUI/custom_nodes/ComfyUI-Power-Artist-Loader/
• 查看控制台是否有报错信息
• 尝试清除浏览器缓存后刷新

预览图不显示

• 确认图片在 images/ 目录
• 检查 CSV 中文件名是否匹配
• 浏览器 F12 查看 404 错误

权重不生效

• 确保权重值不是默认的 1.00
• 检查输出文本格式是否正确
• 验证 CLIP 节点是否正确解析权重语法

JavaScript 错误

# 浏览器 F12 控制台查看错误
# 常见问题：
# - 文件路径错误 → 检查 web/js/ 目录
# - API 404 → 检查后端 API 路由
# - 语法错误 → 验证 JS 代码完整性

已知限制

• 单节点最多建议 20 个画师槽位（性能考虑）或组合
• 预览图需手动准备，不自动下载
• 权重范围 -1.00-3.00

开发计划

• 内置R热更新CSV读取
• 分类折叠显示
• 预设组合保存/加载
• 导出为独立提示词文件
• 多语言界面

贡献指南

欢迎提交 Issue 和 Pull Request！

提交 Bug

• 使用 Bug Report 模板
• 提供完整的错误信息和复现步骤
• 附上 ComfyUI 版本和系统信息

提交新功能

• 先在 Discussions 讨论方案
• Fork 仓库并创建功能分支
• 遵循现有代码风格
• 添加必要的测试和文档

添加画师

1. 编辑 artists.csv
2. 按分类排序，标题名;keywords;xxx.jpg，注意xxx要和images文件夹下的同名
3. 提供准确的关键词
4. 如有预览图一并提交

技术栈

• 后端: Python 3.8+, aiohttp
• 前端: JavaScript (ES6+), LiteGraph
• UI: 自定义 Canvas 渲染

许可证

MIT License - 详见 LICENSE

致谢

• rgthree-comfy - 设计灵感来源
• ComfyUI - 强大的 SD 工作流平台
• 所有贡献者和使用者的反馈

支持

• 文档: Wiki
• 讨论: Discussions
• 问题: Issues

---

如果这个项目对你有帮助，请给个 ⭐ Star！