如果你刚接触 AI 绘画,可能已经听说过 Stable Diffusion WebUI,但 ComfyUI 提供了一个更直观、更可控的节点式工作流界面。秋叶最新发布的整合包,最大的价值在于解决了 ComfyUI 原本对中文用户不够友好的问题——全中文界面、中文提示词支持,并且支持 Windows 和 macOS 一键安装、解压即用。
这篇文章不会只给你一个整合包下载链接就结束。我会结合自己多次部署、调试 ComfyUI 的经验,从环境准备、安装验证、基础工作流搭建,到常见问题排查,带你走一遍完整流程。目标很明确:让你能在自己的机器上稳定跑起来,并且理解每个环节为什么这么做。
1. 环境准备:别急着下载,先确认你的机器能跑
ComfyUI 作为 Stable Diffusion 的一种界面实现,核心还是依赖 PyTorch 和相应的图像生成模型。秋叶整合包虽然做了很多封装,但硬件的兼容性仍然是第一道坎。
1.1 硬件底线:显存、内存和磁盘空间
显卡(GPU):ComfyUI 能利用 NVIDIA 显卡的 CUDA 加速。如果你的机器是 NVIDIA 显卡,且显存在 4GB 或以上,通常可以流畅运行基础模型(如 SD1.5)。如果显存只有 2GB,可能需要启用--lowvram参数,或使用更小的模型。
- 判断方式:在 Windows 上,打开任务管理器 > 性能 > GPU,查看“专用 GPU 内存”。在 macOS 上,关于本机 > 系统报告 > 图形/显示器。
- 注意:如果你的显卡是 AMD 或 Intel 集成显卡,ComfyUI 也能用 CPU 跑,但速度会慢很多,更适合学习工作流,不适合批量出图。
内存:建议 16GB 或以上。模型加载、图像缓存都会占用系统内存。如果内存不足,容易出现生成过程中卡死或崩溃。
磁盘空间:整合包本身大约 3-5GB,但你需要额外预留 10-20GB 存放模型(基础模型、LoRA、VAE 等)。建议至少保留 30GB 可用空间。
1.2 系统与依赖:Windows 和 macOS 的细微差异
秋叶整合包已经内置了 Python 和必要依赖,所以你不必单独配置 Python 环境。但下面几点仍需提前确认:
Windows 系统:
- 确保你的系统是 Windows 10 或 Windows 11。
- 关闭可能拦截执行文件的安全软件(如某些第三方杀毒软件),避免误删启动脚本。
- 如果之前安装过其他 AI 绘画工具(如 Stable Diffusion WebUI),建议关闭它们,避免端口冲突。
macOS 系统:
- 支持 Intel 芯片和 Apple Silicon(M1/M2/M3)。
- 如果系统提示“无法打开,因为来自不受信任的开发者”,需要到“系统设置”>“隐私与安全性”中允许该应用。
- 对于 macOS 15.7 等较新版本,若遇到“无法启用系统扩展”提示,通常是因为权限设置,并非整合包本身问题。
通用准备:
- 解压软件:建议使用 Bandizip、7-Zip 或 macOS 自带的归档实用工具,避免解压时文件损坏。
- 路径规范:解压路径不要包含中文或特殊字符(如
C:\AI\ComfyUI或/Users/YourName/Applications/ComfyUI),否则可能导致模型加载失败。
2. 安装与首次启动:从解压到看见界面
秋叶整合包的设计是“解压即用”,但“即用”不代表一点配置都不需要。我习惯把第一次启动拆成三步:解压 → 启动 → 验证基础功能。
2.1 解压与目录结构
下载整合包后,右键解压到你准备的路径。解压完成后,目录通常包含以下关键内容:
ComfyUI_windows/ 或 ComfyUI_macos/ ├── ComfyUI.exe(Windows)或 ComfyUI.app(macOS) # 主启动文件 ├── models/ # 模型存放目录 │ ├── checkpoints/ # 放置基础模型(.safetensors 或 .ckpt) │ ├── loras/ # 放置 LoRA 模型 │ └── vae/ # 放置 VAE 模型 ├── log.txt # 运行日志 └── 其他配置文件及资源重要:整合包可能不包含大体积模型文件( due to 版权和体积限制),你需要自行下载基础模型并放入对应目录。常用基础模型如v1-5-pruned-emaonly.safetensors(约 4GB)可从 Civitai 或 Hugging Face 下载。
2.2 启动流程与初始界面
Windows:双击ComfyUI.exe,会弹出一个命令行窗口,然后自动打开浏览器(通常是 http://127.0.0.1:8188)。如果浏览器没有自动打开,你可以手动输入这个地址。
macOS:双击ComfyUI.app,启动后同样在浏览器中访问 http://127.0.0.1:8188。
第一次启动时,注意观察命令行窗口:
- 如果出现大量下载进度条,是在自动安装依赖,属于正常现象。
- 如果卡在某个步骤超过 5 分钟,或出现红色错误信息,可能是网络问题或环境冲突(后面会讲排查方法)。
- 成功加载后,命令行最后会显示类似 “* Running on http://127.0.0.1:8188” 的信息。
浏览器打开后,你应该看到 ComfyUI 的节点编辑器界面,并且菜单、按钮已经是中文。这就是整合包的核心优化之一。
2.3 加载基础模型,完成第一次生成
界面是中文的,但工作流需要自己搭建。为了验证安装成功,我们先加载一个最简单的文本生成图像流程:
- 在空白处右键,选择“添加节点” > “采样器” > “KSampler”。
- 再次右键,“添加节点” > “加载器” > “Checkpoint加载器”。
- 连接 Checkpoint加载器的“模型”输出到 KSampler 的“模型”输入。
- 在 Checkpoint加载器下拉菜单中,选择你放在
models/checkpoints/里的模型文件。 - 在 KSampler 中设置参数(初次测试可先用默认值:采样步数 20,CFG 尺度 7)。
- 右键添加“CLIP文本编码器”,将“正面提示词”连接至 KSampler 的“正面提示词”。
- 在 CLIP文本编码器中输入简单中文提示词,如“一只猫”。
- 添加“VAE解码器”和“保存图像”节点,并正确连接。
- 点击“队列提示”,开始生成。
如果一切正常,右下角会显示生成进度,完成后在输出目录找到图片。这个流程能跑通,说明 ComfyUI 核心功能已就绪。
3. 工作流入门:理解节点,而不仅是点按钮
ComfyUI 和 WebUI 的最大区别在于,一切操作都是节点连接。很多人刚开始会觉得复杂,但一旦理解基本逻辑,反而更灵活。
3.1 核心节点类型与功能
- 加载器节点:负责加载模型、LoRA、VAE、ControlNet 等。每个加载器对应一种资源类型。
- 编码器节点:如 CLIP 文本编码器,将你的提示词(包括中文)转换为模型能理解的向量。
- 采样器节点:如 KSampler,控制生成过程的迭代步数、采样方法、种子等参数。
- 图像处理节点:包括加载图像、缩放、裁剪、VAE 解码、保存等。
- 条件控制节点:如 ControlNet,用于姿势、边缘、深度等控制。
连接逻辑:数据从输出端口(右侧)流向输入端口(左侧)。每个节点完成特定处理,并将结果传递给下一个节点。
3.2 使用秋叶整合包预置的工作流
秋叶整合包通常会附带一些示例工作流(.json 文件)。你可以通过“加载”按钮导入这些工作流,然后观察节点是如何组织的。这是学习复杂流程的最快方式。
导入工作流后,不要直接点击生成。先逐个节点查看参数,理解连接关系。然后尝试修改提示词、调整采样步数或更换模型,观察变化。
3.3 从零搭建一个可控生成流程
当你熟悉基础节点后,可以尝试搭建一个支持 LoRA 和 ControlNet 的流程:
- 放置 Checkpoint加载器、VAE加载器、LoRA加载器,并串联起来。
- 添加两个 CLIP文本编码器(正面和负面提示词)。
- 添加 KSampler,连接模型和提示词。
- 添加 ControlNet 应用节点,连接预处理器和模型。
- 最后接 VAE解码器和保存图像。
这个流程比基础生成多了条件控制,但节点逻辑清晰。关键是每一步都知道为什么连接:LoRA 微调模型风格,ControlNet 约束图像结构。
4. 中文提示词与界面优化
秋叶整合包对中文的支持主要体现在两方面:界面汉化和提示词编码优化。
4.1 中文提示词的输入与处理
在 CLIP 文本编码器中,你可以直接输入中文提示词,如“一座雪山,清晨阳光,细节丰富”。整合包内置的汉化插件会自动处理编码问题。
但要注意,模型本身是在英文数据上训练的,所以复杂或抽象的中文提示词可能效果不如英文精确。建议:
- 重要元素用中文描述,搭配少量英文关键词(如“masterpiece, best quality”)。
- 如果生成结果不理想,可以尝试将中文提示词翻译成英文再试。
4.2 界面汉化与自定义
汉化覆盖了大多数常用节点和菜单。如果某个插件或节点没有汉化,可能是该插件版本较新,可以后续手动更新汉化文件。
汉化文件通常位于custom_nodes/下的相关目录。如果熟悉 JSON 格式,你可以自行修改汉化内容。
5. 常见问题与排查顺序
即使使用整合包,也可能遇到启动失败、生成报错、资源占用过高等问题。下面是我常用的排查顺序。
5.1 启动阶段问题
现象:双击启动器无反应,或命令行闪退。
- 检查路径:确保解压路径无中文和特殊字符。
- 查看日志:打开 log.txt,查看最后几行错误信息。常见错误包括模型文件损坏、端口被占用。
- 端口占用:ComfyUI 默认使用 8188 端口。如果该端口被其他程序占用,可以修改启动参数,或关闭占用端口的程序。
现象:启动后浏览器无法打开界面。
- 手动输入地址:尝试 http://localhost:8188 或 http://127.0.0.1:8188。
- 防火墙提示:Windows 防火墙可能弹出提示,选择允许访问。
- 检查命令行:确认命令行显示 “Running on” 信息,并且没有红色错误。
5.2 模型加载与生成错误
现象:生成时报错,提示模型加载失败。
- 模型路径:确认模型文件已放入正确的
models/子目录。 - 文件完整性:大文件下载可能不完整,重新下载或验证哈希值。
- 模型兼容性:某些模型需要特定 VAE 或插件支持,查看模型说明页。
现象:生成速度极慢,或显存不足。
- 降低分辨率:将生成分辨率从 1024x1024 降至 512x512。
- 启用低显存模式:在启动参数中添加
--lowvram或--novram。 - 关闭其他程序:释放显卡资源。
5.3 工作流加载错误
现象:导入他人工作流时报错,节点丢失。
- 缺少插件:工作流可能依赖特定自定义节点。根据错误信息安装对应插件。
- 版本不兼容:ComfyUI 或插件版本过低,更新到最新版。
通用建议:保持整合包和插件更新,但不要频繁更新生产环境的工作流,避免引入不稳定因素。
6. 生产化建议:从学习到稳定使用
当你能够顺利运行 ComfyUI 后,如果计划长期使用,下面几点建议可以让体验更稳定。
6.1 资源管理
- 模型分类存放:按类型(基础模型、LoRA、ControlNet)和用途分类,避免混乱。
- 定期清理输出:生成图片会占用大量磁盘空间,设置自动清理或归档策略。
- 备份工作流:将调试好的工作流导出为 .json 文件,并备注参数说明。
6.2 性能调优
- 批量生成:使用队列或批处理节点,避免频繁手动点击。
- 分辨率与步数平衡:高质量输出需要高分辨率和高步数,但会显著增加时间。根据实际需求调整。
- 使用预览节点:在流程中间插入图像预览节点,实时查看生成效果,避免浪费资源。
6.3 插件生态
ComfyUI 有丰富的插件生态,如效率工具、风格控制、视频生成等。通过“管理器”安装插件时,注意:
- 选择下载量高、更新频繁的插件。
- 一次只安装一个插件,测试稳定后再装下一个。
- 关注插件依赖和兼容性说明。
秋叶整合包已经包含了一些常用插件,你可以在custom_nodes/目录下查看。
ComfyUI 的节点式工作流初期需要一点学习成本,但一旦掌握,你会对生成过程有更细致的控制。秋叶整合包的价值在于降低了中文用户的上手门槛。不过,整合包虽方便,也要理解底层原理,这样遇到问题时才能快速定位。