ComfyUI LoRA 管理器

用 ComfyUI 的终极 LoRA 伴侣彻底革新你的工作流程！

这是一套全面的工具集，可简化在 ComfyUI 中组织、下载和应用 LoRA 模型的过程。凭借配方管理、检查点整理以及一键式工作流集成等强大功能，使用模型将变得更加快速、流畅且轻松。可通过以下地址访问界面：http://localhost:8188/loras

📺 教程：一键式 LoRA 集成

观看本快速教程，了解如何使用全新的一键式 LoRA 集成功能：

🌐 浏览器扩展

借助我们的配套浏览器扩展，提升你在 Civitai 上的浏览体验吧！查看你已拥有的模型、一键下载新模型，并高效管理你的下载内容。

📚 了解更多：完整教程

---

🤝 支持者表彰

我由衷感谢每一位支持本项目开发的朋友。看到这么多人认可我的工作，是我所能获得的最佳动力。你们的信任与支持对打造如今这款工具起到了至关重要的作用，借此机会我要特别向那些帮助实现这一切的人表示感谢。

🌟 特别致谢

dispenser, EbonEagle, DanielMagPizza, Scott R

💖 支持者（666 位）

点击查看所有了不起的支持者

失眠艺术设计、megakirbs、布伦诺克、2018cfh、W+K+White、wackop、塔坎、卡尔G、$MetaSamsara、itismyelement、onesecondinosaur、stone9k、罗森塔尔、弗朗西斯科·塔蒂斯、安德鲁·威尔逊、格雷布什、Gooohokrbe、瑞奇·卡特、韩宗元、OldBones、VantAI、runte3221、FreelancerZ、埃德加·特赫达、利亚姆·麦克道格尔、弗雷泽·克罗斯、多态不定型、伯迪、马克·威芬、豪尔赫·胡斯尼、基巴、Skalabananen、雷诺·林、sig、克里斯蒂安·伯恩、DM、Sen314、艾斯托根、J\B/ 8r0wns0n、Snaggwort、阿尔莱基诺·希昂、查尔斯·布莱克莫尔、罗布·威廉姆斯、ClockDaemon、KD、Omnidex、泰勒·特鲁布肖恩、Release Cabrakan、Tobi_Swagg、SG、carozzz、詹姆斯·杜利、zenbound、秃鹫、jmack、马克·科内格里奥、讽刺标签、Cosmosis、iamresist、RedrockVP、沃尔芬、FloPro4Sho、詹姆斯·托德、史蒂文·普费弗、蒂姆、Lisster、迈克尔·王、Illrigger、汤姆·科里根、杰基·王、fnkylove、朱利安·V、史蒂文·欧文斯、Yushio、Vik71it、Echo、Lilleman、罗伯特·斯泰西、PM、托德·凯克、Mozzel、银杏叶、Sterilized、BadassArabianMofo、帕斯卡·达勒、quarz、格雷格、Penfore、JSST、esthe、lmsupporter、IamAyam、wfpearl、Baekdoosixt、乔纳森·罗斯、杰克·B·敏捷、Nazono_hito、梅尔维尔·帕里什、丹尼尔·鸽子、Lustre、JW Sin、contrite831、亚历克斯、bh、被没收的Zyra、马龙·丹尼尔斯、Starkselle、亚伦·布劳尔、LacesOut!、greebles、亚当·肖、Tee Gee、安东尼·里佐、塔雷克·赫尔米、M Postkasse、ASLPro3D、雅各布·霍勒尔、FinalyFree、Weasyl、蒂米、约翰尼、科里·帕扎、塔克、冈萨洛·安德烈·阿连德斯·洛佩斯、扎克·贡瑟、大红、whudunit、卢克·乔布、dl0901dm、菲利普·亨佩尔、corde、尼克·沃克、lh qwe、Bishoujoker、conner、aai、不列颠人海尔布鲁恩、托里、wildnut、亮眼睛公主、AbstractAss、费利佩·多斯桑托斯、ViperC、让·贾伦、亚历山大·武伊奇克、AM Kuro、马库斯、S Sang、卡尔P、Akira_HentAI、MagnaInsomnia、戈登·科尔、yuxz69、道格拉斯·加斯帕尔、AlexDuKaNa、乔治、andrew.tappan、dw、N/A、The Spawn、菲尔、graysock、Greenmoustache、zounic、fancypants、Digital、JaxMax、takyamtom、奚明 刘、Jwk0205、Bro Xie、준희 김、batblue、carey6409、Olive、太郎 ゲーム、某个叫巴里的家伙、马克斯·马克伦德、友博弘·巴巴、大卫·奥尔特加、AELOX、Nicfit23、Noora、wamekukyouzin、drum matthieu、Dogmaster、马特·温泽尔、Mattssn、Lex Song、约翰·保存为、克里斯托弗·米歇尔、塞尔日·贝肯坎普、吉米·莱德贝特、LeoZero、安东尼·蓬特斯、ApathyJones、nahinahi9、达斯汀·陈、dan、Yaboi、Mouthlessman、Steam Steam、达蒙·坎利夫、CryptoTraderJK、Davaitamin、御宅族fra、Ran C、tedcor、Fotek Design、亚当·泰勒、Weird_With_A_Beard、MadSpin、Pozadine1、Qarob、AIGooner、inbijiburu、Luc、ProtonPrince、DiffDuck、elu3199、尼克“Loadstone”D、Hasturkun、乔恩·沙曼、Ubivis、CloudValley、thesoftwaredruid、wundershark、mr_dinosaur、linnfrey、Gamalonia、Vir、Pkrsky、Joboshy、波西米亚下士、Dan、约瑟夫·兰兹尔、塞思·克里斯滕森、格里芬·达尔伯格、德拉文T、yer fey、Error_Rule34_Not_found、杰拉尔德·韦利、Roslynd、Geolog、jinxedx、Neco28、Aquatic Coffee、Dankin、ethanfel、克里斯蒂安·巴斯克斯、弗兰克·尼蒂、Magic Noob、Focuschannel、道格·彼得森、杰夫、布鲁斯、凯文·约翰·鸭、安东尼·法克斯兰德、凯文·克里斯托弗、Ouro Boros、Blackfish95、dd、保罗·克罗尔、MiraiKuriyamaSy、分号排水管、Thesharingbrother、Bas Imagineer、Pat Hen、约翰·斯塔森、ResidentDeviant、Nihongasuki、JC、Prompt Pirate、uwutismxd、诱饵、Tyrswood、Ray Wing、Ranzitho、Gus、地狱的禄、MJG、大卫·拉瓦莱、ae、Tr4shP4nda、WRL_SPR、capn、约瑟夫、米尔科·卡祖拉、dan、Piccio08、kumakichi、cppbel、starbugx、Moon Knight、몽타주、Kland、zenobeus、Jackthemind、ryoma、Stryker、raf8osz、ElitaSSJ4、blikkies、克里斯、布赖恩M、Nerezza、sanborondon、泰勒·放克、aezin、Thought2Form、jcay015、凯文·皮科、埃里克·洛佩斯、Shock Shockor、马特奥·库里奇、Goldwaters、Zude、Eris3D、m、皮尔斯·麦克布莱德、乔舒亚·格雷、凯勒、米科·海米拉、aRtFuL_DodGeR、杰米·奥格莱特里、a _、詹姆斯·科尔曼、CrimsonDX、Martial、battu、埃米尔·安德森、查德Idk、DarkSunset、比利·格拉德基、优治·金子、Probis、杜尚·里班、ItsGeneralButtNaked、乔丹·肖、Rops Alot、萨姆、sjon kreutz、Nimess、SRDB、Ace Ventura、g unit、Youguang、Metryman55、andrewzpong、FrxzenSnxw、BossGame、lrdchs、momokai、Hailshem、kudari、娜奥米·黑尔·丹奇、dc7431、ken、Inversity、AIVORY3D、epicgamer0020690、乔舒亚·波拉塔、keemun、SuBu、RedPIXel、Kevinj、Wind、Nexus、Ramneek“Guy”Ashok、squid_actually、Nat_20、爱德华·周、kyoumei、RadStorm04、JohnDoe42054、比利希尔、emyth、chriphost、KitKatM、socrasteeze、ResidentDeviant、gzmzmvp、Welkor、约翰·马丁、理查德、安德鲁、罗伯特·韦格蒙德、Littlehuggy、moranqianlong、格雷戈里·科热米亚克、mrjuan、布赖恩·布耶、Sadlip、春·约图、埃里克·惠特尼、乔伊·卡拉汉、伊万·塔迪奇、迈克·西蒙、Morgandel、凯隆·马汉、Matura Arbeit、诺亚、雅各布·麦克丹尼尔、X、斯隆·斯蒂迪、TBitz33、匿名dkjglfleeoeldldldlkf、Temikus、Artokun、迈克尔·泰勒、SendingRavens、德里克·贝克、迈克·安东尼·斯科特、阿提拉·贝尔克·佩克杜亚尔、迈克·多切蒂、内森、Decx 、保罗·哈茨尤克、elitassj、雅各布·温特、Distortik、大卫、Meilo、Pen Bouryoung、四糸凜音、shinonomeiro、Snille、马尔滕·阿尔伯斯、khanh duy、xybrightsummer、jreedatchison、PhilW、Tree Tagger、Janik、克罗克特、Cruel、MRBlack、米切尔·罗布森、Kiyoe、humptynutz、michael.isaza、Kalnei、Whitepinetrader、OrganicArtifact、斯科特、MudkipMedkitz、deanbrian、POPPIN、亚历克斯·沃特曼、科迪、Raku、smart.edge5178、emadsultan、InformedViewz、CHKeeho80、Bubbafett、leaf、Menard、Skyfire83、亚当·莱因哈特、D、Pitpe11、TheD1rtyD03、moonpetal、SomeDude、g9p0o、nanana、TheHolySheep、Monte Won、SpringBootisTrash、carsten、ikok、Buecyb99、4IXplr0r3r、dfklsjfkljslfjd、hayden、ahoystan、利兰·桑德斯、Wolfe7D1、Ink Temptation、鲍勃·巴克、edk、Kalli Core、Aeternyx、elleshar666、YOU SINWOO、ja s、道格·梅森、Kauffy、杰里米·汤森德、EpicElric、肖恩·沃茨、欧文·格沃兹德、约翰·J·莱恩汉、埃利奥特·E、托马斯·瓦纳、Theerat Jiramate、爱德华·肯尼迪、贾斯汀·布莱洛克、Devil Lude、尼克·卡格、凯文·斯托达德、杰克·多尔、Vane Holzer、psytrax、Ezokewn、hexxish、CptNeo、notedfakes、Maso、埃里克·凯彻姆、NICHOLAS BAXLEY、迈克·斯科特、凯文·华莱士、马修斯·库托、Saya、ChicRic、mercur、J C、Ed Wang、瑞安·普雷斯利·Ng、韦斯·西姆斯、Donor4115、伊夫·波泽瓦拉、Teriak47、就我一个人、拉夫·斯塔赫林、Вячеслав Маринин、Lyavph、菲利波·费拉里、可乐·马修、OniNoKen、伊恩·怀斯利、Zertens、NOHOW、Apo、nekotxt、choowkee、Clusters、ibrahim、Highlandrise、philcoraz、mztn、ImagineerNL、MrAcrtosSursus、al300680、pixl、Robin、chahknoir、马库斯·thronico、nd、keno94d、詹姆斯·梅尔策、巴特比、Renvertere、Rahuy、Hermann003、D、Foolish、RevyHiep、Captain_Swag、obkircher、gwyar、D、edgecase、Neoxena、mrmhalo、dg、马尔滕·哈姆斯、以色列、Muratoraccio、SelfishMedic、Ginnie、adderleighn、EnragedAntelope、艾伦+Cano、FeralOpticsAI、Pavlaki、generic404、马特乌什+科谢拉、道格+林托尔、Noor、Yorunai、Bula、quantenmecha、abattoirblues、杰森·纳什、比利男孩84、DarkRoast、zounik、letzte、Nasty+Hobbit、SgtFluffles、lrdchs2、Duk3+Rand0m、KUJYAKU、NathenChoi、托马斯+Reck、Larses、cocona、Coeur+de+cochon、大卫·申克、han b、Nico、香蕉乔、 G3n、多诺万·詹金斯、JBsuede、迈克·艾德、beersandbacon、马克西米利安·派科、Invis、贾斯汀·休斯顿、Time Valentine、james、OrochiNights、迈克·朱、ACTUALLY_the_Real_Willem_Dafoe、gonzalo、Seraphy、Михал Михалыч、雨の心 落、马特、AllTimeNoobie、jumpd、约翰C、Rim、Dismem、Frogmilk、SPJ、Xan Dionysus、内森·李、Mewtora、Middo、Forbidden Atelier、布莱恩·鲁特科夫斯基、Adictedtohumping、Towelie、赛勒斯·费特、让-弗朗索瓦·SEMA、库尔特、max blo、Xenon Xue、杰克·约翰尼·吉姆、爱德华·腾·艾克、蔡·权、Inyoshu、Goober719、查德·巴恩斯、詹姆斯·明、vanditking、kripitonga、Rizzi、nimin、OMAR LUCIANO、汉尼拔、Jo+Example、布伦特·伯特拉姆、eumelzocker、dxjaymz、L C、Dude

