%20(1).png)
CivitAI ComfyUI 插件完全教程
1. 插件简介
插件地址： https://github.com/civitai/civitai_comfy_nodes
这个插件就像是给你的ComfyUI装了一个"万能下载器"！你知道平时我们要用新的模型或者LoRA时，总是要先去CivitAI网站下载，然后手动放到对应的文件夹里，非常麻烦。有了这个插件，就像有了一个贴心的小助手，只要告诉它一个编号，它就会自动帮你下载并放到正确的位置！
主要功能：
- 🚀 自动下载模型：就像网购一样，输入商品编号就能自动送货上门
- 📦 自动整理文件：下载完自动放到正确的文件夹，不用你操心
- 🔍 智能识别：能自动识别你已经用过的模型，避免重复下载
- 📋 完整记录：记住所有下载历史，方便以后查找
- 🌐 无缝集成：和ComfyUI完美配合，用起来就像原生功能
能带来什么效果：
- 告别手动下载和整理文件的烦恼
- 一键获取网上分享的工作流所需的所有资源
- 自动管理模型版本，避免混乱
- 大大提高工作效率，专注创作而不是文件管理
2. 如何安装
方法一：使用ComfyUI Manager（推荐）
- 打开ComfyUI Manager
- 搜索"CivitAI"
- 找到"CivitAI ComfyUI Nodes"点击安装
- 重启ComfyUI
方法二：手动安装
- 打开终端或命令提示符
- 进入ComfyUI的custom_nodes文件夹
- 运行以下命令：
git clone https://github.com/civitai/civitai_comfy_nodes.git
- 重启ComfyUI
安装后你会看到： 在节点菜单的"CivitAI/Loaders"分类下出现两个新节点。
3. 节点详细解析
3.1 CivitAI Checkpoint Loader 节点
这个节点就像是一个"智能模型管家"，它能帮你自动下载和加载大模型（就是那些用来生成图片的主要模型）。你只需要告诉它一个编号，它就会自动从CivitAI下载对应的模型并加载好。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| ckpt_air | ckpt_air | 文本输入 | {model_id}@{model_version} | 就像商品的条形码，告诉系统你要哪个模型的哪个版本 | CivitAI的AIR标识符，用于唯一标识模型资源 | 输入"109395@84321"表示要ID为109395的模型的84321版本 |
| ckpt_name | ckpt_name | 下拉选择 | none | 就像从你的收藏夹选择已有的模型，选"none"表示要下载新的 | 从本地已有检查点文件中选择，或选择none进行下载 | 如果本地已有模型就选择，没有就保持"none" |
| api_key | api_key | 文本输入 | 空 | 就像你的VIP会员卡，有了它能下载更多资源和提高速度 | CivitAI的API密钥，用于身份验证和访问权限 | 在CivitAI账户设置中获取，粘贴到这里 |
| download_chunks | download_chunks | 整数滑块 | 4 | 就像同时开几个下载线程，数字越大下载越快但占用资源越多 | 并行下载的分块数量，影响下载速度 | 网速快用8-12，网速慢用2-4 |
| download_path | download_path | 下拉选择 | 默认路径 | 就像选择把文件保存到哪个文件夹 | 指定模型文件的保存路径 | 一般保持默认，除非你有特殊的文件夹结构 |
输出：
- MODEL：加载好的模型，就像准备好的画笔
- CLIP：文字理解器，就像翻译官
- VAE：图片编码器，就像图片格式转换器
3.2 CivitAI Lora Loader 节点
这个节点就像是一个"风格化妆师"，它能帮你自动下载和应用LoRA（一种用来改变图片风格的小插件）。比如你想让图片变成动漫风格，或者添加特定的人物特征，这个节点就能帮你搞定。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| model | model | 连接输入 | 来自其他节点 | 就像给化妆师提供一个基础的脸，这里连接主模型 | 输入的基础模型对象 | 用线连接到Checkpoint Loader的MODEL输出 |
| clip | clip | 连接输入 | 来自其他节点 | 就像给化妆师提供说明书，这里连接文字理解器 | 输入的CLIP文本编码器对象 | 用线连接到Checkpoint Loader的CLIP输出 |
| lora_air | lora_air | 文本输入 | {model_id}@{model_version} | 就像化妆品的产品编号，告诉系统你要哪个LoRA | CivitAI的AIR标识符，用于唯一标识LoRA资源 | 输入"12345@67890"表示要ID为12345的LoRA的67890版本 |
| lora_name | lora_name | 下拉选择 | none | 就像从你的化妆盒选择已有的化妆品，选"none"表示要下载新的 | 从本地已有LoRA文件中选择，或选择none进行下载 | 如果本地已有LoRA就选择，没有就保持"none" |
| strength_model | strength_model | 小数滑块 | 1.0 | 就像调节化妆的浓淡程度，数字越大效果越明显 | LoRA对模型的影响强度 | 一般用0.7-1.2，太高可能过度，太低效果不明显 |
| strength_clip | strength_clip | 小数滑块 | 1.0 | 就像调节文字理解的敏感度，影响对提示词的反应 | LoRA对CLIP文本编码器的影响强度 | 通常和strength_model保持一致 |
| api_key | api_key | 文本输入 | 空 | 就像你的VIP会员卡，有了它能下载更多资源和提高速度 | CivitAI的API密钥，用于身份验证和访问权限 | 在CivitAI账户设置中获取，粘贴到这里 |
| download_chunks | download_chunks | 整数滑块 | 4 | 就像同时开几个下载线程，数字越大下载越快但占用资源越多 | 并行下载的分块数量，影响下载速度 | 网速快用8-12，网速慢用2-4 |
| download_path | download_path | 下拉选择 | 默认路径 | 就像选择把化妆品放到哪个化妆盒里 | 指定LoRA文件的保存路径 | 一般保持默认，除非你有特殊的文件夹结构 |
输出：
- MODEL：应用了LoRA效果的模型
- CLIP：应用了LoRA效果的文字理解器
4. 使用技巧和建议
🎯 基础使用流程
第一次使用：
- 获取AIR编号：去CivitAI网站找到你想要的模型或LoRA，复制它的编号
- 设置API Key：在CivitAI账户设置中生成API密钥，粘贴到节点中
- 选择下载设置：根据网速调整download_chunks参数
- 连接节点：按照正常的ComfyUI流程连接节点
- 运行工作流：第一次会自动下载，以后就直接使用了
日常使用：
- 如果模型已经下载过，可以直接从下拉菜单选择
- 想用新模型时，输入新的AIR编号即可
- 系统会自动记住所有下载历史
💡 AIR编号使用技巧
AIR编号格式：
12345：只指定模型ID，会下载默认版本12345@67890：指定模型ID和版本ID，下载特定版本
如何获取AIR编号：
- 在CivitAI账户设置中开启"显示AIR"功能
- 在模型页面就能看到可复制的编号
- 也可以从URL中提取：
https://civitai.com/models/12345中的12345就是模型ID
🚀 性能优化建议
网络设置：
- 网速快（100M以上）：download_chunks设为8-12
- 网速中等（50M左右）：download_chunks设为4-6
- 网速慢（20M以下）：download_chunks设为2-3
存储管理：
- 定期清理不用的模型文件
- 使用不同的download_path分类管理
- 大模型建议放在SSD上提高加载速度
🎨 工作流集成技巧
标准工作流：
CivitAI Checkpoint Loader → CivitAI Lora Loader → 其他节点
多LoRA叠加：
Checkpoint Loader → Lora Loader 1 → Lora Loader 2 → Lora Loader 3
混合使用：
- 主模型用CivitAI自动下载
- 常用LoRA手动选择本地文件
- 新LoRA用AIR编号自动下载
5. 常见问题解答
❓ 为什么下载很慢或失败？
可能原因和解决方法：
- 网络问题：检查网络连接，尝试使用VPN
- API Key问题：确认API Key正确且有效
- 服务器繁忙：等待一段时间后重试
- 下载线程过多：降低download_chunks数值
❓ 下载的文件在哪里？
文件位置：
- 模型文件：
ComfyUI/models/checkpoints/ - LoRA文件：
ComfyUI/models/loras/ - 可以通过download_path参数自定义位置
❓ 如何获取API Key？
获取步骤：
- 登录CivitAI网站
- 进入账户设置（Account Settings）
- 找到API Keys部分
- 生成新的API Key
- 复制并粘贴到插件中
❓ AIR编号在哪里找？
查找方法：
- 在CivitAI账户设置中开启"Early Access"功能
- 在模型页面会显示AIR编号
- 或者从浏览器地址栏的URL中提取ID
❓ 为什么有些模型下载不了？
可能原因：
- 模型需要登录才能下载（需要API Key）
- 模型被设为私有或删除
- 网络限制或地区限制
- API Key权限不足
❓ 下载的模型质量有问题怎么办？
检查方法：
- 插件会自动验证文件完整性（SHA256校验）
- 如果校验失败会自动重新下载
- 手动删除有问题的文件，重新运行工作流
❓ 能同时下载多个模型吗？
注意事项：
- 可以在不同的节点中设置不同的AIR编号
- 但建议一次只下载一个大模型，避免网络拥堵
- LoRA文件较小，可以同时下载多个
6. 高级使用技巧
🔄 批量管理技巧
工作流模板：
- 创建常用的工作流模板，包含常用的AIR编号
- 需要时只需修改AIR编号即可快速切换模型
- 可以为不同类型的创作准备不同的模板
版本管理：
- 使用完整的AIR编号（包含版本ID）确保结果一致
- 测试新版本时可以并行保留旧版本
- 在download_history.json中查看所有下载记录
📊 性能监控
下载状态监控：
- 观察终端输出了解下载进度
- 注意SHA256校验结果确保文件完整
- 监控磁盘空间避免下载失败
网络优化：
- 在网络空闲时间下载大文件
- 使用有线网络替代WiFi提高稳定性
- 考虑使用下载加速工具
🎯 创作工作流优化
资源预下载：
- 提前下载常用的模型和LoRA
- 建立个人的资源库分类管理
- 定期更新和清理过时的资源
团队协作：
- 统一使用AIR编号分享工作流
- 建立团队资源库和标准
- 使用版本控制管理工作流文件
7. 总结
CivitAI ComfyUI插件是一个非常实用的资源管理工具，它的两个核心节点各有特色：
- Checkpoint Loader：专门处理大模型的下载和加载
- Lora Loader：专门处理LoRA的下载和应用
通过这个插件，你可以：
✅ 告别手动下载和文件管理的烦恼
✅ 一键获取网上分享的完整工作流
✅ 自动管理模型版本和文件完整性
✅ 大大提高创作效率
使用建议：
- 先设置好API Key，享受完整功能
- 根据网速调整下载参数
- 建立自己的资源管理习惯
- 定期清理不用的文件释放空间
这个插件就像给ComfyUI装了一个智能的资源管理助手，让你可以专注于创作而不是文件管理。配合CivitAI丰富的资源库，你的创作之路会更加顺畅！🎉
最后提醒： 下载模型时请遵守相关版权和使用协议，合理使用网络资源，做一个文明的AI创作者！