AIGODLIKE-ComfyUI-Studio 插件完全教程
1. 插件简介
插件地址: https://github.com/AIGODLIKE/AIGODLIKE-ComfyUI-Studio
AIGODLIKE-ComfyUI-Studio 是一个超级实用的 ComfyUI 界面增强插件!它就像给你的 ComfyUI 装了一个"智能管家",让原本复杂的模型管理变得像逛淘宝一样简单直观。
这个插件能给我们带来什么效果?
- 🎯 可视化模型管理:把枯燥的文件列表变成漂亮的卡片展示,就像手机相册一样
- 🖼️ 一键生成缩略图:自动为你的模型生成预览图,再也不用猜模型效果了
- 🏷️ 智能标签系统:自动根据文件夹给模型打标签,比如"写实风格"、"动漫风格"等
- ⭐ 模型评分功能:可以给模型打星级,好用的模型一眼就能找到
- 🔍 强大搜索功能:支持按名称、标签、评分等多种方式快速找到想要的模型
- 📝 工作流管理:为每个模型保存专属的工作流程,用起来更方便
- 🌍 多语言支持:支持中文、英文等多种语言
- 🚫 模型屏蔽功能:可以隐藏不想看到的模型
简单来说,它就像把你的模型库变成了一个专业的"模型商店",让你能够更直观、更高效地管理和使用各种AI模型!
2. 如何安装
方法一:通过 ComfyUI Manager 安装(推荐)
- 打开 ComfyUI Manager
- 搜索 "AIGODLIKE-ComfyUI-Studio"
- 点击安装即可
方法二:手动安装
- 打开终端/命令行
- 进入你的 ComfyUI 插件目录:
cd ComfyUI/custom_nodes - 运行命令:
git clone https://github.com/AIGODLIKE/AIGODLIKE-ComfyUI-Studio.git - 重启 ComfyUI
注意: 目前此插件仅支持 Windows 10/11 系统。
3. 功能模块详细解析
重要说明: 这个插件不是传统的节点插件,而是一个界面增强工具。它没有可拖拽的节点,而是通过改进现有节点的交互方式来提升用户体验。
3.1 模型管理器 (Model Manager) - 核心管理中心
这个模块就像一个"智能仓库管理员",负责统一管理你所有的AI模型文件。
功能详解:
| 功能名称 | 代码实现 | 功能类型 | 建议设置 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模型路径管理 | ModelManager.model_path_dict() | 路径配置 | 使用默认路径 | 告诉系统去哪里找你的模型文件 | 管理不同类型模型的存储路径映射 | 系统会自动扫描checkpoints、loras等文件夹 |
| 模型重命名 | ModelManager.model_rename() | 文件操作 | 谨慎使用 | 给模型文件改名字,就像给照片重命名 | 安全地重命名模型文件并更新相关配置 | 右键模型选择重命名,输入新名字 |
| 缩略图查找 | ModelManager.find_thumbnail() | 图片管理 | 自动查找 | 为每个模型找到对应的预览图片 | 根据模型名称自动匹配同名图片文件 | 系统会找model.ckpt对应的model.png作为缩略图 |
| 模型查找 | ModelManager.find_model() | 文件检索 | 自动执行 | 在所有模型文件夹中找到指定的模型 | 跨多个路径搜索指定模型文件 | 输入模型名,系统自动定位文件位置 |
3.2 缩略图管理器 (Thumbnail Manager) - 图片展示系统
这个模块就像一个"照片冲印店",专门处理模型的预览图片。
功能详解:
| 功能名称 | 代码实现 | 功能类型 | 建议设置 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图片编码 | ThumbnailManager.add_code() | 安全处理 | 自动执行 | 给每张图片生成一个"身份证号" | 为图片路径生成MD5哈希码用于安全访问 | 系统自动为每个缩略图生成唯一标识 |
| 图片缓存 | ThumbnailManager.add_image() | 性能优化 | 自动管理 | 把常用图片存在"快速存取区" | 将图片数据缓存到内存中提高访问速度 | 第一次加载后,再次查看会更快 |
| 图片获取 | ThumbnailManager.get_image() | 数据读取 | 按需加载 | 从"仓库"里取出指定的图片 | 根据路径或编码获取图片二进制数据 | 点击模型卡片时显示对应的预览图 |
3.3 配置管理器 (Config Manager) - 设置保存系统
这个模块就像一个"记事本管家",记住你的所有个性化设置。
功能详解:
| 功能名称 | 代码实现 | 功能类型 | 建议设置 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 详情管理 | CFG_MANAGER.get_detail() | 数据存储 | 自动保存 | 记住每个模型的详细信息 | 存储模型的元数据如评分、标签等 | 给模型打5星评分,下次打开还是5星 |
| 过滤器管理 | CFG_MANAGER.get_filter() | 筛选配置 | 按需设置 | 记住你的筛选偏好 | 保存用户的模型筛选条件 | 设置只显示5星模型,重启后设置还在 |
| 配置加载 | CFG_MANAGER.load_config() | 初始化 | 启动时执行 | 开机时读取你之前的设置 | 从配置文件加载用户的个性化设置 | 启动ComfyUI时自动恢复你的界面布局 |
| 配置保存 | CFG_MANAGER.dump_config() | 数据持久化 | 实时保存 | 把你的设置写入"记事本" | 将配置数据保存到JSON文件 | 修改设置后自动保存,不会丢失 |
3.4 蓝图系统 (BluePrints) - 节点适配器
这个模块就像一个"万能转换器",让不同的节点都能使用统一的模型管理界面。
功能详解:
| 功能名称 | 代码实现 | 功能类型 | 建议设置 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 节点注册 | BluePrints.CSregister() | 系统集成 | 自动执行 | 给每个模型加载节点装上"管理按钮" | 为支持的节点添加模型管理界面入口 | 在LoRA加载器上会出现一个"+"按钮 |
| 适配器获取 | node.CSgetAdapter() | 接口适配 | 自动匹配 | 找到对应节点的"说明书" | 获取节点对应的模型管理适配器 | 系统知道CheckpointLoader需要管理checkpoints |
| 模型设置 | node.CSsetModelWidget() | 数据绑定 | 用户操作 | 把选中的模型"装"到节点上 | 将选择的模型设置到节点的widget中 | 在管理界面选择模型后自动填入节点 |
| 模型列表获取 | node.CSgetModelLists() | 数据获取 | 实时更新 | 获取当前节点能用的所有模型 | 获取节点对应类型的所有可用模型 | LoRA节点显示所有.safetensors文件 |
3.5 图标渲染器 (Icon Renderer) - 缩略图生成系统
这个模块就像一个"自动拍照机",能够为你的模型自动生成预览图。
功能详解:
| 功能名称 | 代码实现 | 功能类型 | 建议设置 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 渲染状态 | renderer.rendering | 状态管理 | 只读属性 | 显示是否正在"拍照" | 标识当前是否正在执行渲染任务 | 界面显示"正在生成缩略图..."进度条 |
| 进度值 | renderer.progress_value | 进度跟踪 | 自动更新 | 显示"拍照"进度百分比 | 当前渲染任务的完成百分比 | 显示"已完成 60% (3/5)" |
| 任务执行 | renderer.render() | 核心功能 | 用户触发 | 开始为选中的模型"拍照" | 执行模型渲染并生成缩略图 | 选择模型点击"生成缩略图"按钮 |
| 图片获取 | renderer.fetch_image() | 网络请求 | 自动执行 | 从ComfyUI获取生成的图片 | 通过HTTP请求获取渲染结果图片 | 渲染完成后自动下载生成的图片 |
| 上传缩略图 | renderer.executed_cb_user_factory() | 文件上传 | 自动执行 | 把生成的图片保存为模型预览图 | 将渲染结果上传并关联到对应模型 | 生成的图片自动成为模型的缩略图 |
3.6 界面组件系统 (UI Components) - 用户界面
这个模块就像一个"装修设计师",负责设计和布置整个管理界面。
功能详解:
| 功能名称 | 代码实现 | 功能类型 | 建议设置 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 头部组件 | Head Component | 界面布局 | 固定显示 | 顶部的"控制台",包含搜索和设置 | 页面头部区域,包含搜索框和工具栏 | 在顶部输入关键词搜索模型 |
| 分类组件 | Classification Component | 导航系统 | 自动生成 | 左侧的"目录",按类型分组显示 | 模型分类导航,支持按类型筛选 | 点击"LoRA"只显示LoRA模型 |
| 模型组件 | Model Component | 内容展示 | 网格布局 | 中间的"展示区",显示模型卡片 | 模型列表的主要展示区域 | 以卡片形式展示所有模型 |
| 底部组件 | Foot Component | 状态显示 | 条件显示 | 底部的"状态栏",显示进度信息 | 页面底部,显示渲染进度等状态 | 生成缩略图时显示进度条 |
| 设置组件 | Settings Components | 配置界面 | 用户自定义 | "设置面板",调整各种选项 | 用户配置界面,包含语言、快捷键等 | 在设置中切换中英文界面 |
3.7 路由系统 (Router System) - 页面导航
这个模块就像一个"导航员",负责在不同页面之间切换。
功能详解:
| 功能名称 | 代码实现 | 功能类型 | 建议设置 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 首页路由 | /home | 主页面 | 默认页面 | 模型管理的"主界面" | 模型管理的主要功能页面 | 打开插件默认显示的页面 |
| 设置路由 | /settings | 配置页面 | 按需访问 | "设置页面",调整插件选项 | 插件配置和个性化设置页面 | 点击设置按钮进入的页面 |
| 页面切换 | router.push() | 导航控制 | 程序控制 | 在不同页面间"跳转" | 控制单页应用的页面切换 | 从主页跳转到设置页 |
3.8 数据存储系统 (Store System) - 状态管理
这个模块就像一个"信息中转站",负责管理界面上的各种数据和状态。
功能详解:
| 功能名称 | 代码实现 | 功能类型 | 建议设置 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 配置状态 | config store | 全局配置 | 持久化存储 | 记住你的"使用习惯" | 存储用户的配置选项如语言、主题等 | 设置中文界面后全局生效 |
| 属性状态 | prop store | 临时数据 | 会话存储 | 记住当前的"工作状态" | 存储当前会话的临时数据 | 当前选中的模型、搜索关键词等 |
| 状态更新 | store.commit() | 数据变更 | 响应式更新 | "通知"界面数据发生了变化 | 触发状态变更并更新相关界面 | 切换语言时所有文字同步更新 |
4. 支持的节点类型
插件支持以下ComfyUI节点的增强管理:
4.1 标准节点(自动支持)
- CheckpointLoaderSimple - 简易模型加载器
- ImageOnlyCheckpointLoader - 仅图像模型加载器
- unCLIPCheckpointLoader - unCLIP模型加载器
- CheckpointLoader - 标准模型加载器
- VAELoader - VAE加载器
- CLIPVisionLoader - CLIP视觉加载器
- GLIGENLoader - GLIGEN加载器
- ControlNetLoader - ControlNet加载器
- DiffControlNetLoader - DiffControlNet加载器
- LoraLoaderModelOnly - 仅LoRA模型加载器
- LoraLoader - LoRA加载器
- StyleModelLoader - 风格模型加载器
- UpscaleModelLoader - 放大模型加载器
- HypernetworkLoader - 超网络加载器
- CLIPLoader - CLIP加载器
- DualCLIPLoader - 双CLIP加载器
- UNETLoader - UNET加载器
- DiffusersLoader - 扩散模型加载器
4.2 标准参数名(自动识别)
- ckpt_name - 对应checkpoints模型
- vae_name - 对应VAE模型
- clip_name - 对应CLIP模型
- lora_name - 对应LoRA模型
- control_net_name - 对应ControlNet模型
- style_model_name - 对应风格模型
- hypernetwork_name - 对应超网络模型
- unet_name - 对应UNET模型
5. 使用技巧和建议
5.1 快捷键设置
- 默认模式:左键点击模型下拉框打开管理界面
- 兼容模式:Shift+左键点击使用原始下拉列表
- 可在设置中自定义快捷键组合
5.2 模型组织建议
- 文件夹分类:按风格创建子文件夹,如
checkpoints/realistic/、checkpoints/anime/ - 命名规范:使用有意义的文件名,如
realistic_portrait_v2.safetensors - 缩略图准备:为重要模型准备同名的.png或.jpg预览图
5.3 标签管理技巧
- 自动标签:系统会根据文件夹路径自动生成标签
- 手动标签:可以为模型添加自定义标签如"高质量"、"常用"等
- 标签搜索:使用标签快速筛选需要的模型
5.4 缩略图生成建议
- 批量生成:选择多个模型一次性生成缩略图
- 质量设置:使用简单的提示词生成代表性图片
- 定期更新:模型更新后重新生成缩略图
5.5 工作流管理
- 模型专属:为每个常用模型保存专门的工作流
- 命名清晰:工作流使用描述性名称如"人像写实"、"风景生成"
- 定期整理:删除不再使用的工作流文件
6. 常见问题解答
Q1:为什么有些节点没有出现管理按钮?
A1:
- 检查节点是否在支持列表中
- 确认节点参数名是否为标准命名
- 非标准节点需要等待插件更新支持
Q2:缩略图生成失败怎么办?
A2:
- 确保工作流能正常运行
- 检查模型文件是否损坏
- 确认输出节点设置正确
- 查看ComfyUI控制台的错误信息
Q3:界面显示异常或空白?
A3:
- 刷新浏览器页面
- 检查浏览器控制台是否有JavaScript错误
- 确认插件文件完整安装
- 尝试重启ComfyUI
Q4:模型搜索找不到文件?
A4:
- 确认模型文件在正确的文件夹中
- 检查文件扩展名是否正确
- 刷新模型列表
- 检查文件权限设置
Q5:设置保存后丢失?
A5:
- 检查ComfyUI目录的写入权限
- 确认配置文件没有被其他程序锁定
- 查看是否有杀毒软件阻止文件写入
Q6:多语言切换不生效?
A6:
- 刷新页面后重新切换
- 清除浏览器缓存
- 检查语言文件是否完整
7. 高级应用技巧
7.1 自定义节点适配
如果你使用的节点不在支持列表中,可以通过修改blueprints.js文件添加支持:
// 添加自定义节点支持
MyCustomLoader: {
type: "checkpoints", // 模型类型
getWidgets: (n) => n.widgets[0].options?.values,
getSelWidget: (n) => n.widgets[0].value,
setWidget: (n, v) => (n.widgets[0].value = v),
}
7.2 批量模型管理
- 批量重命名:使用文件管理器批量重命名后刷新列表
- 批量移动:整理文件夹结构后重新扫描
- 批量标签:利用文件夹结构自动生成标签
7.3 性能优化建议
- 缩略图大小:控制缩略图文件大小,避免占用过多空间
- 缓存清理:定期清理不需要的缓存文件
- 模型整理:删除不使用的模型文件
7.4 团队协作
- 标准化命名:团队统一模型命名规范
- 共享配置:可以导出配置文件供团队成员使用
- 工作流共享:分享常用的工作流模板
8. 总结
AIGODLIKE-ComfyUI-Studio 是一个革命性的ComfyUI界面增强插件,它将复杂的模型管理变得简单直观。通过本教程,你应该已经掌握了:
- 插件的8个核心功能模块
- 18种支持的节点类型
- 完整的使用技巧和优化建议
- 常见问题的解决方案
这个插件的最大价值在于提升工作效率。它让你能够:
- 快速找到需要的模型
- 直观预览模型效果
- 高效管理大量模型文件
- 保存和复用工作流程
使用建议:
- 先整理好你的模型文件夹结构
- 为常用模型生成缩略图
- 设置好个人偏好的界面选项
- 逐步建立模型的标签和评分系统
记住,这个插件是为了让你的AI创作更加高效愉快。花一些时间熟悉它的功能,你会发现ComfyUI的使用体验得到了质的提升!