发行说明

v1.0.3

• 自定义配方存储路径 - 新增支持为配方配置自定义存储路径，并在更改位置时提供迁移支持，以移动现有配方数据。
• LM 文本/提示节点的通配符支持 - LM 文本节点和提示节点现在支持新的/wildcard命令，具备运行时通配符扩展功能，并支持动态提示语法，从而实现更灵活的提示构建。
• 系统诊断（“医生”） - 新增诊断功能，帮助更清晰地发现环境和设置问题。
• 用户状态备份支持 - 新增用户状态备份支持，配套UI以及在设置中更清晰的备份范围提示信息。
• 已下载状态可见性 - 新增更清晰的已下载状态用户体验，使之前下载过的模型版本更容易识别。
• 自动补全性能改进 - 修复了自动补全性能问题，以减少标签搜索开销并提高响应速度。

v1.0.2

• 模型下载历史追踪 - LoRA管理器现在会保存已下载模型版本的历史记录，即使该版本当前不在您的库中，也能识别是否曾经下载过。
• 跳过已下载过的模型版本 - 新增设置“跳过已下载过的模型版本”，帮助避免重复下载您过去已经下载过的模型版本。
• LoRA堆栈组合节点触发词修复 - 修复了一个问题：来自LORA_STACK输入的触发词更新无法正确传播到LoRA堆栈组合节点。
• CivitAI示例图片兼容性 - 改进了对CivitAI CDN子域名的支持，使示例图片加载更加可靠。

