ComfyUI LoRA Manager：LoRA模型管理利器

在人工智能领域，特别是在图像生成等应用中，LoRA（Low-Rank Adaptation）模型正发挥着越来越重要的作用。而对于使用ComfyUI的用户来说，管理这些LoRA模型可能会成为一项挑战。不过别担心，ComfyUI LoRA Manager这款工具应运而生，它能帮助你更轻松地管理、下载和应用LoRA模型。接下来，就让我们一起深入了解一下这款工具吧。

一、ComfyUI LoRA Manager 简介

1.1 工具概述

ComfyUI LoRA Manager是一款综合性的工具集，旨在简化在ComfyUI中组织、下载和应用LoRA模型的流程。它具有强大的功能，如配方管理、检查点组织以及一键式工作流集成等，让模型的使用变得更加快捷、流畅和简单。你可以通过访问 http://localhost:8188/loras 来打开其界面。

Interface Preview

1.2 社区与版本信息

  • 社区支持：该项目有活跃的社区支持，你可以通过 Discord 加入社区，与其他用户交流和获取帮助。
  • 版本信息：可以在 GitHub 上查看最新版本以及发布日期等信息。

二、主要功能亮点

2.1 一键式集成

ComfyUI LoRA Manager提供了一键式集成功能，让你能够更方便地将LoRA模型应用到工作流中。

One-Click Integration

2.2 浏览器扩展

为了提升你在Civitai上的浏览体验，该工具还推出了配套的浏览器扩展。通过这个扩展，你可以查看哪些模型已经在本地库中，一键下载新模型，并高效管理下载任务。

LM Civitai Extension Preview

你可以从 Chrome Web Store 获取Chrome扩展，也可以从 这里 下载Firefox扩展（已通过Mozilla审核验证）。

2.3 版本更新内容

2.3.1 v0.8.20

  • LM Civitai Extension：通过Chrome Web Store发布了浏览器扩展，该扩展能与LoRA Manager无缝配合，提升Civitai浏览体验。它可以显示哪些模型已在本地库中，支持一键下载，并提供队列和并行下载功能。
  • Enhanced Lora Loader：增加了对nunchaku的支持，在使用ComfyUI – nunchaku工作流时更加方便，同时还提供了新的模板工作流，便于快速上手。
  • WanVideo Integration：引入了与ComfyUI – WanVideoWrapper兼容的WanVideo Lora Select (LoraManager) 节点，简化了视频工作流中LoRA的使用，还提供了模板工作流帮助你快速开始。

2.3.2 v0.8.19

  • Analytics Dashboard：新增统计页面，提供对模型收藏和使用模式的全面可视化分析，帮助你更好地了解自己的模型库。
  • Target Node Selection：增强了工作流集成功能，当向包含多个加载器/堆叠器节点的工作流发送LoRA/配方时，能够智能选择目标节点。现在会出现一个可视化选择器，显示节点的颜色、类型、ID和标题，以便精确选择。
  • Enhanced NSFW Controls：支持在配方上设置NSFW级别，并根据用户偏好自动模糊内容。
  • Customizable Card Display：新增显示设置，允许用户选择卡片信息和操作按钮是始终可见还是仅在悬停时显示。
  • Expanded Compatibility：在保存配方和保存图像节点中增加了对efficiency – nodes – comfyui的支持，并修复了与ComfyUI_Custom_Nodes_AlekPet的兼容性问题。

2.3.3 v0.8.18

  • Custom Example Images：允许导入自己的LoRA和检查点示例图像，并能从嵌入信息中自动提取元数据。
  • Enhanced Example Management：新增操作按钮，可将特定示例设置为预览或删除自定义示例。
  • Improved Duplicate Detection：增强了“查找重复项”功能，增加了哈希验证，减少了识别重复模型时的误报。
  • Tag Management：添加了标签编辑功能，用户可以自定义和管理模型标签。
  • Advanced Selection Controls：实现了Ctrl + A快捷键，可快速选择所有过滤后的LoRA，必要时自动进入批量模式。
  • Note：缓存文件功能暂时禁用，等待重新设计。

