%20(1).png)
ComfyUI Easy Civitai (XTNodes) 插件完整使用教程
1. 插件简介
插件地址： https://github.com/X-T-E-R/ComfyUI-EasyCivitai-XTNodes
这个插件就像一个超级智能的模型管家，专门帮你搞定AI模型的下载、加载和管理。想象一下，你平时下载模型就像去菜市场买菜一样麻烦——要找到摊位、挑选商品、付钱、拿回家。而这个插件就像一个贴心的外卖小哥，你只需要告诉他你想要什么，他就能直接送到你家门口，还带着图片预览让你确认是不是你要的那个。
能给你带来什么好处：
- 直接从Civitai网站链接下载模型，不用自己手动下载
- 自动显示模型预览图，一眼就知道这个模型是干嘛的
- 支持多种模型类型（大模型、小模型、模型堆叠）
- 自动验证模型是否正确，避免下载到坏文件
- 本地模型也能显示预览，方便管理
2. 如何安装
方法一：通过ComfyUI管理器（推荐）
- 先安装ComfyUI管理器：https://github.com/ltdrdata/ComfyUI-Manager
- 打开ComfyUI管理器
- 搜索"ComfyUI Easy Civitai (XTNodes)"
- 点击安装
方法二：手动安装
- 下载插件代码：
git clone https://github.com/X-T-E-R/ComfyUI-EasyCivitai-XTNodes - 安装依赖：
pip install -r requirements.txt - 配置设置文件
特别提醒
- Linux系统需要额外安装aria2c下载工具
- 如果要下载某些特殊模型，需要配置Civitai的密钥
3. 节点详细解析
3.1 Civitai Checkpoint Loader (XTNodes) - 大模型直接下载器
这个节点就像一个专业的模型采购员，你给他一个Civitai的网址，他就能把整个大模型搬回来，还会给你展示预览图。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| URL | url | 字符串 | Civitai模型链接 | 就像网购时的商品链接，告诉系统要下载哪个模型 | Civitai模型页面的URL地址 | 复制https://civitai.com/models/352581这样的链接 |
| 预览图片 | preview_images | 开关 | True | 像网购时显示商品图片一样，让你看到模型效果 | 是否生成模型预览图像 | 建议开启，这样能看到模型长什么样 |
3.2 Civitai Lora Loader (XTNodes) - 单个小模型下载器
这个节点就像一个精准的小工具采购员，专门负责下载那些用来调节画风的小模型。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| URL | url | 字符串 | Civitai模型链接 | 小模型的网址，像淘宝商品链接 | LoRA模型在Civitai上的URL | 粘贴LoRA模型的完整链接 |
| 模型权重 | lora_weight | 小数 | 1.0 | 像调节音量大小一样，控制这个小模型的影响力 | LoRA模型的权重强度 | 1.0是标准强度，0.5是一半强度 |
| 跳过加载 | bypass | 开关 | False | 像开关一样，可以暂时关闭这个小模型 | 是否跳过该LoRA的加载 | 想临时不用这个模型时开启 |
| 预览图片 | preview_images | 开关 | True | 显示这个小模型的效果图 | 是否生成预览图像 | 建议开启，方便识别模型 |
3.3 Civitai Lora Loader Stacked (XTNodes) - 多个小模型堆叠器
这个节点就像一个收纳盒，能把多个小模型整整齐齐地叠在一起使用，每个都能单独调节强度。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| URL | url | 字符串 | Civitai模型链接 | 当前要添加的小模型网址 | 要添加到堆栈中的LoRA模型URL | 每次添加一个新的LoRA链接 |
| 模型权重 | lora_weight | 小数 | 1.0 | 这个小模型的影响力大小 | 该LoRA在堆栈中的权重值 | 根据需要调节，一般0.5-1.5之间 |
| 跳过加载 | bypass | 开关 | False | 临时关闭这个小模型 | 是否跳过该LoRA的加载 | 想测试效果时可以关闭某个 |
| 空名称时添加模型名 | append_loraname_if_empty | 开关 | False | 如果找不到提示词，就用模型名字代替 | 当无触发词时是否使用LoRA名称 | 一般保持关闭即可 |
| 预览图片 | preview_images | 开关 | True | 显示模型效果图 | 是否生成预览图像 | 建议开启，方便管理 |
| 模型堆栈 | lora_stack | 堆栈 | 可选 | 前面已经叠好的模型盒子 | 前序的LoRA堆栈输入 | 连接上一个堆栈节点的输出 |
3.4 Civitai Lora Loader Stacked Adv (XTNodes) - 高级多模型堆叠器
这个节点就像前面堆叠器的升级版，功能更强大，能处理更复杂的模型组合。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| URL | url | 字符串 | Civitai模型链接 | 要添加的小模型网址 | LoRA模型的Civitai URL | 复制完整的模型链接 |
| 模型权重 | lora_weight | 小数 | 1.0 | 模型影响力强度 | LoRA权重值 | 根据效果需要调整 |
| 跳过加载 | bypass | 开关 | False | 临时禁用这个模型 | 是否跳过加载 | 用于测试对比效果 |
| 空名称时添加模型名 | append_loraname_if_empty | 开关 | False | 找不到提示词时用模型名 | 无触发词时的处理方式 | 一般保持默认 |
| 预览图片 | preview_images | 开关 | True | 显示模型预览图 | 是否生成预览 | 建议开启 |
| 模型堆栈 | lora_stack | 堆栈 | 可选 | 已有的模型组合 | 前序LoRA堆栈 | 连接其他堆栈节点 |
3.5 Load Checkpoint with Previews (XTNodes) - 本地大模型预览加载器
这个节点就像一个智能文件管理器，专门负责加载你电脑里已经下载好的大模型，还会自动显示预览图。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模型名称 | model_name | 字符串 | 模型文件名 | 你电脑里模型文件的名字 | 本地checkpoint文件名 | 选择models文件夹里的.safetensors文件 |
| 预览图片 | preview_images | 开关 | True | 显示这个模型的效果图 | 是否生成预览图像 | 建议开启，方便识别模型 |
3.6 Load Lora with Previews (XTNodes) - 本地小模型预览加载器
这个节点就像一个智能的小工具箱，专门管理你电脑里的小模型文件。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模型名称 | lora_name | 字符串 | 小模型文件名 | 你电脑里小模型的文件名 | 本地LoRA文件名 | 选择loras文件夹里的文件 |
| 模型权重 | lora_weight | 小数 | 1.0 | 调节这个小模型的影响力 | LoRA权重强度 | 根据需要调节强度 |
| 跳过加载 | bypass | 开关 | False | 临时关闭这个小模型 | 是否跳过加载 | 用于对比测试 |
| 预览图片 | preview_images | 开关 | True | 显示模型效果图 | 是否生成预览 | 建议开启 |
3.7 Load Lora Stacked with Previews (XTNodes) - 本地多模型堆叠预览器
这个节点就像一个本地的模型收纳盒，能把你电脑里的多个小模型整齐地组合起来。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模型名称 | lora_name | 字符串 | 小模型文件名 | 当前要添加的小模型名字 | 本地LoRA文件名 | 从列表中选择文件 |
| 模型权重 | lora_weight | 小数 | 1.0 | 这个小模型的影响力大小 | LoRA权重值 | 调节影响强度 |
| 跳过加载 | bypass | 开关 | False | 临时关闭这个小模型 | 是否跳过加载 | 用于测试对比 |
| 预览图片 | preview_images | 开关 | True | 显示模型效果图 | 是否生成预览 | 建议开启 |
| 模型堆栈 | lora_stack | 堆栈 | 可选 | 已有的模型组合 | 前序LoRA堆栈 | 连接其他堆栈 |
3.8 Load Lora Stacked Advanced with Previews (XTNodes) - 高级本地堆叠预览器
这个节点是本地模型管理的旗舰版，功能最全面，适合高级用户。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模型名称 | lora_name | 字符串 | 小模型文件名 | 要添加的小模型名称 | 本地LoRA文件名 | 选择合适的文件 |
| 模型权重 | lora_weight | 小数 | 1.0 | 模型影响力强度 | LoRA权重值 | 精细调节效果 |
| 跳过加载 | bypass | 开关 | False | 临时禁用模型 | 是否跳过加载 | 测试用途 |
| 预览图片 | preview_images | 开关 | True | 显示效果预览 | 是否生成预览 | 建议开启 |
| 模型堆栈 | lora_stack | 堆栈 | 可选 | 已有模型组合 | 前序LoRA堆栈 | 连接堆栈链 |
4. 使用技巧和建议
4.1 新手入门建议
- 先试试本地预览功能：如果你已经有一些模型文件，先用"Load Checkpoint with Previews"节点，看看预览效果。
- 从单个模型开始：不要一开始就用堆叠功能，先用单个模型熟悉界面。
- 权重从小开始：小模型权重建议从0.5开始试，避免效果过强。
4.2 高级用户技巧
- 善用跳过功能：在测试不同模型组合时，用bypass功能快速对比效果。
- 合理安排堆叠顺序：不同模型的叠加顺序会影响最终效果。
- 预览图帮助管理：利用预览图功能整理和分类你的模型库。
4.3 性能优化建议
- 不要同时开启太多预览：如果电脑性能一般，可以关闭部分预览功能。
- 合理设置权重：权重设置过高可能导致效果过度，一般不超过1.5。
- 定期清理缓存：长期使用后清理一下临时文件。
5. 常见问题解答
Q1: 为什么有些模型下载失败？
答： 可能是网络问题或者模型需要登录权限。检查网络连接，如果是特殊模型，需要配置Civitai的密钥。
Q2: 预览图显示不出来怎么办？
答： 检查preview_images参数是否开启，如果还是不行，可能是模型文件没有包含预览信息。
Q3: 模型权重设置多少合适？
答： 一般情况下：
- 人物模型：0.6-1.0
- 画风模型：0.5-0.8
- 场景模型：0.7-1.2
Q4: 堆叠多个模型时有什么注意事项？
答：
- 不要堆叠太多模型（建议不超过5个）
- 注意模型之间的兼容性
- 总权重不要过高
Q5: Linux系统安装失败怎么办？
答： 先安装aria2c：
sudo apt-get update
sudo apt-get install aria2
6. 总结
这个插件就像是给ComfyUI装了一个智能管家，让模型管理变得超级简单。无论你是新手还是高手，都能从中受益。新手可以享受到可视化的便利，高手可以利用堆叠功能创造更复杂的效果。
记住最重要的一点：多试多练！每个模型都有自己的特点，只有不断尝试才能找到最适合你需求的设置。这个插件提供了很好的预览功能，让你的试验过程更加直观和高效。
现在就开始你的AI创作之旅吧！有了这个插件，管理模型再也不是难事了。