v1.0.1

• 批量导入配方 - 可同时从多个URL或目录导入配方，并优化并发处理。
• 批量下载缺失的LoRA - 配方新增批量操作：选择多个配方后，可一次性下载所有选定配方中缺失的LoRA。
• 仅导入配方选项 - 只保存配方元数据而不下载缺失的LoRA，方便您先保存感兴趣的配方，待需要时再下载依赖项。
• 可编辑配方提示 - 直接在配方详情模态框中编辑配方提示。
• 检查点加载LM节点 - 行为与ComfyUI内置的加载检查点节点相同，额外增加了从额外文件夹路径加载检查点的功能。
• UNET加载LM节点 - 行为与ComfyUI内置的加载扩散模型节点相同，支持从额外文件夹路径和GGUF格式加载（需使用ComfyUI-GGUF自定义节点）。
• LoRA堆栈组合节点 - 将两个LoRA堆栈合并为一个。例如：分别使用随机化器处理角色和风格的LoRA，然后再合并应用。
• LoRA池正则过滤 - 使用自定义的包含/排除规则正则表达式来筛选进入池中的LoRA。
• 基础模型类型动态获取 - 基础模型类型现在会从Civitai API动态获取，确保与最新可用模型保持同步。
• 提示自动补全增强 - 支持Tab键确认、可配置行为，并改进了多词标签匹配功能。
• 基础模型下载排除 - 当您只想下载特定类型的模型时，可以将某些基础模型排除在下载之外。
• 成人内容模糊阈值设置 - 可配置成人内容预览的模糊级别（PG13 / R / X / XXX，默认为R+）。
• 实验性：Nunchaku Qwen LoRA支持 - 实验性支持加载并应用于Nunchaku量化的Qwen-Image模型的LoRA。
• Bug修复与UX改进 - 各种修复使工作流程更加顺畅。