2.3.4 v0.8.17

  • Duplicate Model Detection：为LoRA和检查点添加了“查找重复项”功能，使用模型文件哈希检测，方便查看和批量删除重复模型。
  • Enhanced URL Recipe Imports：优化了通过URL导入配方的功能，使用CivitAI API调用代替网页抓取，现在支持所有评级图像（包括NSFW）的配方导入。
  • Improved TriggerWord Control：增强了TriggerWord Toggle节点，新增默认活动开关，可设置添加触发词时的初始状态（活动/非活动）。
  • Centralized Example Management：添加了“迁移现有示例图像”功能，可将从模型文件夹下载的示例图像合并到中央存储中，并支持自定义命名模式。
  • Intelligent Word Suggestions：通过读取safetensors文件中的类令牌和标签频率，实现了智能触发词建议，在编辑触发词时显示推荐。
  • Model Version Management：添加了“重新链接到CivitAI”上下文菜单选项，可在需要时将模型连接到不同的CivitAI版本。

2.3.5 v0.8.16

  • Dramatic Startup Speed Improvement：添加了缓存序列化机制，显著加快了加载时间，尤其对于大型模型收藏非常有益。
  • Enhanced Refresh Options：扩展了刷新功能，除了“快速刷新（增量）”外，还增加了“完全重建（完整）”选项，可在不重启应用程序的情况下修复潜在的内存缓存问题。
  • Customizable Display Density：用可调节的显示密度设置取代了紧凑模式，实现个性化布局定制。
  • Model Creator Information：在模型信息面板中添加了创建者详细信息，便于更好地归因。
  • Improved WebP Support：增强了保存图像节点，支持WebP格式图像的工作流嵌入。
  • Direct Example Access：在卡片界面添加了“打开示例图像文件夹”按钮，方便浏览下载的模型示例。
  • Enhanced Compatibility：全面支持ComfyUI Desktop的“将LoRA或配方发送到工作流”功能。
  • Cache Management：添加了清除现有缓存文件的设置。
  • Bug Fixes & Stability：进行了各种改进，提高了整体可靠性和性能。

2.3.6 v0.8.15

  • Enhanced One – Click Integration：用直接发送按钮取代了复制按钮，允许将LoRA/配方直接发送到当前的ComfyUI工作流，无需粘贴。
  • Flexible Workflow Integration：点击可将LoRA/配方追加到现有加载器节点，Shift + 点击可替换内容，此外还有右键菜单选项“发送到工作流（追加）”或“发送到工作流（替换）”。
  • Improved LoRA Loader Controls：添加了标题拖动功能，可同时按比例调整所有LoRA的强度（展开时包括CLIP强度）。
  • Keyboard Navigation Support：实现了Page Up/Down用于页面滚动，Home键跳转到顶部，End键跳到底部，方便快速浏览大型收藏。

2.3.7 v0.8.14

  • Virtualized Scrolling：完全重建了渲染机制，实现了流畅的浏览，无滞后或冻结，现在支持几乎无限的模型收藏，并针对大型显示器优化了布局，提高了空间利用率和用户体验。
  • Compact Display Mode：添加了节省空间的视图选项，每行显示更多卡片（1080p显示7张，2K显示8张，4K显示10张）。
  • Enhanced LoRA Node Functionality：对LoRA加载器/堆叠器节点进行了全面改进，包括实时触发词更新（反映LoRA链中任何位置的更改，实现精确更新）和扩展的上下文菜单，包含“复制笔记”和“复制触发词”选项，加快工作流。

2.3.8 v0.8.13

  • Enhanced Recipe Management：添加了“查找重复项”功能，可识别和批量删除重复配方，并在导入时提供重复检测通知。
  • Improved Source Tracking：通过URL导入的配方现在会保存源URL，用户可以一键查看原始内容或手动编辑链接。
  • Advanced LoRA Control：在加载器/堆叠器节点中双击LoRA可访问扩展的CLIP强度控制，分别更精确地调整模型和CLIP强度。
  • Lycoris Model Support：增加了对Lycoris模型的兼容性，提供了更多创意选项。
  • Bug Fixes & UX Improvements：解决了各种问题，并通过大量优化增强了整体用户体验。

