---
title: sd-webui-forge-neo-v3
canonical_url: "https://www.modelscope.cn/studios/yangzxo/sd-webui-forge-neo-v3"
md_url: "https://www.modelscope.cn/studios/yangzxo/sd-webui-forge-neo-v3.md"
repository: yangzxo/sd-webui-forge-neo-v3
chinese_name: sd-webui-forge-agent
last_updated: 2026-10-13
sdk_type: gradio
sdk_version: 4.44.0
downloads: 0
stars: 2
---

# sd-webui-forge-neo-v3

> sd-webui-forge-neo-v3 - yangzxo 在 ModelScope 创建的在线 Demo。多模态项目融合的AI功能整合包

yangzxo/sd-webui-forge-neo-v3 是 ModelScope 魔搭社区上的在线可交互 Demo（创空间），基于 gradio 4.44.0 构建，中文名为「sd-webui-forge-agent」。

- **Repository**: yangzxo/sd-webui-forge-neo-v3
- **SDK**: gradio
- **SDK version**: 4.44.0
- **Downloads**: 0
- **Stars**: 2
- **Last updated**: 2026-10-13

Source: https://www.modelscope.cn/studios/yangzxo/sd-webui-forge-neo-v3

---

# sd-webui-forge-neo-agent

<div align="center">

**面向 Agent 智能体时代的 Stable Diffusion WebUI Forge 中文整合平台 | 多模态模型 | MCP / Skill | 智能 GUI 启动器**