v1.0.0

• 额外文件夹路径支持 - 新增支持LoRA管理器专用的额外模型根路径。这允许从ComfyUI标准文件夹之外的其他位置加载LoRA，有助于避免在处理大型模型库时出现性能问题。
• 设置界面全面改版 - 重新设计了设置界面，布局更加整洁，便于查找和配置应用设置。
• 惰性哈希计算 - 对大型模型文件（检查点和扩散模型）实现了惰性哈希计算。哈希值仅在必要时才会计算，从而最大限度地减少冗余磁盘I/O，并显著加快应用初始化速度。
• 里程碑与支持者表彰 - 更新了支持者窗口，在达到v1.0.0里程碑之际，向所有项目支持者表示感谢。非常感谢社区一直以来的支持！
• Bug修复与UX提升 - 各种Bug修复和用户体验改进，使工作流程更加流畅。

v0.9.16

• 重复检测增强 - 模型重复模式现在会尊重筛选器配置，使得在特定筛选结果中更容易找到重复组。
• 标签逻辑切换 - 在筛选面板中新增OR/AND切换开关，用于包含标签筛选，提供更灵活的基于标签的模型搜索功能。
• 元数据刷新跳过路径 - 新增设置，可将特定路径排除在元数据刷新操作之外。当从远程源获取元数据时，这些路径下的模型将被跳过。
• 提示节点中的动态触发词 - 提示节点现在支持动态数量的触发词输入，以获得更大的灵活性。
• 抢先体验更新 - 模型更新现在会显示抢先体验信息，并新增设置以忽略抢先体验更新（如需）。
• LM Civitai扩展集成 - 新增与LM Civitai扩展的集成。点击模型更新中的下载按钮后，下载任务将发送至该扩展的下载队列，实现无缝的一键下载。

v0.9.15

• 筛选器预设 - 可将筛选组合保存为预设，以便快速切换和重新应用。
• Bug修复 - 修复了各种Bug，提升了稳定性。

v0.9.14

• LoRA循环节点 - 引入了新的LoRA循环节点，可在指定的LoRA之间进行迭代循环，并支持重复次数和暂停迭代功能。具体示例请参考新的“Lora Cycler”模板工作流。
• 增强型提示节点与标签自动补全 - 提升了提示节点的功能，基于Danbooru + e621标签的合并数据提供了全面的标签自动补全。支持标签搜索和自动补全功能。实现了命令系统，例如使用/character或/artist等快捷指令进行特定类别的标签搜索。新增/ac或/noac命令，可快速启用或禁用自动补全功能。详细技巧请参阅ComfyUI -> 模板 -> ComfyUI-Lora-Manager中的“Lora Manager Basic”模板工作流。
• Bug修复与稳定性提升 - 解决了多个Bug，并提高了整体稳定性。