2.3.9 v0.8.12

  • Enhanced Model Discovery：在LoRA页面添加了字母导航栏，方便快速浏览大型收藏。
  • Optimized Example Images：改进了下载逻辑，在获取示例图像之前自动刷新陈旧的元数据。
  • Model Exclusion System：新增右键选项，可将特定的LoRA或检查点排除在管理之外。
  • Improved Showcase Experience：增强了LoRA和检查点展示区域的交互性，提高了可用性。

2.3.10 v0.8.11

  • Offline Image Support：添加了下载和本地保存所有模型示例图像的功能，确保即使离线、图像从CivitAI移除或网站关闭时也能访问。
  • Resilient Download System：实现了暂停/恢复功能和检查点恢复，即使重启或意外退出也能继续下载。
  • Bug Fixes & Stability：解决了各种问题，增强了整体可靠性和性能。

2.3.11 v0.8.10

  • Standalone Mode：可以独立于ComfyUI运行LoRA Manager，提供轻量级体验，即使使用其他稳定扩散接口也能工作。
  • Portable Edition：新增一键式便携式版本，方便在独立模式下启动和更新。
  • Enhanced Metadata Collection：在元数据收集模块中增加了对SamplerCustomAdvanced节点的支持。
  • Improved UI Organization：优化了Lora Loader节点的高度，可同时显示多达5个LoRA，并为更大的收藏提供滚动功能。

三、关键特性

3.1 高性能

  • 快速加载和浏览：能够快速加载模型，并让你流畅地浏览大型模型收藏。
  • 平滑滚动：即使面对大量模型，滚动操作也非常流畅。

3.2 丰富的模型集成

  • 直接下载：可以直接从CivitAI下载模型。
  • 预览功能：支持预览模型的图像和视频，同时提供模型描述和版本选择。
  • 触发词查看：能让你一目了然地看到模型的触发词，并支持一键式工作流集成和预设值设置。

3.3 检查点管理

  • 扫描与组织：可以扫描和组织检查点模型。
  • 过滤与搜索：方便你对模型收藏进行过滤和搜索。
  • 元数据管理：支持查看和编辑模型的元数据，还能帮助你清理和管理磁盘空间。

3.4 LoRA配方管理

  • 保存与分享：可以保存和分享你喜欢的LoRA组合。
  • 参数保存：保留生成参数，以便将来参考。
  • 快速应用：能够快速将配方应用到工作流中，并支持导入/导出功能，方便社区分享。

3.5 用户友好

  • 一键访问：可以从ComfyUI菜单一键访问LoRA Manager。
  • 快捷操作：提供上下文菜单，方便进行快速操作。
  • 自定义功能：支持添加自定义笔记和使用提示，还提供多文件夹支持和可视化进度指示器，让你在初始化过程中了解进度。

四、安装方法

4.1 ComfyUI Manager（推荐给ComfyUI用户）

  1. 打开 ComfyUI。
  2. 进入 Manager > Custom Node Manager。
  3. 搜索 lora - manager。
  4. 点击 Install。

4.2 便携式独立版本（无需ComfyUI）

  1. 下载 Portable Package。
  2. 将提供的 settings.json.example 文件复制到 comfyui - lora - manager 文件夹中，创建一个新的 settings.json 文件。
  3. 编辑 settings.json，添加正确的模型文件夹路径和CivitAI API密钥。
  4. 运行 run.bat。

4.3 手动安装

git clone https://github.com/willmiao/ComfyUI-Lora-Manager.git
cd ComfyUI-Lora-Manager
pip install -r requirements.txt

五、使用方法

5.1 访问LoRA管理器

有两种方式可以访问LoRA管理器：

  • 点击ComfyUI菜单中的“Launch LoRA Manager”按钮。
  • 直接访问 http://localhost:8188/loras。

5.2 界面操作

在界面中，你可以进行以下操作：

  • 浏览与组织：浏览和组织你的LoRA模型。
  • 下载模型：直接从CivitAI下载模型。
  • 图像管理：自动获取或手动设置预览图像。
  • 触发词查看：查看和复制与每个LoRA关联的触发词。
  • 添加笔记：添加个人笔记和使用提示。

5.3 在工作流中使用LoRA

  1. 在工作流中添加“Lora Loader (LoraManager)”节点。
  2. 在管理器界面中选择一个LoRA。
  3. 点击复制按钮或使用右键菜单中的“Copy LoRA syntax”。
  4. 将复制的内容粘贴到Lora Loader节点的文本输入框中。
  5. 该节点将自动应用预设的强度和触发词。

