Civitai助手：Stable-Diffusion-Webui-Civitai-Helper

原链接：Butaixianran/Stable-Diffusion-Webui-Civitai-Helper：Civitai的Stable Diffusion Webui扩展，可以更轻松地管理您的模型。 (github.com)

以下内容直接复制github：

关于奇维塔助手2：模型信息助手

Civitai Helper 2 将重命名为 ModelInfo Helper。它正在开发中，您可以观看其UI演示视频，看看它将是什么样子：
YouTube

通知

这个扩展现在非常稳定，对许多人来说效果很好。如果遇到问题，请检查控制台日志窗口的详细信息并阅读常见问题部分

如果您想声明它不起作用，请先检查以下内容：声明墙

奇维塔伊助手

Civitai的稳定扩散Webui扩展，可以更轻松地处理您的模型。

Civitai： Civitai url

特征

• 扫描所有模型以从Civitai下载模型信息并预览图像。
• 通过civitai模型的URL将本地模型链接到civitai模型
• 通过Civitai Url将模型（带有信息+预览）下载到SD的模型文件夹或子文件夹中。
• 下载可以在断点处恢复，这对于大文件很有用。
• 从奇维塔检查所有本地模型的新版本
• 将新版本直接下载到 SD 模型文件夹中（带有信息+预览）
• 修改了内置“额外网络”卡，以在每张卡上添加以下按钮：
  • 🖼️：将“替换预览”文本修改为此图标
  • 🌐：在新标签页中打开此模型的奇维塔网址
  • 💡：将此模型的触发词添加到提示
  • 🏷️：使用此模型的预览图像提示
• 以上按钮支持额外网络的缩略图模式
• 始终显示其他按钮的选项，以使用触摸屏。

安装

转到SD webui的扩展选项卡，转到子选项卡。 将此项目的 url 复制到其中，单击“安装”。Install from url

或者，将此项目下载为 zip 文件，然后将其解压缩到 .Your SD webui folder/extensions

每次安装或更新此扩展时，都需要关闭SD Webui并重新启动它。仅“重新加载UI”不适用于此扩展。

做。

如何使用

更新您的 SD 网站

此扩展需要获取额外的网络卡 ID。自 2023-02-06 以来添加。
如果您的SD webui是早期版本，则需要更新它！

扫描模型

转到扩展选项卡“奇维塔伊助手”。有一个名为“扫描模型”的按钮。

单击它，扩展程序将扫描您的所有模型以生成 SHA256 哈希，使用它们从 Civitai 检索模型信息并预览图像。

扫描需要时间，只需等待完成即可

对于每个模型，它将创建一个json文件来保存Civitai的所有模型信息。此模型信息文件将在模型文件夹中为“Your_model_name.civitai.info”。

如果模型信息文件已存在，则将跳过该文件。如果在Civitai中找不到模型，它将创建一个空的模型信息文件，因此模型不会被扫描两次。

添加新模型

当您有一些新模型时，只需再次单击扫描按钮，即可获取新模型的信息并预览图像。它不会扫描同一模型两次。

模型卡

（仅在扫描完成后使用）
打开SD webui的内置“额外网络”选项卡，以显示模型卡。

将鼠标移到模型卡的底部。它将显示 4 个图标按钮：

• 🖼：替换预览（内置按钮，从文本修改为图标）
• 🌐：在新标签页中打开此模型的奇维塔网址
• 💡：将此模型的触发词添加到提示
• 🏷：使用此模型的预览图像提示

如果这些附加按钮不存在，请单击该按钮将其恢复。Refresh Civitai Helper

每次刷新“额外网络”选项卡后，它都会删除所有这些附加按钮。因此，您需要单击按钮将它们带回来。Refresh Civitai Helper

缩略图模式

其他按钮也适用于缩略图，但由于SD webui的CSS问题，目前，它们必须始终显示在缩略图上或根本不显示。

下载

要通过Civitai模型页面的URL下载模型，您需要3个步骤：

• 填写网址，点击按钮获取型号信息
• 它将自动显示模型名称和类型。只需选择子文件夹和型号版本
• 单击下载。

详细信息将显示在控制台日志上，并带有进度条。
下载可以从断点恢复，因此不必担心文件很大。

检查模型的新版本

