大家好！欢迎来到 Olares AIGC 官方系列课程。在大家已经掌握了 Stable Diffusion WebUI 的两大核心功能—文生图和图生图之后，本期我们将深入探讨如何通过安装和使用插件来进一步拓展 WebUI 的功能边界，解锁更多高级玩法与便捷操作。
上期视频回顾：Stable Diffusion图生图原来这么简单？超详细使用方法和参数设置丨【保姆级教程】AI绘画进阶必看！
上期专栏回顾：SD WebUI 图生图功能详解：原理、模式与参数全解析丨AI绘画进阶必看！
本期课程我们将一同：
理解插件（扩展）的核心概念及其在 Stable Diffusion 生态中的重要作用，拓展你对 WebUI 能力的认知。
掌握在 SD WebUI 中查找、评估和安装插件的多种方法，包括在线列表、URL 直装及离线包手动部署。
学习并解决插件安装过程中常见的网络访问难题，特别是针对 GitHub 连接的 Olares 系统级优化方案（如 Hosts 配置与 Git 代理设置）。
通过对 LivePortrait 和 ADetailer 两大热门插件的实战演练，精通其配置、使用，并掌握在 Olares 环境下特定的模型准备与高级系统设置技巧（如 YAML 文件编辑进行卷挂载）。
熟悉插件的日常管理方法，包括如何安全地禁用、检查更新与彻底卸载。
插件（扩展）概述
插件，在 Stable Diffusion WebUI 中通常也被称为“扩展”（Extensions），是一种无需修改 WebUI 核心代码即可为其增添新功能或优化现有体验的模块化组件。它们是 Stable Diffusion 生态不可或缺的重要组成部分，由全球的开发者社区贡献，种类繁多，功能各异。
例如，一些常用插件可以实现：
提示词增强：如 Prompt-all-in-one，提供更便捷的提示词输入、管理和翻译功能。
图像细节优化：如 ADetailer（After Detailer），能够自动检测并修复画面中的人脸、手部等细节。
动画制作：如 AnimateDiff 或 SVD 相关插件，可以基于文本或图像生成短动画。
工作流改进：提供更复杂的图像处理流程或与其他工具的集成。
善用插件，能够极大地提升我们的创作效率和作品质量。
插件的安装方法
获取并安装插件是使用它们的第一步。SD WebUI 主要支持以下几种安装方式：
通过 WebUI“扩展”选项卡在线安装
这是最常用也是最直接的方法，直接在 WebUI 界面中浏览、搜索和安装官方索引库中的插件。
1.在 SD WebUI 界面中，选择顶部导航栏的“扩展 （Extensions）”选项卡。
2.在该页面下，点击子选项卡“可用 （Available）”。
3.点击橙色的“加载自（Load from）”按钮。WebUI 会尝试访问官方维护的插件索引仓库，获取最新的可用插件列表。
如果加载缓慢或失败，可能与网络访问 GitHub 有关，具体解决方案请参见本教程最后一章“常见问题与解决措施”。
4.成功加载后，列表中会显示大量可用插件。可以按标签筛选、阅读描述、或直接在搜索框中输入插件名称进行查找。
5.找到目标插件后，点击其条目右侧的“安装 （Install）”按钮，并耐心等待安装完成。
如果在安装过程中遇到 git clone 相关错误，解决方案同样请参见最后一章。
通过 URL 直接安装
如果已经知道了某个插件的 Git 仓库地址，可以直接通过 URL 进行安装。
1.在“扩展 （Extensions）”选项卡下，选择“从网址安装 （Install from URL）”子选项卡。
2.在“扩展的 git 仓库网址 （URL for extension's git repository）”输入框中，粘贴插件的完整 Git 仓库 URL。
如果直接访问 GitHub 困难，可以尝试使用镜像站或代理转换后的 URL，详情可参考最后一章。
3.可以为插件指定一个本地目录名称（可选，留空则通常使用仓库名）。
4.点击“安装 （Install）”按钮。
离线/手动安装
对于网络条件不佳，或希望精确控制插件版本的情况，可以采用离线手动安装。
以 ADetailer 插件为例：
1.从插件的官方 GitHub 仓库的“Releases”页面，或者其他可信的第三方分享渠道，下载插件的 .zip 压缩包。
2.将下载的压缩包解压。
提示：解压后得到的文件夹名称可能带有版本号、-main 或 -master 等后缀（例如 adetailer-main）。需要将这个文件夹重命名，确保其名称与插件的预期标准名称一致（例如，对于 ADetailer，文件夹名应为 adetailer）。
3.上传到 Olares 系统指定目录：
（1）打开 Olares 文件管理器。
（2）导航至 SD WebUI 的插件存放目录，路径为：
外部设备 > ai > sd > share > extensions（3）将上一步中准备好的插件文件夹整个上传到此 目录下。
插件的管理
安装后重启以使插件生效
无论通过哪种方式安装插件，成功后通常都不会立即生效。需要：
1.切换到“扩展 （Extensions）” > “已安装 （Installed）”子选项卡。
2.找到新安装的插件（它旁边可能有一个提示，说明下次重启后生效）。
3.点击页面顶部的橙色按钮“应用并重启 UI （Apply and restart UI）”。WebUI 将自动刷新，新插件的功能或界面通常就会出现了。
禁用插件
如果暂时不想使用某个插件，或者怀疑它可能导致兼容性问题，可以先禁用它：
1.进入“扩展 （Extensions）”选项卡 > “已安装 （Installed）”子选项卡。
2.在列表中找到您想禁用的插件，取消勾选其名称旁边的复选框。
3.点击页面顶部的“应用并重启 UI （Apply and restart UI）”按钮。重启后，被禁用的插件将不再加载。
检查更新
对于通过 Git 仓库安装的插件（通常在“已安装”列表中会显示其 Git 仓库 URL 和分支信息），可以检查是否有新版本：
1.在“已安装”子选项卡中，点击“检查更新 （Check for updates）”按钮。
2.WebUI 会为每个符合条件的插件执行 等命令，查询其远程仓库状态。
3.若有可用更新，插件条目旁通常会显示相关提示或更新选项。
卸载插件
⚠️注意：仅仅在 WebUI 界面禁用插件并不能删除其文件。
如果确定不再需要某个插件，并希望将其从系统中彻底移除：
1.打开 Olares 文件管理器。
2.导航至 SD WebUI 的插件存放目录：
外部设备 > ai > sd > share > extensions3.在此目录中，找到与想卸载的插件对应的文件夹。在该插件文件夹上右键，选择“删除 （Delete）”。
4.删除插件文件后，回到 SD WebUI 界面，再次点击“应用并重启 UI”。这样，该插件就被彻底移除了。
插件实战应用
接下来，我们将详细演示两款实用插件的配置与使用。
LivePortrait – 让肖像动起来
LivePortrait 插件能够基于一张静态人物肖像图片和一个驱动视频，生成一段让肖像人物模仿驱动视频中面部表情和头部姿态的短视频。
查阅使用须知
在首次使用复杂插件前，建议访问其 GitHub 仓库页面，仔细阅读文档。
LivePortrait 的文档会包含其依赖库（如 XPose）、各项设置、以及模型准备的详细说明。
模型准备（Olares 环境）
LivePortrait 运行时需要特定的 AI 模型。为确保稳定使用，建议手动准备：
1.根据插件文档提供的 Hugging Face 链接下载所有必需的模型文件。
若直接下载困难，可尝试 Hugging Face 镜像站（如 hf-mirror.com）。
2.上传至 Olares：
（1）打开 Olares 文件系统，导航至
外部设备 > ai > models（2）在此目录下，按插件文档要求创建子文件夹，如 和 。
（3）将下载好的模型文件按文档指示的结构分别上传。
（4）Olares 用户也可利用系统客户端 LarePass 的链接下载功能直接下载模型到主机，再通过文件管理器移动。
高级 Olares 配置：为插件模型挂载存储卷 （Editing YAML）
此步骤是为了让 SD WebUI 容器能访问到在 Olares 文件系统中为 LivePortrait 准备的模型。
此为高级操作，请谨慎，建议操作前备份或记录原始配置。
1.打开 Olares“控制面板”，找到 SD WebUI 的容器组（通常名称以 开头）。
2.选择“编辑 YAML （Edit YAML）”。
3.添加新的卷 （volumes）：在 YAML 文件的 部分，参考一个已有的模型卷声明（如 相关部分，若存在），复制其结构并粘贴两份。修改这两份的 和 以分别指向为 LivePortrait 创建的两个模型目录。例如：
-name: modellibipadapter
hostPath:
path: /olares/share/ai/model/ipadapter
type: DirectoryOrCreate
-name: modellibipadapter
hostPath:
path: /olares/share/ai/model/ipadapter
type: DirectoryOrCreate
-name: modellibipadapter
mountPath: /stable-diffusion-webui/models/ipadapter
-name: modellibipadapter
mountPath: /stable-diffusion-webui/models/ipadapter（实际外部存储挂载点请根据 Olares 配置确认）
4.添加新的卷挂载 （volumeMounts）：在 -> 部分，同样复制已有模型卷挂载声明两份。修改其 （与上一步新卷对应） 和
容器内访问路径，需参考插件文档或其默认查找路径
例如：
-name: modellibliveportrait
hostPath:
path: /olares/share/ai/model/liveportrait
type: DirectoryOrCreate
-name: modellibinsightface
hostPath:
path: /olares/share/ai/model/insightface
type: DirectoryOrCreate
-name: modellibliveportrait
mountPath: /stable-diffusion-webui/models/liveportrait
-name: modellibinsightface
mountPath: /stable-diffusion-webui/models/insightface
5.确认修改无误后，点击“确认 （Confirm）”或“保存 （Save）”。Olares 将应用配置并重启 SD WebUI 容器组。
基本使用
1.重启完成后，回到 SD WebUI 界面，点击新出现的“Live Portrait”标签页。
2.在左侧“源图片（Source Image）”区域上传一张静态人物肖像。
3.在右侧“驱动视频 （Driving Video）”区域选择或上传一个驱动视频。
4.保持其他参数默认，点击“生成 ”按钮。稍等片刻即可看到结果。
LivePortrait 的更多参数调整，可自行探索。
ADetailer – 细节增强与修复
ADetailer （After Detailer） 插件嵌入在文生图或图生图流程中，用于在主图像生成后自动检测并修复特定区域（如人脸、手部）的细节。
启用与基本设置
1.在文生图或图生图界面的参数区域（通常在种子参数下方）找到“ADetailer”选项。
2.勾选“启用 ADetailer （Enable ADetailer）”。
3.ADetailer 支持多轮修复。在第一轮（1st）的“ADetailer model”下拉菜单中，选择检测模型，如 Olares 系统内置的 face_yolov8n.pt（人脸）或 hand_yolov8n.pt（手部）。
实战演示：修复人脸与手部
1.使用“图片信息 （PNG Info）”加载一组生成参数。
2.生成一张全身图。对于 SD1.5 模型，由于人脸占比较小，易出现脸部崩坏。
3.对比：
先不启用 ADetailer 生成图像，观察脸部效果。
然后启用 ADetailer，第一轮选择人脸检测模型，再次生成。观察到 ADetailer 会在主图生成后，自动框选并重脸部，显著提升质量。
接着，可以启用第二轮（2nd），选择手部检测模型，再次生成，实现对手部的修复。
4.对比不同设置下的图像，能明显感受到 ADetailer 带来的细节改善。
ADetailer 还支持为检测区域设置独立提示词等高级功能，将在后续教程中结合其他工具深入讲解。
常见问题与解决措施（Olares 环境为主）
在安装和使用插件过程中，可能会遇到一些问题，以下是针对常见情况的解决思路：
加载“可用”插件列表缓慢或失败
问题原因
通常是由于本地网络环境访问 GitHub（插件索引库及插件源码托管地）不稳定。
解决措施
1️⃣配置系统 Hosts 文件
访问可靠的 GitHub Hosts 信息源，https://hosts.gitcdn.top/hosts.txt，获取最新的 GitHub 系列域名与 IP 对应关系。
特别建议添加以下几个：
20.205.243.166 github.com
20.205.243.168 api.github.com
185.199.109.133 raw.githubusercontent.com
20.205.243.165 codeload.github.com
16.182.109.41 github-production-release-asset-2e65be.s3.amazonaws.com
16.15.176.52 github-production-user-asset-6210df.s3.amazonaws.com
52.217.119.121 github-production-repository-file-5c1aeb.s3.amazonaws.com
通过 Olares 程序坞打开“Olares 系统设置” > “系统” > “Hosts”。点击“添加 Host”，将获取到的 IP 与域名逐条添加。
2️⃣使用国内镜像或代理服务
尝试访问国内代码托管平台（如 Gitee）上是否有目标插件的同步仓库。
使用 GitHub 加速代理（如 ghproxy.com 等）。当直接访问某个 GitHub 文件 URL（如插件列表的 JSON 文件）受阻时，可在原始 URL 前加上代理前缀。
插件安装时 git clone 失败
问题原因
错误信息中常包含证书问题、网络超时、连接被终止等，本质仍是网络问题导致无法从 GitHub 克隆插件仓库。
解决措施
（1）打开 Olares“控制面板”，找到 SD WebUI 的运行容器。
（2）进入容器的“终端 （Terminal）”。在终端中为 命令设置全局 HTTP/HTTPS 代理（代理地址需替换为可用的服务）。
例如，使用 ghproxy 的代理：
（注意，ghproxy 主要用于加速下载，作为 git 的全局代理可能效果不一，可以自行测试把“https://github.com” 替换成什么）
git config --global url."https://ghfast.top/https://github.com".insteadOf https://github.com这个命令意思是将所有以 https://github.com 开头的远程仓库地址自动替换为 https://ghfast.top/https://github.com，从而使用镜像站点（https://ghfast.top）加速访问 GitHub。
（3）可以运行 git config --list 查看当前所有的配置，验证配置是否生效
（4）设置代理后，返回 SD WebUI 界面重新尝试安装插件。
特定插件（如 LivePortrait）模型下载困难
问题原因
插件依赖的 AI 模型通常托管在 Hugging Face 等国外平台，直接下载可能缓慢或失败。
解决措施
1️⃣使用镜像站
许多模型在 Hugging Face 的国内镜像站（如 hf-mirror.com）上有提供，可尝试从镜像站下载。
2️⃣利用 Olares 下载工具
如 Olares 系统客户端 LarePass 可能提供的链接下载功能，直接将模型下载到主机存储中，再通过文件系统移动到插件指定的 Olares 内部模型路径。
插件特定依赖问题
问题原因
某些复杂插件可能依赖特定的 Python 库或系统环境，自动安装这些依赖时可能出错。
解决措施
1️⃣仔细阅读插件文档
插件的 GitHub 页面通常会说明其依赖项和特殊的安装步骤（如 LivePortrait 对 XPose 库的说明）。
2️⃣手动处理
根据文档指引，可能需要在 SD WebUI 容器的终端内手动安装缺失的库或进行其他配置。
结语
本期课程，我们系统地学习了 Stable Diffusion WebUI 中插件的查找、三种主要安装方式、日常管理方法，并通过 LivePortrait 和 ADetailer 两个插件进行了详细的实战应用演示。特别地，我们针对在 Olares 环境下安装和配置插件时可能遇到的网络问题和高级设置提供了解决方案。
掌握插件的运用，将极大丰富 AI 创作工具箱，实现更复杂、更精细、更高效的图像生成。
下期内容将深入解析其他功能，欢迎持续关注。
欢迎在评论区留言交流👇
可以观看这个视频，详细了解 Olares。
📝 Olares 论坛已上线，欢迎在这里分享和讨论 https://forum.olares.cn/