5.4 保存图像节点的文件名格式模式

保存图像节点支持使用模式代码进行动态文件名生成。以下是可用的模式代码及其示例：

模式代码 说明 示例
%seed% 插入生成种子编号 image_%seed% → image_1234567890
%width% 插入图像宽度 gen_%width%x%height% → gen_512x768
%height% 插入图像高度 同 %width% 示例
%pprompt:N% 插入正提示（限制为N个字符） %pprompt:20%_%seed% → beautiful landscape_1234567890
%nprompt:N% 插入负提示（限制为N个字符） 类似 %pprompt:N% 用法
%model:N% 插入模型/检查点名称（限制为N个字符） %model:10%_%seed% → dreamshape_1234567890
%date% 插入当前日期/时间，格式为“yyyyMMddhhmmss”
%date:FORMAT% 使用自定义格式插入日期 %date:yyyy-MM-dd% → 2025-04-28

你可以组合多个模式代码来创建详细、有组织的文件名。

5.5 独立模式

5.5.1 ComfyUI用户

  1. 至少启动一次带有LoRA Manager的ComfyUI，以在 settings.json 文件中初始化必要的路径信息。
  2. 确保依赖项已安装：pip install -r requirements.txt。
  3. 从ComfyUI根目录运行：
python custom_nodes\comfyui-lora-manager\standalone.py
  1. 访问界面：http://localhost:8188/loras。
  2. 你可以通过参数指定不同的主机或端口：
python custom_nodes\comfyui-lora-manager\standalone.py --host 127.0.0.1 --port 9000

5.5.2 非ComfyUI用户

  1. 将提供的 settings.json.example 文件复制并创建一个新的 settings.json 文件。
  2. 编辑 settings.json，添加正确的模型文件夹路径和CivitAI API密钥。
  3. 安装所需的依赖项：pip install -r requirements.txt。
  4. 运行独立模式：
python standalone.py
  1. 通过浏览器访问界面：http://localhost:8188/loras

独立模式为你提供了一种轻量级的方式来管理模型和配方收藏，无需运行完整的ComfyUI环境，对于主要使用其他稳定扩散接口的用户也非常有用。

六、贡献与支持

6.1 贡献方式

目前，由于项目处于早期阶段且正在快速开发和重构，暂时不接受拉取请求。但你的反馈和想法对项目非常有价值：

  • 如果你遇到任何错误，可以在GitHub上提交问题。
  • 你可以通过GitHub问题提交功能请求。
  • 分享你对改进的建议。

6.2 支持项目

如果你觉得这个项目很有帮助，可以考虑支持其开发：

6.3 加入社区

你可以加入 Discord社区，获取支持、参与讨论并了解项目的最新动态。

七、常见问题解答（FAQ）

7.1 如何使用CivitAI下载功能？

要使用CivitAI下载功能，你需要：

  1. 从你的CivitAI个人资料设置中获取API密钥。
  2. 将其添加到LoRA Manager的设置页面。
  3. 保存设置。

7.2 安装过程中遇到问题怎么办？

如果你在安装过程中遇到问题，可以参考安装部分的说明，确保按照正确的步骤进行操作。如果问题仍然存在，可以在Discord社区或GitHub上寻求帮助。

7.3 如何在工作流中更好地使用LoRA？

你可以按照使用方法部分的步骤，在工作流中添加“Lora Loader (LoraManager)”节点，并正确复制和粘贴LoRA语法。同时，可以根据需要调整预设的强度和触发词。

7.4 独立模式有什么优势？

独立模式提供了一种轻量级的方式来管理模型和配方收藏，无需运行完整的ComfyUI环境，对于主要使用其他稳定扩散接口的用户也非常有用。

ComfyUI LoRA Manager是一款功能强大、易于使用的工具，它能帮助你更好地管理和应用LoRA模型。无论是对于初学者还是有经验的用户，都能在提高工作效率和创作质量方面发挥重要作用。希望通过本文的介绍，你能对这款工具有更深入的了解，并在实际应用中充分发挥其优势。