sd-webui-depth-lib

一键生成深度图，让 ControlNet 构图更精准

sd-webui-depth-lib 是一个为 Stable Diffusion WebUI 的 ControlNet 扩展提供深度图库的插件。它解决的是在图像生成过程中，用户需要便捷获取高质量深度图以控制生成结构的问题。该插件内置了多种深度图生成算法，如 MiDaS、Zoe、DPT 等，并提供了直观的 WebUI 界面，用户无需手动运行外部脚本，即可在文生图或图生图流程中一键生成、预览和保存深度图，从而辅助 ControlNet 实现更精准的构图控制。核心能力包括多算法支持、参数调节、批量处理以及与 ControlNet 的无缝集成，显著降低了深度图获取的技术门槛。

开源 free 图像生成

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1390

维护状态低维护

是否开源是

定价模式 free

项目数据

分类图像生成

开发团队jexom

所属国家

官网地址

GitHubhttps://github.com/jexom/sd-webui-depth-lib

定价模式free

价格说明开源MIT协议，完全免费，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型stable-diffusion,stable-diffusion-webui-plugin

GitHub 星标★ 1390

30天Star增速

HF 下载量

上线时间2023-03-02 00:00:00

最近更新2026-09-20 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 5 分钟部署方式：本地安装 5 步

环境要求

已安装并可正常运行的 Automatic1111/stable-diffusion-webui
已安装 ControlNet 扩展（Mikubill/sd-webui-controlnet）
WebUI 能访问 GitHub 以从 URL 安装扩展

安装与启动步骤

1打开扩展标签页

启动 WebUI，在顶部标签栏点击 Extension（扩展）标签，进入扩展管理页面。
2选择从URL安装

在扩展页面中点击 Install from URL 选项卡，切换到按地址安装扩展的界面。
3填写仓库地址

在 URL for extension's git repository 输入框中粘贴本插件的仓库地址，注意不要填错大小写。
```
https://github.com/jexom/sd-webui-depth-lib.git
```
4点击安装并重启

点击 Install 按钮，等待安装完成后重启 WebUI，让插件被加载。
5放入自定义深度图

如需永久添加自己的深度图，把图片放进 maps/ 目录，即你想显示的标签页名，可参考示例 shapes 文件夹。

关键配置

配置项	必填	说明	示例
`URL for extension's git repository`	是	WebUI 扩展安装页中填写本插件的 git 仓库地址	`https://github.com/jexom/sd-webui-depth-lib.git`
`extensions/sd-webui-depth-lib/maps/`	否	自定义深度图存放目录，文件夹名即 WebUI 中的分类标签名	`extensions/sd-webui-depth-lib/maps/shapes`

如何确认成功

重启 WebUI 后，扩展列表中出现 sd-webui-depth-lib，界面出现 Depth map library and poser 相关标签页即安装成功。

常见问题

Q：安装后界面没有出现插件怎么办？

A：确认已在 Install from URL 中安装成功，然后完整重启 WebUI（关闭并重新启动进程），仅刷新浏览器页面通常不会加载新扩展。

Q：使用时 ControlNet 参数要怎么设置？

A：根据 README 的 Attention 提示，ControlNet 的 Preprocessor 一栏不要选择任何项，直接使用本插件生成的深度图作为输入。

Q：如何添加自己的深度图？

A：把图片放到 extensions/sd-webui-depth-lib/maps/ 文件夹中，其中是你想要的分类标签名，可参考自带的 shapes 文件夹结构。

Q：这个插件能独立运行吗？

A：不能。它是为 ControlNet 扩展提供的深度图库与摆姿工具，必须配合 Automatic1111/stable-diffusion-webui 和 ControlNet 扩展一起使用。

注意事项

安装步骤全部在 WebUI 网页界面完成，无需手动执行命令行。
使用前请确保 ControlNet 扩展已安装，本插件依赖它工作。
在 ControlNet 中不要为 Preprocessor 选择任何选项。

核心亮点

内置多种深度估计算法（MiDaS、Zoe、DPT），可按需切换，适应不同场景
与 WebUI 和 ControlNet 深度集成，操作流畅，无需额外命令行工具
支持批量处理，可快速为多张图像生成深度图，提升效率

不足之处

文档相对简略，高级用法需自行摸索
插件更新依赖社区维护，可能滞后于 WebUI 版本变化

适用场景

为 ControlNet 生成精确的深度图以控制图像空间结构
批量预处理图像数据集，用于训练或风格迁移
快速预览不同深度算法效果，辅助选择最佳方案

替代项目

controlnet-aux、sd-webui-controlnet、MiDaS

项目介绍

sd-webui-depth-lib 是图像领域的开源项目，由 jexom 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,390）位列前 30%，在图像分类的 837 个项目里位列前 12%。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-20。开源MIT协议，完全免费，无付费版本。

它主要面向的使用场景是：为ControlNet生成精确的深度图以控制图像空间结构。同类可对比的替代方案包括 controlnet-aux、sd-webui-controlnet、MiDaS。

上一篇：ComfyUI-InstantID

下一篇：CrossAttentionControl