SD：Ubuntu 系统 stable diffusion Web UI - 安装更多插件

前言

接着上一篇文章（ 《SD：在一个 Ubuntu 系统安装 stable diffusion Web UI》 ），本文介绍安装：

• 标签器
  在 stable diffusion Web UI 中，标签器 是将图片转为提示词的工具。当有参考图时非常好用。
• openpose-editor
  openpose-editor 是获取简易骨骼图的工具，可以从图片中生成（类似于 control net 的功能），也可以手动摆放。

1. 标签器

1.1. 下载 git 仓库

cd stable-diffusion-webui安装目录
git clone https://github.com/toriato/stable-diffusion-webui-wd14-tagger.git extensions/stable-diffusion-webui-wd14-tagger

1.2. 下载模型

mkdir -p ~/.cache/huggingface/hub/models--SmilingWolf--wd-v1-4-vit-tagger-v2
cd ~/.cache/huggingface/hub/models--SmilingWolf--wd-v1-4-vit-tagger-v2
wget https://huggingface.co/SmilingWolf/wd-v1-4-vit-tagger-v2/resolve/main/model.onnx
wget https://huggingface.co/SmilingWolf/wd-v1-4-vit-tagger-v2/resolve/main/selected_tags.csv

1.3. 问题修复

1.3.1 错误日志

在启动过程中，日志显示：

*** Error running preload() for /home/zkding/programs/stable-diffusion-webui/extensions/stable-diffusion-webui-wd14-tagger/preload.pyTraceback (most recent call last):File "/home/zkding/programs/stable-diffusion-webui/modules/script_loading.py", line 30, in preload_extensionsmodule = load_module(preload_script)File "/home/zkding/programs/stable-diffusion-webui/modules/script_loading.py", line 13, in load_modulemodule_spec.loader.exec_module(module)File "<frozen importlib._bootstrap_external>", line 883, in exec_moduleFile "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removedFile "/home/zkding/programs/stable-diffusion-webui/extensions/stable-diffusion-webui-wd14-tagger/preload.py", line 4, in <module>from modules.shared import models_pathImportError: cannot import name 'models_path' from partially initialized module 'modules.shared' (most likely due to a circular import) (/home/zkding/programs/stable-diffusion-webui/modules/shared.py)

ControlNet preprocessor location: /home/zkding/programs/stable-diffusion-webui/extensions/sd-webui-controlnet/annotator/downloads
2025-10-09 18:51:09,563 - ControlNet - INFO - ControlNet v1.1.455
*** Error loading script: tagger.pyTraceback (most recent call last):File "/home/zkding/programs/stable-diffusion-webui/modules/scripts.py", line 515, in load_scriptsscript_module = script_loading.load_module(scriptfile.path)File "/home/zkding/programs/stable-diffusion-webui/modules/script_loading.py", line 13, in load_modulemodule_spec.loader.exec_module(module)File "<frozen importlib._bootstrap_external>", line 883, in exec_moduleFile "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removedFile "/home/zkding/programs/stable-diffusion-webui/extensions/stable-diffusion-webui-wd14-tagger/scripts/tagger.py", line 5, in <module>from tagger.ui import on_ui_tabsFile "/home/zkding/programs/stable-diffusion-webui/extensions/stable-diffusion-webui-wd14-tagger/tagger/ui.py", line 10, in <module>from webui import wrap_gradio_gpu_callImportError: cannot import name 'wrap_gradio_gpu_call' from 'webui' (/home/zkding/programs/stable-diffusion-webui/webui.py)

1.3.2 错误原因

询问AI得知：

• preload.py 里 from modules.shared import models_path 这一行在 WebUI ≥ 1.8 会触发「循环 import」——官方把 models_path 挪到了 modules.paths。
• tagger/ui.py 里 from webui import wrap_gradio_gpu_call 在 1.8+ 同样失效，现在它在 modules.call_queue。

1.3.3 解决方法

AI 告诉我这样修（有效）：

• extensions/stable-diffusion-webui-wd14-tagger/preload.py
  把第 4 行
  from modules.shared import models_path
  换成
  from modules import paths; models_path = paths.models_path

• extensions/stable-diffusion-webui-wd14-tagger/tagger/ui.py
  把第 10 行
  from webui import wrap_gradio_gpu_call
  换成
  from modules.call_queue import wrap_gradio_gpu_call

1.4. 使用

启动 stable diffusion Web UI，在 web 界面中，上方栏目里有 Tagger 字样，点击进入，上传图片即可打标签。

• 注1 - 首次使用在后台下载：

Loading wd14-vit-v2-git model file from SmilingWolf/wd-v1-4-vit-tagger-v2
model.onnx

2. openpose-editor

2.1 安装

cd stable-diffusion-webui安装目录/extensions
git clone https://github.com/fkunn1326/openpose-editor.git
pip install --no-deps basicsr==1.4.2

• 注：依赖于 basicsr==1.4.2，并且需要强制导入。

2.2 使用

启动 stable diffusion，在 web 界面中，上方栏目里有 OpenPose Editor 字样，点击进入，上传图片即可生成建议骨骼图。