v0.9.12

• LoRA 随机化系统 - 引入了全面的 LoRA 随机化系统，包含 LoRA 池和 LoRA 随机化节点，用于灵活且动态的生成工作流。
• LoRA 随机化模板 - 请参考新的“LoRA 随机化”模板工作流，了解灵活随机化模式、锁定与复用选项等详细示例。
• 配方文件夹 - 在配方页面引入了文件夹系统，用户可以像管理模型一样自由地组织配方。
• 配方批量操作 - 新增批量模式支持，可通过直观的控件（如点击拖拽选择、拖拽到文件夹、Ctrl+A 全选）对选定的配方进行批量移动、删除和设置基础模型。
• 提示词搜索与排序 - 可按提示词内容搜索配方，并按配方名称、导入日期或 LoRA 数量排序，以提升浏览体验。
• 配方收藏 - 将特定配方标记为收藏，方便快速访问。
• 视频配方支持 - 支持视频配方（可通过 LM 扩展或 URL 导入；不支持直接导入视频文件）。
• 性能优化 - 修复了性能问题，显著提升了启动和加载速度。首次扫描后，无论收藏规模如何，后续加载都将即时完成。
• ComfyUI 节点 2.0 支持 - 基本支持 ComfyUI 节点 2.0。

v0.9.10

• 更智能的更新匹配 - 用户现在可以选择仅按基础模型匹配或不限制基础模型来检查和分组更新；版本列表还支持在同基础版本与所有版本之间切换。
• 灵活的标签筛选 - 筛选面板现支持标签排除功能：单击标签可包含，再次单击则排除，第三次单击则清空，从而实现更强、更灵活的标签筛选。
• 许可证可见性与控制 - 模型详情页头部及 ComfyUI 预览弹窗现显示 Civitai 许可证图标。筛选面板新增许可证包含/排除选项，同时推出全新全局上下文菜单操作“刷新许可证元数据”，用于获取缺失的许可证信息。
• 配方改进 - 配方现允许导入时不含任何 LoRA，且配方详情页会显示相关检查点，便于参考。
• 更好的 ZIP 下载 - 下载打包为 ZIP 的模型时，模型文件将被解压至目标模型文件夹；包含多个模型文件的 ZIP（例如 WanVideo 的高低 LoRA 对）将作为独立模型添加。
• 模板工作流更新 - 更新了“卓越小马示例”模板工作流，并为每个 LoRA Manager 节点提供了使用指南。
• Bug 修复与稳定性提升 - 进行了常规修复并提升了稳定性。

v0.9.9

• 检查更新功能 - 用户现在可在批量模式下检查所有模型或选定模型的更新。有可用更新的模型将在其模型卡片上显示“有更新”徽章，用户还可筛选仅显示有更新的模型。
• 模型版本管理 - 在模型模态窗口中新增“版本”选项卡，集中管理模型的所有版本，提供下载、删除和忽略更新等功能。
• 将检查点发送至 ComfyUI - 用户现在可点击检查点卡片上的发送按钮，直接将检查点发送至 ComfyUI 当前工作流中的检查点或扩散模型加载节点。
• 自定义模型卡片显示 - 新增设置，允许用户选择在模型卡片上显示模型名称还是文件名。
• 新路径模板占位符 - 新增 {model_name} 和 {version_name} 路径模板占位符，以实现更灵活的文件组织。
• ComfyUI 自动路径修正设置 - 在 ComfyUI 中新增设置，用于启用或禁用自动路径修正功能。

v0.9.8

• CivArchive API 完全支持 - 新增对 CivArchive API 的完整支持，作为 Civitai API 之外的备用元数据来源。即使模型已从 Civitai 删除，仍可通过 CivArchive API 获取元数据。
• 从 CivArchive 下载模型 - 新增直接从 CivArchive 下载模型的功能，类似于从 Civitai 下载。只需点击“下载”按钮并粘贴模型 URL 即可下载相应模型。
• 自定义优先级标签 - 引入自定义优先级标签功能，允许用户定义自定义优先级标签。这些标签将在编辑标签时或使用默认路径进行自动整理/下载时作为建议显示，从而实现更精准、更可控的文件夹组织。指南
• 标签拖放重排 - 在标签编辑模式中新增拖放功能，以便更便捷地重新排列标签。
• 示例图片面板中的下载控制 - 在“下载示例图片”面板中新增停止控制，以更好地管理下载。
• 带自动补全的 Prompt (LoraManager) 节点 - 新增带有自动补全功能的 Prompt (LoraManager) 节点，用于添加嵌入向量。
• 子图中的 Lora Manager 节点 - Lora Manager 节点现支持放置于子图中，以实现更灵活的工作流组织。

v0.9.6