您可以按模型类型从civitai查看本地模型的新版本。您可以选择多个模型类型。

检查过程在每个模型的新版本检查请求后有“1 秒延迟”。所以它有点慢。

这是为了保护Civitai免受此扩展中的DDos等问题的影响。一些云服务提供商的规则是“免费用户在一秒钟内不超过 1 个 API 请求”。Civitai还没有这个规则，但我们仍然需要保护它。如果它下降，对我们没有好处。

检查过程完成后，它将在UI上显示所有新版本的信息。

每个新版本有 3 个 URL。

• 第一个是模特的civitai页面。
• 第二个是新版本的下载网址。
• 第三个是使用 python 将其下载到 SD 模型文件夹中的按钮。
  有了这个，输出信息在“下载模型”部分的日志和控制台日志中。一次一个任务。

通过网址获取模型信息

这用于强制本地模型链接到Civitai模型。例如，您转换了模型的格式或对其进行了修剪。然后扫描时无法在civitai上找到它。

在这种情况下，如果您仍想将其链接到civitai模型。您可以使用此功能。

从列表中选择此模型，然后提供civitai模型页面的URL。

单击按钮后，扩展程序将下载该civitai模型的信息并预览您选择的本地文件的图像。

代理

如果要更新到新版本，则需要在使用前重新登录 SD webui。

代理文本框位于扩展选项卡的底部。

每次填写或清除代理值时，都需要保存设置，并使用设置选项卡的重新加载按钮重新加载 UI。

然后，对civitai的所有请求都将使用代理。

对于某些 sock5 代理，需要用作 “socks5h：//xxxxxx”。

其他设置

保存设置按钮，将保存“扫描模型”的设置和其他设置。

• “始终显示按钮”适用于触摸屏。
• “在拇指模式下显示按钮”将打开/关闭缩略图上的其他按钮。
  

预览图像

额外网络同时使用 和 作为预览图像。但具有更高的优先级，因为它是由您自己创建的。model_file.pngmodel_file.preview.pngmodel_file.png

当您没有更高优先级的优先级时，它将自动使用另一个。

提示

当您单击“使用预览图像中的提示”按钮时，它不会使用您自己的预览图像中的提示。它使用civitai预览图像中的那个。

在civitai上，模型的预览图像可能没有提示。此扩展程序将检查此模型的所有civitai预览图像的信息，并使用第一个有提示的信息。

SHA256

要创建文件 SHA256，它需要读取整个文件以生成哈希代码。对于大文件来说会很慢。

此外，扩展使用内存优化的SHA256，它不会卡住您的系统并与colab配合使用。

此哈希代码在 civitai 上找不到模型有两种情况：

• 一些旧型号，在civitai上没有SHA256代码。
• 模型的所有者更改了civitai上的文件，但不会更改版本名称和描述。所以，关于奇维塔伊的文件实际上不是你曼钦上的文件。

在这些情况下，您始终可以通过在此扩展中填写模型的 URL 来将模型链接到 civitai。

功能请求

v1.1 之后的 v5.x 没有新功能。所有新功能都将转到 2.x。

2.x将专注于自定义模型信息，并可能将名称更改为“模型信息助手”，因为它不再只关注Civitai。

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

享受！

常见问题

4 卡上的按钮未显示

地方化

如果您没有使用英文版本的 SD webui，则存在本地化问题。此问题在此扩展的最新版本中已修复。PR 从 v1.6.1.1 开始支持双语本地化扩展。

使用基于云的本地化扩展

关闭基于云的本地化扩展，使用普通本地化扩展。

其他案例

首先，确保您单击了“刷新Civitai助手”按钮。

如果问题仍然存在，那么唯一的原因是您没有使用最新的SD webui。因此，请确保您更新了它。

如果您修改了SD webui的文件，您的更新可能会失败。您需要检查 git 命令的控制台日志以确保它已更新。

在许多情况下，git 只会拒绝更新并告诉您有一些冲突需要您手动处理。如果你不检查 consloe 日志，你会认为你的 SD webui 已更新，但事实并非如此。

请求、扫描或获取模型信息失败

此扩展是稳定的。因此，造成这种情况的原因很可能是您与Civitai API服务的互联网连接。

Civitai不如那些丰富的网站稳定，它可能会关闭或拒绝您的API连接。