[![GitHub stars](https://img.shields.io/github/stars/exo101/sd-webui-forge-neo-agent)](https://github.com/exo101/sd-webui-forge-neo-agent/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/exo101/sd-webui-forge-neo-agent)](https://github.com/exo101/sd-webui-forge-neo-agent/network)
[![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.13.12-blue.svg)](https://www.python.org/)

[📖 使用教程](https://www.bilibili.com/video/BV1L9hY6PEJG/?spm_id_from=333.1387.homepage.video_card.click&vd_source=343e49b703fb5b4137cd6c1987846f37) | [🚀 快速开始](#快速开始)

</div>

---

## 📦 本次版本更新

- **Qwen-Image 2.1 姿势迁移**：支持白膜姿势参考与 `PoseStudio` LoRA，可将参考人物的姿势迁移到目标角色上。
- **MCP 直接调用 WebUI**：保留旧版本 UI 使用方式，同时提供 MCP 接口，可通过 Codex 等支持 MCP 的软件直接调用 WebUI 完成生图、图像处理和工作流任务。
- **插件整合与标签页优化**：合并多项新旧插件，减少标签页占用；翻译插件与提示词补全合并，图像识别与传统标签器合并，多媒体工具与 H3 视频生成合并。
- **本地大语言模型自动检测**：支持并自动检测 `llama.cpp`、Ollama 和 LM Studio，无需再手动填写服务端口。
- **H3 视频显存管理**：H3 视频生成支持配置 GPU 常驻权重，超出显存预算的权重自动 offload 到 CPU，降低显存峰值并提升长任务稳定性。
- **SCAIL-2 角色动画**：支持 SCAIL-2 角色动画视频生成，补全从角色动作迁移到影视二创工作流的最后一块拼图。

---

## 📋 项目介绍

**sd-webui-forge-neo-agent** 是基于 **Stable Diffusion WebUI Forge** 的中文智能体增强整合版本，面向国内用户、多模态模型和对话式 AI 工作流进行改良。项目目标不再只是提供一个复杂参数面板，而是让用户通过聊天就能调用 WebUI 能力、组合模型、扩写提示词、处理图像/视频、诊断问题并完成复杂任务。


> [!NOTE]
> 本版本为改良版本，部分插件直接安装会发生兼容性错误，为了适应众多新旧插件做了些许修改，如需要安装旧插件直接让智能体帮忙安装排除修改bug和不兼容性。
>
> 当前项目名称为 `sd-webui-forge-neo-agent`。项目在保留传统 WebUI 操作方式的同时，持续围绕 Agent、MCP、多模态理解、模型编排和工具调用进行维护。

---

## 🚀 新路线：Agent 智能体与 MCP / Skill

本项目正在从“手动操作大量参数的 WebUI”逐步进化为“可以通过对话完成复杂任务的 AI 工作台”。用户不必记住所有参数和菜单位置，只需描述目标，智能体就可以理解任务、调用 WebUI 功能，并在必要时向用户确认关键操作。

### 智能体可以做什么

| 能力 | 说明 |
|------|------|
| **自然语言生图** | 根据用户描述生成图片，自动选择或调整模型、尺寸、采样器、步数、提示词和相关参数 |
| **记忆与上下文感知** | 在启用记忆功能后，记录用户偏好、常用模型、风格习惯和当前任务上下文；用户也可以清理或关闭记忆 |
| **复杂参数设置** | 根据显存、模型类型、画面比例和任务目标，自动组合生成参数，减少手动调整负担 |
| **模型组合调配** | 读取可用模型、VAE、文本编码器、LoRA、ControlNet 和预处理器，并按任务需要组合使用 |
| **提示词扩写与整理** | 将简单描述扩展为更完整的正向提示词，整理负面提示词、权重、风格、构图和主体细节 |
| **批量任务处理** | 执行批量生图、批量放大、批量抠图、批量格式处理和多步骤图像工作流 |
| **多模态理解** | 在支持相应工具和模型的情况下，读取并分析文档、图像、代码、视频、网页内容和工作区文件 |
| **图像与视频处理** | 调用图生图、后期处理、放大、抠图、图层分离、视频抽帧、视频生成 |
| **扩展与 WebUI 检查** | 查看已安装扩展、调研扩展功能、诊断 WebUI 文件和定位常见内部错误 |
| **对话式任务编排** | 将“读取资料 → 分析 → 生成提示词 → 选择模型 → 批量生成 → 对比结果”串成连续任务 |

> 智能体的实际能力取决于已安装的扩展、可用模型、显存、操作系统权限以及配置的 AI 模型/API。涉及删除文件、执行命令、修改代码或外部服务调用时，应先确认范围并做好备份；智能体不会替代人工审核生成结果和代码修改。

### MCP 与 Skill

- **MCP**：为智能体提供标准化工具接口，使其能够访问 WebUI 功能、模型管理、工作区文件、网页内容、图像/视频处理和其他外部工具。
- **Skill**：以 `SKILL.md` 形式描述某类任务的使用规则和步骤。智能体可以发现可用 Skill，读取对应说明后按规范执行任务。
- **工具调用**：智能体可以调用文生图、图生图、模型切换、参数更新、模型列表、后期处理、视频处理、文档分析、网页读取、扩展诊断等工具。
- **可扩展性**：用户可以根据自己的工作流增加模型、扩展、MCP 服务或 Skill，使智能体逐步适应个人的生产流程。

### 使用 MCP 调用 WebUI

可以直接让 Codex、Claude Code、Qwen Code 等支持 MCP 的编程软件读取并执行 [`mcp-server/README.md`](./mcp-server/README.md) 中的配置说明，再将 `<WEBUI_DIR>` 替换为本项目实际路径。配置完成并重启客户端后，即可通过自然语言调用 WebUI 的生图、图像处理、视频生成和图层分离等工具，无需手动填写 WebUI API 端口。

### 智能体大脑

项目支持使用云端 API 模型或本地模型作为智能体大脑：

- **API 模型**：可配置兼容 OpenAI 接口的云端模型，也可以使用项目中支持的图像/视频 API 服务。
- **本地模型**：智能体可连接 `llama.cpp`、Ollama 或 LM Studio 等本地推理程序。项目会检测可用的本地后端，通常无需手动填写端口；具体模型加载方式和兼容性取决于对应推理程序。
- **混合工作流**：使用本地模型负责对话、参数规划和工具调用，使用云端模型负责复杂推理或图像/视频生成；具体组合取决于用户的配置。

### 面向新手的 UI 方向

后续版本将全面简化高频 UI 参数设置：保留必要的高级选项，同时让智能体承担参数解释、自动配置和任务编排工作。新手可以直接描述“生成一张某种风格、某种比例的图片”，熟悉 WebUI 的用户仍然可以继续使用传统界面和高级参数。

---

## 🖼️ 图像对比模块

项目内置图像对比功能，用于快速查看生成前后或两次生成结果之间的差异：

- **文生图**：第一次生成单张图片时不显示对比；再次生成后自动比较上一次和本次结果。
- **图生图**：生成完成后自动对比原图和生成结果。
- **后期处理**：处理完成后自动对比原图和处理结果。
- **PNG 图片信息**：上传图片后自动显示可对比结果。
- **滑动查看**：通过滑动条调整分界线，适合查看细节、放大效果、重绘差异和风格变化。

---

## 🇨🇳 国内用户与 ModelScope（魔搭社区）支持

项目集成了面向国内用户的 ModelScope（魔搭社区）模型下载能力。用户可以在 WebUI 的开源模型下载器中一键下载完整模型组件，自动放入指定位置，并保存到对应模型目录。

支持的主要方式包括：

- ModelScope（魔搭社区）模型仓库下载；
- Hugging Face 模型仓库下载；
- 完整仓库下载和单文件下载；
- 多文件选择、下载历史和自定义保存路径；
- 国内网络环境下优先使用 ModelScope，减少跨境网络访问带来的不稳定；
- 已下载模型可继续由 WebUI 或智能体发现、切换和调用。

> ModelScope 下载速度和可用性仍取决于网络、仓库权限、模型大小和平台服务状态。部分模型还需要额外的文本编码器、VAE、LoRA 或其他组件，下载后请按照模型说明放入正确目录。

> 如果网络不稳定，或不熟悉本地模型部署和依赖配置，可以通过项目交流群获取已经配置好的压缩包。解压后即可使用；压缩包通常已经合并并配置了多项扩展，但模型文件和硬件要求仍需根据说明准备。

---

## � 部署区

> 部署区涵盖从零开始部署本项目所需的所有信息，包括系统要求、安装步骤、启动器使用和常见问题。

### 系统要求

| 项目 | 最低要求 | 推荐配置 |
|------|---------|---------|
| **操作系统** | Windows 10/11 (64位) | Windows 11 |
| **Python** | 3.13.12 | 3.13.12 |
| **GPU** | NVIDIA GPU 8GB+ 显存 | NVIDIA GPU 12GB+ 显存 |
| **内存** | 16GB | 32GB |
| **磁盘空间** | 50GB 可用空间 | 100GB+ SSD |

### 快速开始（独立环境整合包）

推荐从 [GitHub Releases](https://github.com/exo101/sd-webui-forge-neo-agent/releases) 下载 **Windows Portable / 独立环境整合包**。该包包含项目源码、Python 3.13.12 和已经配置好的 Python 依赖，不使用系统 Python，也不会在首次启动时联网解析或重装依赖；模型文件不包含在包内。由于整合包很大，Release 中会拆成多个 `.part###` 文件，必须全部下载到同一目录。

1. 将所有 `sd-webui-forge-neo-agent.zip.part###`、`合并分卷.bat` 和 `merge-portable.ps1` 下载到同一目录。
2. 双击 `合并分卷.bat`，脚本只会合并生成 `sd-webui-forge-neo-agent.zip`，不会自动解压。之后由你自行选择解压工具和目标位置。请预留至少 20 GB 磁盘空间。
3. 在新目录双击根目录的 `启动器.exe`；也可以双击 `webui/webui.bat` 直接启动。
4. 在 WebUI 的开源社区模型下载器中下载所需模型。

如需自行从源码部署：

```bash
git clone https://github.com/exo101/sd-webui-forge-neo-agent.git
cd sd-webui-forge-neo-agent
```

源码仓库不包含独立 Python 环境。开发者可在已有完整 `system/python` 的工作副本双击根目录的 `一键打包.bat`，使用内置 Python 自动生成 `dist/sd-webui-forge-neo-agent.zip.part###` 分卷和合并脚本；发现旧打包产物时会先询问是否删除并重建。也可运行 `system/python/python.exe scripts/package_portable.py` 手动打包。打包时会排除模型权重、生成结果、缓存和 Git 历史。模型需在安装后自行下载。

GitHub Release 的单个附件有 2 GiB 上限，因此打包脚本会把完整 ZIP 拆成多个小于 1.8 GiB 的附件，并在 `dist/` 同时生成合并脚本。发布时将所有 `.part###` 文件、`合并分卷.bat` 和 `merge-portable.ps1` 一并上传。

### 智能启动器

启动器采用 PyQt6 开发，提供以下功能模块：

| 功能 | 说明 |
|------|------|
| **⚡ 启动/停止** | 一键启动或停止 WebUI |
| **🌐 页面** | 打开 WebUI 的浏览器界面 |
| **🔄 检查更新** | 自动检测 GitHub 最新版本 |
| **🛑 全部停止** | 强制停止所有相关进程 |

| 标签页 | 功能 |
|--------|------|
| **环境检测** | GPU 型号、显存大小、驱动版本、系统资源 |
| **模型管理** | 模型目录结构说明、下载指南 |
| **扩展管理** | 已安装扩展列表、启用/禁用 |
| **参数设置** | 代理配置、启动参数、性能选项 |
| **运行日志** | 实时日志输出、错误诊断 |

### 常见问题

| 问题 | 解答 |
|------|------|
| **独立环境包无法启动？** | 解压完整后从根目录启动；确认杀毒软件未隔离 `system/python` 内文件，并安装最新 NVIDIA 驱动 |
| **使用源码包启动提示缺少依赖？** | 源码 ZIP 不含 Python 环境；请使用 Releases 中的独立环境整合包，或自行按开发文档配置环境 |
| **浏览器显示"无法访问此网站"？** | 检查启动器日志，确认端口 7869 未被占用，或点击启动器"页面"按钮手动打开 |
| **生成图片时提示"显存不足"？** | 启用"显存防溢出保护"，降低分辨率，使用 FP8 量化模型 |
| **生成的图片全黑或质量差？** | 确认选择了正确的模型，检查提示词，尝试换采样器（如 `Euler a`），增加采样步数 |
| **如何更新到最新版本？** | 在启动器主控台点击"检查启动器更新"，或重新 `git pull` |

---

## 🧠 内核区

> 内核区介绍本项目基于 Forge 框架所做的底层优化，包括性能加速、显存优化和功能增强。

### 核心优化

- **ComfyUI 后端重写** — 内存管理、模型补丁、注意力机制全面优化
- **模型加载优化** — 加速启动和模型切换
- **内存泄漏修复** — 切换 checkpoint 时的内存问题
- **uv 包管理器支持** — 大幅加速依赖安装

### 注意力加速

| 优化项 | 说明 |
|--------|------|
| **SageAttention** | 新一代注意力优化，显存占用极低 |
| **FlashAttention** | 高速注意力计算 |
| **xFormers** | 内存高效的注意力实现 |
| **Triton 内核** | int8 矩阵乘法加速 |

### 推理加速

- **Spectrum** — 免训练加速所有模型，即开即用
- **TAESD 实时预览** — 所有模型支持实时预览
- **半精度上采样器** — 加速上采样过程
- **GPU 瓦片合成** — 加速高分辨率图像合成
- **PyTorch 编译加速** — 使用 `torch.compile` 加速推理

### 显存优化策略

| 显存大小 | 推荐配置 | 支持模型 |
|---------|---------|---------|
| **4-6 GB** | TAESD + 分块处理 | SD1.5, SD2.1 |
| **8 GB** | 默认配置 | SDXL, Flux.2-Klein 4B |
| **12 GB** | 全功能 | Flux, Anima,  |
| **16 GB+** | 无限制 | Qwen-Image, Flux.2-Klein 9B |

### 其他增强

- **显存防溢出保护** — 防止显存溢出导致的崩溃，支持 UNet/VAE 分块处理
- **多图拼接参考** — 多图像拼接与参考功能
- **种子多样性增强** — 改善蒸馏模型的种子多样性
- **调制引导控制** — 改善 Anima 模型的生成质量
- **支持更多图像格式** — .avif、.heif、.jxl
- **X/Y/Z 图自动行计数优化**

---

## 🎨 模型区

> [!TIP]
> 模型下载器会根据模型类型自动下载组件并放置到正确目录，无需手动维护模型文件结构。导出视频仍需要安装 **[FFmpeg](https://ffmpeg.org/)**。

### 模型下载

| 模型 | 下载方式 | 说明 |
|------|---------|------|
| **SD1.5 / SDXL** | Civitai Helper 插件一键下载 | Stable-diffusion |
| **LoRA** | Civitai Helper 插件一键下载 | 风格/角色微调 |
| **ControlNet** | Civitai Helper 插件一键下载 | 控制网络 |
| **Flux CLIP** | [HuggingFace 手动下载](https://huggingface.co/comfyanonymous/flux_text_encoders/tree/main/clip_l.safetensors) | 放入 `models/clip/` |
| **Flux T5** | [HuggingFace 手动下载](https://huggingface.co/comfyanonymous/flux_text_encoders/tree/main/t5xxl_fp8_e4m3fn.safetensors) | 放入 `models/text_encoder/` |

---

## 🧩 已集成扩展列表

> 以下是 `webui/extensions/` 目录下已集成的全部扩展，开箱即用，无需自行安装。

| 扩展目录 | 用途简述 |
|---------|---------|
| **aadetailer-neoforge** | ADetailer 人脸/手部自动修复 |
| **forge-h3-studio** | H3 Studio 全栈视听工作台：视频生成、关键帧提取、声音合成（Breeze-TTS）、音乐生成（ACE-Step） |
| **infinite-browsing** | 无限图像浏览，快速查看历史生成图 |
| **sd-civitai-browser-neo** | Civitai 模型在线浏览与一键下载 |
| **sd-dynamic-prompts_neo** | 动态提示词模板，支持变量与逻辑分支 |
| **sd-forge-regional-prompter-neo** | 区域提示词，分区域控制画面内容 |
| **sd-forge-tutorial** | 内置新手图文教程 |
| **sd-webui-agent-dev-2.5** | 智能体 Agent，支持自然语言对话式生图 |
| **sd-webui-bsk-camera-control-forge-neo** | 3D 相机角度选择器，多角度提示词 |
| **sd-webui-model_downloader** | 模型批量下载工具 |
| **sd-webui-image-recognition-tagger** | 图像识别、反向提示词和标签生成 |
| **sd-webui-openpose-editor** | OpenPose 姿态可视化编辑器 |
| **sd-webui-ps-plugin-api** | Photoshop 插件对接 API，PS 内直接生图 |
| **sd-webui-see-through-sam** | See-Through 人物图层分离与 PSD 导出 |
| **sd-webui-tagcomplete-prompt-all-in-one** | 提示词补全、翻译和提示词工具整合 |
| **sd-webui-supermerger-forgeneo-anima** | SuperMerger 模型合并/融合 |
| **sd-webui-trellis2** | TRELLIS.2 单图生成 3D 模型 |
| **stable-diffusion-webui-localization-zh_Hans** | 中文汉化语言包 |
| **sd-forge-tutorial** | WebUI 使用教程 |
| **sd-webui-DLSS5-seedvr2** | DLSS/SeedVR2 视频超分与插帧 |

> [!TIP]
> 所有扩展均位于 `webui/extensions/`，可在 WebUI 的 **Extensions** 页面单独启用或禁用；删除对应文件夹即可彻底卸载。

---

## 📚 学习资源

- **视频教程**: [B站教程合集](https://www.bilibili.com/video/BV1L9hY6PEJG/?spm_id_from=333.1387.homepage.video_card.click&vd_source=343e49b703fb5b4137cd6c1987846f37)
- **Wiki**: [Haoming02 Wiki](https://github.com/Haoming02/sd-webui-forge-classic/wiki)

---

## 🤝 社区支持

### QQ 交流群

<img src="launcher/qq群ai交流群.jpg" alt="QQ交流群" width="200"/>

扫码加入 AI 交流群，获取最新整合包、使用技巧和问题解答。

| 群号 | 说明 |
|------|------|
| **1040349057** | QQ 交流 2 群 |
| **568457487** | QQ 交流 3 群 |
| **1057489693** | QQ 交流 4 群 |

### B站频道

关注 [哔哩哔哩（鸡肉爱土豆）](https://space.bilibili.com/403361177) 获取最新教程和更新通知。

---

## 🙏 致谢

- **Haoming02** — [sd-webui-forge-classic](https://github.com/Haoming02/sd-webui-forge-classic) 分支作者
- **AUTOMATIC1111** — Stable Diffusion WebUI 原始项目
- **lllyasviel** — Forge 优化框架
- **comfyanonymous** — ComfyUI 项目
- **kijai**、**city96** — 社区贡献者
- 所有开源图像生成社区的贡献者

---

## 📄 许可证

本项目遵循 AGPL-3.0 许可证。详情请参阅 [LICENSE](LICENSE) 文件。

> [!NOTE]
> 此版本整合包通过秋叶aaaki、张吕敏、Haoming02 等多位大佬技术总结做出的版本，不属于任何个人、企业，是非盈利性质的开源软件。

---

<div align="center">

**⭐ 如果这个项目对您有帮助，请给个 Star 支持一下！⭐**

Made with ❤️ by exo101

</div>