• 元数据归档数据库支持 - 新增下载和使用元数据归档数据库的功能，使用户能够访问已从 CivitAI 删除的模型的元数据。
• 应用级代理设置 - 引入了在应用程序内配置全局代理的支持，便于在网络限制环境下使用该管理器。
• Bug 修复 - 修复了多项 bug，以提升稳定性和可靠性。

v0.9.2

• 批量自动整理功能 - 新增批量自动整理功能。现在您可以选择多个模型，并根据当前的路径模板设置自动整理它们，从而实现更高效的管理。
• Bug 修复 - 修复了若干 bug，以提升稳定性和可靠性。

v0.9.1

• 增强的批量操作 - 改进了批量操作功能，新增套索选择和批量操作上下文菜单，提供更直观、类似桌面应用的用户体验。
• 新增批量操作 - 新增批量为多个模型添加标签和设置基础模型的功能。

v0.9.0

• UI 全面升级，提升导航体验 - 将顶部的扁平文件夹标签替换为全新的文件夹侧边栏和面包屑导航系统，使文件夹浏览与选择更加直观便捷。
• 双模式文件夹侧边栏 - 新增的文件夹侧边栏提供两种显示模式：“列表模式”模拟经典文件夹视图，“树状模式”则以层级结构呈现文件夹，方便用户轻松浏览嵌套目录。
• 国际化支持 - 引入多语言支持，现已支持英语、简体中文、繁体中文、西班牙语、日语、韩语、法语、俄语和德语。欢迎母语人士反馈，帮助优化翻译质量。
• 自动文件名冲突解决 - 实现文件自动重命名功能（原名 + 短哈希值），避免下载或移动模型时出现文件名冲突。
• 性能优化与错误修复 - 进行了多项性能改进和错误修复，确保应用运行更稳定、响应更迅速。

查看更新历史

---

⚠ 重要提示：要使用 CivitAI 下载功能，您需要：

1. 在您的个人资料设置中获取 CivitAI API 密钥。
2. 将其添加到 LoRA 管理器的设置页面。
3. 保存设置。

---

核心功能

• 🚀 高性能

  • 快速加载和浏览模型
  • 大型收藏集也能流畅滚动

• 🌐 丰富的模型集成

  • 直接从 CivitAI 下载
  • 支持预览图片和视频
  • 显示模型描述及版本选择
  • 一目了然地查看触发词
  • 一键将预设值整合到工作流中

• 🔄 检查点管理

  • 扫描并整理检查点模型
  • 对收藏进行筛选和搜索
  • 查看和编辑元数据
  • 清理磁盘空间，高效管理存储

• 🧩 LoRA 配方

  • 保存并分享喜爱的 LoRA 组合
  • 记录生成参数以便日后参考
  • 快速应用于工作流
  • 支持导入导出功能，便于社区共享

• 💻 用户友好

  • 可通过 ComfyUI 菜单一键访问
  • 提供上下文菜单，快速执行操作
  • 支持自定义备注和使用提示
  • 多文件夹支持
  • 可配置成人内容模糊阈值（PG13 / R / X / XXX，默认为 R+）
    • 例如：将阈值设置为 PG13 时，在启用模糊功能的情况下，PG13、R、X 和 XXX 的预览都会被模糊处理
  • 初始化过程中提供可视化进度指示

---

安装方法

方法一：ComfyUI 管理器（推荐给 ComfyUI 用户）

1. 打开 ComfyUI。
2. 进入 管理器 > 自定义节点管理器。
3. 搜索 lora-manager。
4. 点击 安装。

方法二：便携式独立版（无需 ComfyUI）

1. 下载 便携式压缩包。
2. 将提供的 settings.json.example 文件复制一份，重命名为 settings.json，放置于 comfyui-lora-manager 文件夹中。
3. 编辑新创建的 settings.json 文件，填入正确的模型文件夹路径和 CivitAI API 密钥。
   • 如果希望配置信息保留在仓库文件夹内而非用户设置目录，请将 "use_portable_settings": true 设置为真。
4. 运行 run.bat。
   • 如需更改启动端口，可编辑 run.bat 并修改参数（如 --port 9001）。

方法三：手动安装

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

使用说明

1. 您可以通过两种方式访问 LoRA 管理器：
   • 点击 ComfyUI 菜单中的“启动 LoRA 管理器”按钮。
   • 直接访问 http://localhost:8188/loras。
2. 在界面中，您可以：
   • 浏览并整理您的 LoRA 模型。
   • 直接从 CivitAI 下载模型。
   • 自动获取或手动设置预览图片。
   • 查看并复制每个 LoRA 对应的触发词。
   • 添加个人备注和使用建议。
3. 若要在工作流中使用 LoRA：
   • 将“Lora 加载器 (LoraManager)”节点添加到您的工作流中。
   • 在管理器界面中选择一个 LoRA。
   • 点击“复制”按钮或右键菜单中的“复制 LoRA 语法”选项。
   • 将内容粘贴到 Lora 加载器节点的文本输入框中。
   • 该节点会自动应用预设强度和触发词。