奇维塔伊有一个连接池设置。基本上，这是civitai可以同时拥有的最大连接数。因此，如果civitai上已经有太多的曼尼连接，它将拒绝您的API连接。

在这些情况下，您唯一能做的就是等待一段时间，然后重试。

获取错误的模型信息并从civitai预览图像

一个坏消息是，一些模型在civitai的数据库中保存了错误的sha256。查看此处了解更多详情：
civitai/civitai#426

因此，对于这些模型，此扩展无法获取正确的模型信息或预览图像。

在这种情况下，您必须删除模型信息文件，并通过此扩展标签页上的civitai URL获取正确的模型信息。

此外，您可以在以下页面向civitai报告那些具有错误sha256的模型：
https://discord.com/channels/1037799583784370196/1096271712959615100/1096271712959615100

请向civitai报告该模型，以便他们修复它。

使用 colab 时扫描失败

首先，使用谷歌搜索您的错误消息。最有可能的是，这将是一个colab问题。

如果您确定扫描模型时存在内存不足问题，并且您使用的是此扩展的最新版本，那么我们将无能为力。

从 v1.5.5 开始，我们已经将 SHA256 功能优化到顶部。因此，您唯一的 2 个选择是：

• 再试一次
• 或使用 Colab 的专业帐户。

更新日志

1.6.4 版

• 添加“下载所有文件”复选框以下载模型部分。取消选中意味着只下载 1 个文件。

1.6.3 版

• 支持下载多个文件，检查新版本时不可用。

1.6.2.1 版

• 解析 civitai URL 时，通过 PR 删除查询字符串

1.6.2 版

• 下载时，如果文件已存在，请重命名文件

1.6.1.1 版

• 通过 PR 支持双语本地化扩展

1.6.1 版

• 修复卡片上 4 个附加按钮的本地化问题。（又忘了…

1.6.0 版

• 修复了一些 UI 问题以使用 gradio 3.23.0
• 连接到civitai时支持代理。检查文档以了解详细信息。
• 打开文件时检查 RealPath，以修复使用结时的错误
• 修复了切换选项卡后多个附加按钮的问题。

1.5.7 版

• 修复卡片上新增 4 个按钮的本地化问题

1.5.6 版

• 更新错误消息时无法连接到civitai API服务
• 更新 SD WebUI 新版本元数据按钮的拇指模式

1.5.5 版

• 更新SHA256功能，现在它只使用pip的代码

1.5.4 版

• 将 sys.stdout 设置为 utf-8
• 为请求添加默认标头，以防止被civitai阻止。
• 将其他 v1.5.x 更改日志合并为 v1.5.4
• 通过 url 下载模型时，请检查用户选择的子文件夹中是否已存在目标模型版本。
• 仅支持扫描选定的模型类型。
• 强制 TI 扫描延迟 1 秒，以防止 civitai 将此扩展的请求视为攻击。

1.5.0 版

• 通过奇维塔伊模型页面的网址下载模型
• 从断点恢复下载
• 将新版本下载到SD Webui的模型文件夹中
• 附加按钮现在适用于缩略图模式
• 始终显示添加按钮的选项，用于触摸屏。

1.4.2 版

• 扫描时忽略模型文件夹中的 .vae 文件

1.4.1 版

• 检查新版本时，还要搜索并忽略已经存在的版本。
• 将版本号添加到此扩展选项卡的底部

1.4 版

• 支持检查模型新版本，在UI中显示结果并提供下载网址
• 删除扩展选项卡上的附加子选项卡。 使 UI 更简单。

1.3 版

• 在客户端打开网址
• 通过网址或模型ID将所选模型链接到civitai
• 保存扩展名设置并将其加载到文件
• 将按钮操作的输出显示到 UI
• 代码重构

1.2.1 版

• 添加更多错误检查以使用不同版本的 SD webui。

1.2 版

• 支持客户模型文件夹
• 支持可读模型信息文件
• 支持下载最大尺寸的预览图像
• 当额外的网络处于缩略图模式时删除卡按钮

1.1 版

• 支持子文件夹
• 单击“刷新Civitai助手”时检查是否需要刷新
• 添加触发词时添加空格
• 添加内存优化的sha256作为选项

原文链接：https://cj.suclub.top/3565.html，转载请注明出处。