SD助手｜Civitai Helper自动获取模型封面插件

特征

• 扫描所有模型，从Civitai下载模型信息和预览图
• 通过civitai模型页面url，连接本地模型和civitai模型信息
• 通过Civitai模型页面url，下载模型(含信息和预览图)到SD目录或子目录。
• 下载支持断点续传
• 批量检查本地模型，在civitai上的新版本
• 直接下载新版本模型到SD模型目录内(含信息和预览图)
• 修改了内置的”Extra Network”模型卡片，每个卡片增加了如下功能按钮:
  • 🖼: 修改文字”replace preview”为这个图标
  • 🌐: 在新标签页打开这个模型的Civitai页面
  • 💡: 一键添加这个模型的触发词到关键词输入框
  • 🏷: 一键使用这个模型预览图所使用的关键词
• 以上额外功能按钮支持thumbnail模式
• 增加一直显示按钮的选项，以供触屏用户使用

⚠️注意：该插件目前名称为Civitai Helper2，以后将会更名为Model Info Helper。

简介

常规的加载LoRA模型的方式如下图所示：

有些朋友在下载很多LoRA之后，很难通过名称直观的定位自己所需要的模型，因为这些都没有缩略图。

最近有一个SD的扩展插件比较火，那就是Civitai Helper，它可以自动下载LoRA相应模型的缩略图等信息，使你更加方便找到自己所需要的模型。

插件下载

目前SD官方还未集成至插件内，因为该插件目前需要前往Civitai站自行下载，并没有在GitHUB找到相关地址。

官方下载

GitHUB下载：butaixianran/Stable-Diffusion-Webui-Civitai-Helper

Civitai下载：Civitai Helper: SD Webui Civitai Extension

网盘下载

为方便不能连外网的用户，本站已提供最新版本的下载地址，可前往国内网盘自行下载。以后官方更新插件版本，本站也会将新版本插件上传至该目录内。

安装教程

在我们下载好插件的安装压缩包之后，将其解压，此时将会得到一个文件夹，我们双击进入该文件夹，将会看到一个名为Stable-Diffusion-Webui-Civitai-Helper的文件夹，移动该文件夹至.\stable-diffusion-webui\extensions目录下，然后重启Stable Diffusion服务即可在主界面看到Civitai助手选项卡。

插件目录结构如下，不要放错位置，不然插件不会被正常加载和显示出来。

D:\openai.wiki\stable-diffusion-webui\extensions\Stable-Diffusion-Webui-Civitai-Helper
└─.github
└─icon
└─img
└─javascript
└─scripts
└─.gitignore
└─claim_wall.md
└─README.cn.md
└─README.md
└─style.css

使用教程

使用教程就非常简单啦，我们直接点击Civitai助手选项卡即可，此时我们将会看到如下界面。

我们无需任何设置，直接点击扫描按钮就会扫描所有模型，生成SHA256码，用于从civitai获取模型信息和预览图。扫描需要很久，耐心等待。

（如果模型信息文件已经存在，扫描时就会跳过这个模型。如果模型不是civitai的，就会创建个空信息文件，以避免以后重复扫描。）

每个模型，本扩展都会创建一个json文件，用来保存从civitai得到的模型信息。这个文件会保存在模型同目录下，名称为模型名字.civitai.info。

等待片刻之后，该界面无任何加载提示了，就代表我们已经下载好了所有LoRA的封面。

而且其实不止LoRA，就连Checkpoints的模型封面也会自动下载。

我们此时切换回文生图选项卡，然后进入LoRA模型的加载界面，点击刷新按钮之后，我们就可以看到所有LoRA模型的封面都被正确加载啦。

添加新模型

当你下载了新模型之后，只要再次点击扫描按钮即可。已经扫描过的文件不会重复扫描，会自动得到新模型的信息和预览图。无须重启SD webui。

模型卡片

(先完成扫描，再使用卡片功能)

打开SD webui’s 内置的 “Extra Network” 页面，显示模型卡片。

移动鼠标到模型卡片底部，就会显示4个按钮：

• 🖼: 修改文字”replace preview”为这个图标
• 🌐: 在新标签页打开这个模型的Civitai页面
• 💡: 一键添加这个模型的触发词到关键词输入框
• 🏷: 一键使用这个模型预览图所使用的关键词

如果你没有看到这些额外的按钮，只要点击Refresh Civitai Helper，他们就会被重新添加到卡片上。

每次当Extra Network刷新，他都会删除掉额外的修改，我们的按钮就会消失。这时你就需要点击Refresh Civitai Helper把这些功能添加回去。

小图模式

以上功能按钮支持小图模式，但受制于SD Webui的CSS问题，目前，只能要么一直显示，要么一直不显示，不能鼠标滑过才显示。

下载

(单任务，下载完一个再下另一个)

通过Civitai模型页面Url下载模型，要3个步骤：

• 填入url，点击按钮获取模型信息
• 扩展会自动填入模型名称和类型，你需要选择下载的子目录和模型版本。
• 点击下载

下载过程会显示在命令行界面带个进度条。

支持断点续传，无畏大文件。

批量检查模型新版本

你可以按照模型类型，批量检查你的本地模型，在civitai上的新版本。你可以选择多个模型类型。

