在 Stable Diffusion 的生态中,WebUI 以其直观的图形界面降低了入门门槛,但随着工作流复杂度的提升,其节点式、模块化的操作逻辑逐渐显得力不从心。ComfyUI 作为一款基于节点流程的 Stable Diffusion 图形界面,凭借其极高的灵活性、可复现性和对复杂工作流的强大支持,正成为进阶用户和追求效率的生产者的首选。然而,其原版界面为英文,节点名称和提示词输入对中文用户不够友好,手动配置 Python 环境、管理依赖和插件也颇具挑战。针对这一痛点,由国内开发者“秋叶aaaki”制作并维护的 ComfyUI 中文整合包,提供了一个开箱即用的解决方案。它集成了汉化界面、常用插件、模型管理和一键启动脚本,大幅简化了在 Windows 和 macOS 系统上的部署流程。
本文将围绕“秋叶 ComfyUI 中文整合包”,详细解析其核心价值、安装部署步骤、基础使用方法,并深入探讨如何利用其模块化特性构建稳定高效的工作流。无论你是希望从 WebUI 迁移至更高效工具的用户,还是初次接触 ComfyUI 的新手,本文都将提供一个从环境搭建到实际出图的完整实践路径。
1. 理解 ComfyUI 的核心优势与秋叶整合包的价值
在深入安装步骤之前,有必要先厘清 ComfyUI 本身的设计哲学,以及秋叶整合包在此基础上解决了哪些具体问题。这有助于你在后续使用中更好地理解每个操作背后的逻辑,而非机械地点击节点。
1.1 ComfyUI 为何是进阶之选:节点化与确定性
与 WebUI 的“文生图”、“图生图”等固定标签页不同,ComfyUI 将 Stable Diffusion 的整个生成过程拆解为一个个功能单一的节点(Node)。例如,加载模型是一个节点,编码提示词是一个节点,执行采样又是一个节点。这些节点通过连线(Workflow)组合起来,形成一个完整的图像生成管道。
这种设计带来了两大核心优势:
- 极致灵活与可定制性:你可以像搭积木一样,自由组合、替换或插入任何节点。想尝试新的采样器、新的 ControlNet 预处理器,或者自定义一个复杂的多阶段生成流程,在 ComfyUI 中都可以通过拖拽节点轻松实现。
- 工作流的可保存与可复现:整个节点连线图可以保存为一个
.json或.png文件。这意味着任何复杂的生成流程(包括所有参数、模型选择)都可以被精确记录和分享。其他人加载你的工作流文件,在相同模型和环境下,能获得完全一致的输出结果,这对于团队协作和流程标准化至关重要。
1.2 秋叶整合包解决了哪些原生痛点
尽管强大,原版 ComfyUI 对新手和中文用户存在一定门槛:
- 环境配置复杂:需要手动安装 Python、Git、并处理各种依赖冲突。
- 界面语言障碍:所有节点、菜单、提示词均为英文,增加了学习成本。
- 插件管理分散:需要用户自行寻找、下载并正确放置插件文件,容易出错。
- 模型路径混乱:需要手动配置或理解复杂的模型文件夹结构。
秋叶整合包针对性地提供了以下增强:
- 一键安装与启动:封装了所有必要运行环境(Python、PyTorch、依赖库),提供
启动器.exe(Windows)或启动脚本(macOS),解压即用。 - 全面中文化:对界面、节点名称、工具提示进行了汉化,支持直接输入中文提示词(内部会通过翻译插件或 CLIP 编码器处理)。
- 预置精选插件:集成了如
ComfyUI Manager(插件管理器)、Impact Pack(高级节点包)、WD14 Tagger(图像标签反推)等大量实用插件,无需额外配置。 - 便捷的模型管理:启动器内通常集成模型下载功能,或已配置好指向
stable-diffusion-webui的模型路径,方便模型复用。 - 问题排查工具:启动器可能包含环境修复、依赖安装、错误日志查看等辅助功能。
简单来说,秋叶整合包的目标是让用户专注于学习和使用 ComfyUI 本身,而非浪费在环境配置和语言障碍上。
2. 环境准备与整合包获取
在开始安装前,请确保你的系统满足基本要求,并正确获取整合包资源。
2.1 系统与硬件要求
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10/11 64位,或 macOS 10.15+ | Windows 10/11 64位,或 macOS 12+ |
| 处理器 | 支持 AVX 指令集的 CPU | 多核处理器(如 Intel i5/R5 及以上) |
| 内存 | 8 GB RAM | 16 GB RAM 或更高 |
| 显卡 | 支持 DirectX 12 的显卡(Windows) | NVIDIA GPU,显存 ≥ 4GB(CUDA 加速) |
| 存储空间 | 至少 20 GB 可用空间(用于安装包和基础模型) | 50 GB 以上 SSD 空间(用于存放多个模型) |
| 网络 | 需要下载整合包(约 10-20 GB)及后续模型 | 稳定的网络连接 |
注意:虽然 ComfyUI 支持 CPU 和 AMD 显卡(通过 DirectML 或 ROCm),但秋叶整合包默认优化路径通常基于NVIDIA CUDA。使用 CPU 或 AMD 显卡可能会遇到性能问题或需要额外配置,本文主要围绕 NVIDIA GPU 环境展开。
2.2 下载秋叶 ComfyUI 整合包
由于整合包体积较大,通常通过网盘分享。请通过可靠的社区、论坛或视频描述链接获取。常见的整合包命名格式如ComfyUI-秋叶整合包-vX.X.7z或ComfyUI-秋叶整合包-vX.X.zip,其中X.X为版本号。
下载时请注意:
- 核对版本:尽量获取最新版本,以包含最新的 ComfyUI 核心、插件和汉化。
- 验证文件完整性:下载完成后,核对文件的 MD5 或 SHA1 校验码(如果发布者提供了的话),确保文件未损坏。
- 预留空间:确保解压目标磁盘有充足空间(建议预留 30GB+)。
3. Windows 系统安装与配置详解
Windows 是秋叶整合包的主要支持平台,其提供的图形化启动器极大简化了操作。
3.1 解压与目录结构
- 将下载的
.7z或.zip压缩包,解压到一个路径中不含中文和特殊字符的目录。例如D:\AI\ComfyUI。这是为了避免后续 Python 或插件因路径编码问题报错。 - 解压后,典型的目录结构如下:
ComfyUI-秋叶整合包/ ├── ComfyUI/ # ComfyUI 核心程序目录 ├── python_embeded/ # 内置的 Python 环境 ├── 启动器.exe # 图形化启动与管理工具 ├── 启动器运行依赖.exe # 首次运行可能需要安装 └── 其他说明文档.txt
3.2 首次启动与初始化
- 双击运行
启动器.exe。如果系统提示缺少运行库,请先运行启动器运行依赖.exe。 - 启动器界面通常会显示几个关键区域:
- 一键启动:主按钮,用于启动 ComfyUI。
- 高级选项:可能包含修复环境、安装依赖、自定义参数等。
- 版本管理:切换 ComfyUI 核心或插件的版本。
- 模型管理:下载或配置模型路径。
- 首次启动时,建议先点击“高级选项”或类似按钮,进行以下操作(如果提供):
- 环境修复:确保所有 Python 依赖已正确安装。
- 安装依赖:为预置插件安装必要的 Python 包。
- 完成初始化后,返回主界面,点击“一键启动”。这将自动打开一个命令行窗口,并启动 ComfyUI 服务。
3.3 验证安装与访问界面
- 当命令行窗口显示类似以下信息时,表示启动成功:
[2024-08-XX] [INFO] Starting server [2024-08-XX] [INFO] To see the GUI go to: http://127.0.0.1:8188 - 打开你的浏览器(推荐 Chrome 或 Edge),访问
http://127.0.0.1:8188。 - 如果看到全中文的 ComfyUI 界面,并且左侧节点列表中有大量已汉化的节点(如“加载检查点”、“CLIP文本编码器”、“KSampler”等),则说明整合包安装成功。
3.4 配置模型路径(关键步骤)
默认情况下,整合包可能已配置好模型目录。但为了与你已有的stable-diffusion-webui模型共享,或自定义路径,你需要了解如何配置。
- 在 ComfyUI 根目录下,找到
extra_model_paths.yaml.example文件,将其复制并重命名为extra_model_paths.yaml。 - 用文本编辑器(如 Notepad++)打开
extra_model_paths.yaml。你会看到类似以下内容:# 这是一个示例配置,取消注释并修改路径以指向你的 WebUI 模型目录 # a111: # base_path: D:\sd-webui-aki\sd-webui # checkpoints: models/Stable-diffusion # vae: models/VAE # loras: models/Lora # upscale_models: models/ESRGAN - 取消注释(删除行首的
#和空格),并将base_path修改为你本地stable-diffusion-webui的实际安装路径。例如:a111: base_path: D:\sd-webui-aki-v4\sd-webui checkpoints: models/Stable-diffusion vae: models/VAE loras: models/Lora upscale_models: models/ESRGAN - 保存文件。重启 ComfyUI后,你就可以在节点中直接选择 WebUI 目录下已有的模型、VAE、LoRA 了。
4. macOS 系统安装与配置指南
macOS 下的安装过程与 Windows 类似,但通常以命令行脚本为主。
4.1 解压与权限设置
- 将整合包解压到应用程序文件夹或你的用户目录下,例如
~/Applications/ComfyUI。 - 打开“终端”(Terminal)应用。
- 使用
cd命令进入解压后的整合包目录:cd ~/Applications/ComfyUI - 为启动脚本添加执行权限(如果存在):
chmod +x run.sh # 或类似名称的脚本,如 start_mac.sh
4.2 通过脚本启动
- 在终端中,运行启动脚本:
或者直接使用 Python 启动(如果脚本不可用):./run.sh./python_embeded/bin/python3 main.py - 终端会开始加载依赖并启动服务。同样,当看到
To see the GUI go to: http://127.0.0.1:8188时,启动成功。 - 在 macOS 的浏览器中访问
http://127.0.0.1:8188。
4.3 macOS 特定注意事项
- Apple Silicon (M1/M2/M3):整合包应已包含适配的 PyTorch 版本。如果遇到问题,可能需要通过
ComfyUI Manager重新安装特定插件或依赖。 - 模型路径:配置
extra_model_paths.yaml的方法与 Windows 完全相同,只需将base_path改为 macOS 下的路径,例如/Users/你的用户名/sd-webui。 - 性能:在 Apple Silicon Mac 上,使用 CPU 或 GPU(Metal)后端。性能通常弱于同价位 NVIDIA GPU,但对于基础出图和学习是足够的。
5. ComfyUI 中文版基础使用与核心工作流构建
成功启动后,面对满屏的节点,第一步是理解最基础的文生图工作流是如何构建的。
5.1 界面布局与核心概念
- 节点面板:左侧区域,所有可用的节点按类别(如“加载器”、“条件”、“采样器”)排列。秋叶整合包已将其汉化。
- 画布:中间主区域,用于拖放和连接节点。
- 右键菜单:在画布空白处右键,可以快速搜索并添加节点,这是最高效的操作方式。
- 节点:每个节点有输入槽(左侧,通常为灰色或紫色)和输出槽(右侧,通常为绿色)。连线表示数据流向。
- 队列:点击“队列提示”开始执行当前工作流。点击“中断”可停止生成。
5.2 构建一个最小文生图工作流
让我们手动搭建一个最基础的工作流,以理解数据流向。
- 添加模型加载器:在画布右键 -> 搜索“加载检查点” -> 点击添加。这个节点负责加载 Stable Diffusion 模型。
- 添加提示词编码器:
- 右键搜索“CLIP文本编码器”,添加两个。一个用于正向提示词,一个用于负向提示词。
- 分别将它们的
clip输入口,连接到“加载检查点”节点的clip输出口。
- 添加采样器:
- 右键搜索“KSampler”或“采样器”,添加。
- 将
model连接到“加载检查点”的model。 - 将
positive和negative分别连接到两个 CLIP 编码器的conditioning输出。 - 设置采样参数:
steps(步数,如20),cfg(引导系数,如7.5),sampler_name(采样器,如euler),scheduler(调度器,如normal)。
- 添加潜在空间解码器:
- 右键搜索“VAE解码器”,添加。
- 将它的
samples输入连接到 KSampler 的LATENT输出。 - 将它的
vae输入连接到“加载检查点”节点的vae输出。
- 添加图像保存/预览:
- 右键搜索“保存图像”或“预览图像”,添加。
- 将它的
images输入连接到 VAE解码器的IMAGE输出。
- 设置提示词并生成:
- 在两个 CLIP文本编码器的
text输入框中,分别输入正向和负向提示词。 - 在 KSampler 的
seed输入框,可以输入固定种子或随机数。 - 点击“队列提示”。如果一切正常,你将在“保存图像”节点处看到生成的图片。
- 在两个 CLIP文本编码器的
5.3 使用秋叶整合包的预置工作流
手动搭建是学习的最佳方式,但秋叶整合包通常预置了许多实用工作流(.json或.png文件)。你可以直接加载它们:
- 点击界面右上角的“加载”按钮。
- 在弹出的文件对话框中,导航到整合包内可能存在的
workflows或examples文件夹。 - 选择一个工作流文件(如
basic_text_to_image.json)并打开。 - 画布上会自动加载所有节点和连线。你只需要替换提示词和模型,然后点击“队列提示”即可生成。
6. 高级功能与插件使用
秋叶整合包预置的插件是其核心价值之一,它们极大地扩展了 ComfyUI 的能力。
6.1 ComfyUI Manager:插件与模型管理中枢
这是最重要的插件之一,通常已集成在界面中(可能是一个单独的标签页或按钮)。
- 安装新插件:在 ComfyUI Manager 中,你可以浏览社区插件列表,一键安装。无需手动处理 Git 仓库。
- 更新现有插件/ComfyUI:Manager 可以检查并更新所有已安装插件及 ComfyUI 本身。
- 安装自定义节点:如果你从网上下载了单独的
.py节点文件,可以通过 Manager 的“安装自定义节点”功能来安装。 - 模型下载:部分 Manager 版本集成了模型下载功能,可以直接下载热门检查点、LoRA、VAE 等。
6.2 常用预置插件简介
- Impact Pack:提供了海量的实用节点,如人脸修复、细节提升、分段、姿势检测、图像批量处理等。是构建复杂工作流的必备工具包。
- WD14 Tagger:图像反推提示词插件。将图片拖入节点,可以自动生成描述性的标签,作为提示词的基础。
- ControlNet 预处理器:集成了 OpenPose、Canny、Depth、Scribble 等所有 ControlNet 所需的预处理器节点,方便与 ControlNet 模型配合使用。
- Efficiency Nodes:提供了一系列优化节点,如将常用节点组打包、优化执行流程等,可以简化工作流,提升可读性。
6.3 构建一个带 ControlNet 的图生图工作流
这是一个更复杂的例子,展示如何利用插件:
- 加载基础文生图流程(如 5.2 节所述)。
- 添加 ControlNet 应用节点:搜索“ControlNet应用”并添加。将其插入到 KSampler 的
positive条件输入之前。 - 添加 ControlNet 加载器:搜索“ControlNet加载器”,加载你想要的 ControlNet 模型(如
control_v11p_sd15_canny)。 - 添加预处理器:搜索“Canny边缘检测”节点。将你的输入图片连接到它的
image输入,它会输出处理后的边缘图。 - 连接 ControlNet:
- 将 ControlNet加载器的
control_net输出,连接到 ControlNet应用节点的control_net输入。 - 将预处理器的
IMAGE输出,连接到 ControlNet应用节点的image输入。 - 将 ControlNet应用节点的
conditioning输出,连接到 KSampler 的positive输入。
- 将 ControlNet加载器的
- 调整参数:在 ControlNet应用节点上,设置
strength(控制强度)等参数。 - 这样,生成的图像就会受到输入图片边缘结构的约束。
7. 常见问题排查与优化建议
即使使用整合包,在实际操作中仍可能遇到问题。以下是典型的排查路径。
7.1 启动与运行常见问题
| 问题现象 | 可能原因 | 检查与解决步骤 |
|---|---|---|
| 双击启动器无反应 | 1. 运行库缺失。 2. 文件路径含中文/特殊字符。 3. 被杀毒软件拦截。 | 1. 安装启动器运行依赖.exe。2. 移动整合包至纯英文路径。 3. 暂时关闭杀软或将目录加入白名单。 |
| 启动后命令行闪退 | 1. Python 依赖冲突或缺失。 2. 端口被占用。 3. 模型路径配置错误。 | 1. 查看comfyui.log或启动器日志。2. 通过启动器“高级选项”运行“环境修复”。 3. 检查 extra_model_paths.yaml格式和路径是否正确。 |
访问http://127.0.0.1:8188失败 | 1. 服务未成功启动。 2. 防火墙阻止。 | 1. 确认命令行窗口是否显示成功启动信息。 2. 尝试访问 http://localhost:8188。 |
| 加载模型时报错“KeyError”或“TypeError” | 1. 模型文件损坏或不兼容。 2. 模型类型放错文件夹。 | 1. 重新下载模型文件。 2. 确认检查点(.safetensors/.ckpt)放在 models/checkpoints目录。 |
| 生成图片纯黑或纯灰 | 1. 未加载 VAE。 2. 提示词冲突或模型不匹配。 | 1. 在“加载检查点”节点后显式连接一个 VAE 加载/解码节点。 2. 尝试简单的正向提示词(如“1girl”)。 |
| 生成速度异常慢 | 1. 使用 CPU 模式。 2. 显存不足,触发内存交换。 3. 图片分辨率设置过高。 | 1. 确认启动日志显示 CUDA 可用。 2. 降低分辨率,或使用 --lowvram参数启动。3. 在 KSampler 中使用较小的步数。 |
7.2 工作流使用技巧与优化
- 组织工作流:对于复杂工作流,使用“节点组”功能(框选节点后右键“创建节点组”)将其折叠,使画布更清晰。
- 使用队列:可以设置“队列数量”,一次性生成多张图片,无需重复点击。
- 保存与分享:定期使用“保存”按钮备份你的工作流(
.json)。分享时,可以同时导出为.png,该图片内嵌了完整的工作流信息,其他人可以直接拖入 ComfyUI 加载。 - 性能调优:
- 在“设置”中启用“持续缓存”,可以缓存已加载的模型,加快后续生成速度。
- 对于固定参数(如模型、VAE),尽量复用节点,而不是重复创建。
- 使用
ComfyUI Manager检查更新,新版可能包含性能优化。
7.3 模型与插件管理建议
- 模型分类存放:即使配置了 WebUI 路径,也建议在 ComfyUI 自己的
models文件夹下建立清晰子目录,如checkpoints,loras,vae,controlnet,便于管理。 - 插件更新策略:更新插件前,最好备份你的工作流。某些插件更新可能导致节点接口变化,使旧工作流失效。
- 问题溯源:当某个节点报错时,首先检查该节点的所有输入连接是否完整、数据类型是否匹配(如图像不能连到文本)。查看命令行窗口或日志文件,错误信息通常非常具体。
秋叶 ComfyUI 中文整合包通过精心的环境封装和汉化,将 ComfyUI 这个强大但略显晦涩的工具变得平易近人。从一键安装到开箱即用的中文界面,它解决了绝大多数初级和中级用户的环境障碍。然而,其核心价值——节点化工作流——的学习曲线依然存在。掌握 ComfyUI 的关键在于转变思维:从“选择功能标签页”转变为“构建数据处理管道”。
建议的学习路径是:先从加载一个预置工作流并成功出图开始,建立信心;然后拆解这个工作流,理解每个节点的作用;接着尝试手动重建一个简单文生图流程;最后再逐步引入 LoRA、ControlNet、高清修复等高级节点。过程中,多利用右键菜单搜索节点,多关注命令行窗口的日志输出,这是排查问题的最佳线索。随着你对节点间数据流动的理解加深,你将能够设计出满足任何复杂需求、且可重复、可优化的工作流,真正释放 Stable Diffusion 的生产力。