TextLM / PromptLM 中的通配符功能

Text (LoraManager) 和 Prompt (LoraManager) 支持 /wildcard 自动补全以及运行时通配符扩展。

• 通配符文件存放在 {settings 文件夹}/wildcards/ 目录下。
• 当您输入 /wildcard 且尚未创建任何通配符文件时，自动补全下拉菜单会显示确切的文件夹路径，并允许您直接打开该文件夹。
• 支持的格式：.txt、.yaml、.yml、.json。

格式规则：

• wildcards/animals/cat.txt 将变为 __animals/cat__。
• .txt 文件每行仅包含一个选项。
• YAML / JSON 文件使用嵌套键，最终键值为字符串数组。

示例：

# wildcards/color.txt
red
blue
green

使用时写作 __color__。

# wildcards/colors.yaml
palette:
  warm:
    - red
    - orange

使用时写作 __palette/warm__。

Save Image 节点的文件名格式模板

Save Image 节点支持使用模式代码动态生成文件名。您可以按照以下格式模板自定义图像的命名方式：

可用的模式代码

• %seed% - 插入生成种子编号。
• %width% - 插入图像宽度。
• %height% - 插入图像高度。
• %pprompt:N% - 插入正面提示词（限制 N 个字符）。
• %nprompt:N% - 插入负面提示词（限制 N 个字符）。
• %model:N% - 插入模型/检查点名称（限制 N 个字符）。
• %date% - 插入当前日期时间，格式为“yyyyMMddhhmmss”。
• %date:FORMAT% - 插入自定义格式的日期，其中：
  • yyyy 表示 4 位年份。
  • yy 表示 2 位年份。
  • MM 表示 2 位月份。
  • dd 表示 2 位日期。
  • hh 表示 2 位小时。
  • mm 表示 2 位分钟。
  • ss 表示 2 位秒。

示例

• image_%seed% → image_1234567890
• gen_%width%x%height% → gen_512x768
• %model:10%_%seed% → dreamshape_1234567890
• %date:yyyy-MM-dd% → 2025-04-28
• %pprompt:20%_%seed% → beautiful landscape_1234567890
• %model%_%date:yyMMdd%_%seed% → dreamshaper_v8_250428_1234567890

您可以组合多种模式，为生成的图像创建详细且条理清晰的文件名。

独立模式

现在您可以将 LoRA Manager 从 ComfyUI 中独立运行：

1. 对于 ComfyUI 用户：

   • 至少启动一次带有 LoRA Manager 的 ComfyUI，以便在用户设置文件夹中的 settings.json 文件中初始化必要的路径信息（参见上述路径）。
   • 确保已安装依赖项：pip install -r requirements.txt
   • 从您的 ComfyUI 根目录运行：

     python custom_nodes\comfyui-lora-manager\standalone.py
     

   • 您可以通过以下地址访问界面：http://localhost:8188/loras
   • 您也可以通过参数指定不同的主机或端口：

     python custom_nodes\comfyui-lora-manager\standalone.py --host 127.0.0.1 --port 9000
     

2. 对于非 ComfyUI 用户：

   • 复制提供的 settings.json.example 文件，创建一个名为 settings.json 的新文件。仅需更新 API 密钥、可选语言和文件夹路径——库注册表将在 LoRA Manager 启动时自动创建。
   • 编辑 settings.json，填入正确的模型文件夹路径和 CivitAI API 密钥（您可以在准备好配置之前保留默认值）。
   • 如果您希望 LoRA Manager 读写项目目录下的 settings.json 文件，可以启用便携模式，将 "use_portable_settings": true 设置为真。
   • 安装所需依赖项：pip install -r requirements.txt
   • 运行独立模式：

     python standalone.py
     

   • 您可以通过浏览器访问界面：http://localhost:8188/loras

   注意：首次启动此版本时，现有安装会自动将旧版 settings.json 从插件文件夹迁移到用户设置目录。

此独立模式提供了一种轻量级的选项，用于管理您的模型和配方集合，而无需运行完整的 ComfyUI 环境，因此即使主要使用其他稳定扩散界面的用户也会觉得它非常有用。

测试与覆盖率

后端

安装开发依赖项，并运行带有覆盖率报告的 pytest：

pip install -r requirements-dev.txt
COVERAGE_FILE=coverage/backend/.coverage pytest \
  --cov=py \
  --cov=standalone \
  --cov-report=term-missing \
  --cov-report=html:coverage/backend/html \
  --cov-report=xml:coverage/backend/coverage.xml \
  --cov-report=json:coverage/backend/coverage.json

HTML、XML 和 JSON 报告文件将存储在 coverage/backend/ 目录下，方便您在本地或通过 CI 工作流检查代码热点。