检查新版本的时候，每检查完一个模型，都会有一个1秒的延迟，所以速度有点慢。

这是为了保护Civitai避免因为本插件而短暂陷入类似DDos的局面。有些云服务商，有类似“免费用户每秒API请求不能超过1次”的保护机制。Civitai还没有这种设置。但我们还是得自觉保护它。因为如果它挂了，对大家都没有好处。

检查完毕之后，就会如下图，在UI上显示所有找到的新版本的信息。

每个模型新版本，都有3个链接。

• 第一个是这个模型的网页。
• 第二个是这个新版本的下载地址。
• 第三个是个按钮，在python端，直接下载新版本到模型目录内。这种方式下载，下载详情显示在”Download Model”的区域和命令行窗口中。一次一个任务，不支持多任务。

根据URL获取模型信息

如果无法在civitai上找到你的模型的SHA256，但你还是希望能把你的模型连接到一个civitai模型，你可以在本扩展页面，从列表中选择你的模型，并提供一个civitai模型页面的url。

点击按钮之后，扩展就会下载那个civitai模型的信息，作为你这个本地模型的信息使用。

其他设置

保存设置按钮, 会保存扫描模型区域，以及其他设置 这两个区域的选项

• “一直显示按钮” 是为了方便触屏。
• “小图模式显示功能按钮” 会开关功能按钮在小图模式的显示

预览图

Extra Network支持两种预览图命名：model_name.png 和 model_name.preview.png。其中，model_name.png优先级较高。

当优先级较高的预览图不存在，他就会自动使用model_name.preview.png。

这样，你自己创建的预览图 和 网络下载的预览图，能够同时存在，并优先使用你自己创建的。

关键词

卡片上，添加关键词按钮，是添加从civitai预览图中得到的关键词，而不是你自己创建的图片的关键词。

civitai不是每个图片都有关键词，一个模型中，也不是所有预览图关键词都一样。所以这里是遍历所有civitai预览图信息，加载第一个有关键词的。

SHA256

为了创建文件的SHA256，插件需要读取整个文件。对于大尺寸文件，就会很慢。

有两种情况，这个SHA256无法从civitai找到对应模型：

• 太老的模型，civitai没有存储SHA256.
• 模型作者，静静的换掉了模型文件，但没有修改描述和版本。所以，虽然网页上看不出来，但实际上civitai上的 和你本地的模型文件，已经不是同一个文件了。

这些情况下，你可以在插件上，通过提供模型页面的url，来获取模型信息文件。

新特性

从v1.5开始，v1.x不再接受任何新特性。所有新特性进入2.x。

2.x专注于自定义模型信息，并可能改名为”Model Info Helper”。因为不再是专注Civitai了。

从v1.5开始。v1.x进入维护阶段。

Enjoy!

常见问题

4个卡片按钮不显示

汉化原因

下载新版，最新版已经处理汉化导致的问题。双语汉化插件需要v1.6.1.1之后的版本才开始支持。

使用了云端汉化功能

如果是秋叶启动器，就关闭启动器“云端汉化”功能。如果是专门的云端汉化插件，就换用普通汉化插件。

其他情况

首先，确保你点过了”Refresh Civitai Helper”刷新按钮。

然后，如果还有这个问题，那么唯一原因，是你没有使用最新版SD webui。

如果你修改过SD webui的文件， 你的更新操作可能会失败。你需要检查git命令行的输出信息，来确定你更新成功了。

git在很多时候，会拒绝升级，并告诉你有些冲突需要你手动先解决。如果你不看命令行输出，你就会以为你已经更新成功了，但其实并没有。

Request model info from civitai

意思就是正在连接civitai，如果没有后面的信息，就是连不上，请使用魔法。

扫描或获取模型信息失败

这个插件现在很稳定，所以，这个问题的原因，基本是是因为Civitai拒绝了你的连接请求。

Civitai不像那些大网站那么稳定。他网站会挂，会拒绝API连接，还会把API请求转到真人验证页面，来挡住。

Civitai还有连接池的设定。基本上，就是同时能允许的最大连接数。一旦达到这个数字，接下来的API连接请求，都会被拒绝。

所以，这种时候你只能等一下再试。

另外，对于国内用户，还有魔法问题。现在国内都要用魔法才能连上。

扫描之后得到了错误的预览图和模型信息

坏消息是，有些模型在civitai数据库中，保存的sha256完全是错的。

对于这种模型，那这个插件自然就无法获得正确的模型信息和预览图。

这种情况下，请删除扫描得到的模型信息和预览图，在插件界面提供正确的模型url来获取。

另外，civitai官方有个页面，专门用于回报带有错误sha256的模型：

https://discord.com/channels/1037799583784370196/1096271712959615100/1096271712959615100

请把这类模型反馈给civitai，好让他们进行修复。

使用colab时扫描失败

首先，在google中搜索你看到的错误信息。更有可能是，你碰到的是个colab的问题。

然后，如果colab连接了google drive，会有一次性访问文件数量的限制，而导致扫描失败。这是google drive的限制，请自行google搜索了解详情。

更多教程

Stable Diffusion｜全方位教程指南