前端

运行 Vitest 覆盖率测试套件，以分析组件热点：

npm run test:coverage

---

文档

• metadata.json 模式文档 — .metadata.json 附带文件格式的完整参考，包括所有字段、类型及 LoRA、检查点和嵌入模型的示例。

---

贡献

感谢您对参与 ComfyUI LoRA Manager 开发的兴趣！由于该项目目前仍处于早期阶段，正处于快速开发和重构之中，我们暂时不接受拉取请求。

不过，您的反馈和想法对我们来说极其重要：

• 如发现任何问题，请随时提交问题
• 通过 GitHub 问题提出功能需求
• 分享您的改进建议

我们感谢您的理解，并期待在项目架构稳定后能够接受代码贡献。

---

致谢

本项目受到其他优秀 ComfyUI 扩展的启发，并从中受益：

• ComfyUI-QwenImageLoraLoader — 提供实验性的 Nunchaku Qwen-Image LoRA 支持
• ComfyUI-SaveImageWithMetaData — 提供图像元数据功能
• rgthree-comfy — 提供 LoRA 加载功能

---

☕ 支持

如果您觉得本项目有所帮助，请考虑支持其开发：

微信：点击查看二维码

💬 社区

加入我们的 Discord 社区，获取支持、参与讨论并了解最新动态： Discord 服务器

---

星标历史

ComfyUI LoRA Manager 快速上手指南

ComfyUI LoRA Manager 是一款专为 ComfyUI 设计的强大工具，旨在简化 LoRA 模型的组织、下载和应用流程。它提供食谱管理、检查点整理以及一键工作流集成等功能，让模型管理工作更加高效流畅。

环境准备

在开始之前，请确保满足以下系统要求：

• 操作系统: Windows, macOS 或 Linux
• 核心依赖:
  • 已安装并配置好 ComfyUI (建议最新版本)
  • Python 3.10+ (与 ComfyUI 环境一致)
  • Git (用于克隆插件仓库)
• 网络环境: 能够访问 GitHub 和 Civitai (若需下载模型)。国内用户若连接缓慢，建议配置全局代理或使用加速工具。

安装步骤

本工具作为 ComfyUI 的自定义节点插件安装。推荐使用 ComfyUI Manager 进行安装，也可手动安装。

方法一：通过 ComfyUI Manager 安装（推荐）

1. 启动 ComfyUI，点击右侧菜单中的 Manager 按钮。
2. 选择 Install Custom Nodes。
3. 在搜索框中输入 LoRA Manager 或 ComfyUI-Lora-Manager。
4. 找到由 willmiao 开发的插件，点击 Install。
5. 安装完成后，重启 ComfyUI 以生效。

方法二：手动安装

如果未安装 Manager，可通过命令行手动安装：

1. 进入 ComfyUI 的自定义节点目录：

   cd path/to/ComfyUI/custom_nodes
   

   (请将 path/to/ComfyUI 替换为你实际的 ComfyUI 安装路径)

2. 克隆仓库：

   git clone https://github.com/willmiao/ComfyUI-Lora-Manager.git
   

   国内加速提示: 若克隆速度慢，可使用镜像源： git clone https://ghp.ci/https://github.com/willmiao/ComfyUI-Lora-Manager.git

3. 安装依赖（通常 ComfyUI 启动时会自动处理，若报错可手动执行）：

   cd ComfyUI-Lora-Manager
   pip install -r requirements.txt
   

4. 重启 ComfyUI。

基本使用

安装并重启后，你可以通过以下方式开始使用：

1. 访问管理界面

启动 ComfyUI 后，在浏览器中打开以下地址即可进入 LoRA Manager 专属界面：

http://localhost:8188/loras

(如果你的 ComfyUI 运行在其他端口，请相应修改端口号)

2. 浏览与管理模型

• 模型列表: 界面将自动扫描并展示本地 models/loras 目录下的所有 LoRA 模型。
• 一键下载: 配合浏览器扩展（见下文），可直接从 Civitai 页面点击下载按钮，模型将自动保存至正确目录。
• 食谱管理: 在界面中查看模型的生成参数（Recipe），支持一键应用到当前工作流。

3. 一键工作流集成

这是该工具的核心功能之一：

1. 在 LoRA Manager 网页界面中找到想要的模型。
2. 点击 Integrate 或类似的一键添加按钮。
3. 返回 ComfyUI 主界面，你会发现对应的 Load LoRA 节点已自动添加到工作流中，并预填了模型路径和参数，无需手动拖拽和配置。

4. (可选) 安装浏览器扩展

为了获得最佳的“一键下载”体验，建议安装配套的浏览器扩展：

• Chrome/Edge: Chrome Web Store 链接
• Firefox: Firefox 扩展下载

安装扩展后，访问 Civitai 模型页时，你会看到额外的状态指示（是否已下载）和快速下载按钮。