本地跑图这件事,说难不难,说简单也真能把人劝退。我见过太多人卡在第一步——环境配置,Python版本不对、Git拉不下来、依赖装到一半报错、CUDA和显卡驱动打架,折腾一整天连界面都没见着。所以当我第一次接触秋葉 aaaki 的整合包时,那种"解压就能用"的体验确实让人眼前一亮。这篇就围绕Stable Diffusion 新手本地跑图这个场景,把秋葉 aaaki v4.10 整合包从下载、解压、启动到出第一张图的完整链路拆开讲清楚,顺带把新手最容易踩的坑、参数怎么调、显存不够怎么办这些实际问题一并说透。不管你是完全没碰过命令行的纯小白,还是装过原版被环境折磨过的老哥,这篇都能让你少走弯路。
1. 为什么新手该从整合包入手而不是原版
1.1 原版部署到底难在哪
Stable Diffusion 的官方 WebUI 本质是一个 Python 项目,它依赖一长串东西:特定版本的 Python 解释器、PyTorch 框架、CUDA 运行时、xformers 加速库、Git 版本管理工具,还有几十个 pip 包。这些东西之间版本耦合非常紧,比如 PyTorch 的版本必须和 CUDA 版本匹配,CUDA 版本又受显卡驱动版本限制,xformers 又对 PyTorch 版本挑剔。任何一个环节版本对不上,轻则报错,重则直接跑不起来。
我印象最深的一次,是帮一个朋友装原版,他的显卡是 RTX 3060 12G,驱动比较旧,结果 PyTorch 装的是 cu121 版本,但驱动只支持到 cu118,启动时直接提示 CUDA 不可用,回退到 CPU 模式,出一张 512x512 的图要等三分钟。这种问题对老手来说排查起来都要花点时间,对新手基本就是劝退级别的打击。
整合包做的事情,就是把这些版本关系全部预先锁定好,打包成一个自包含的目录。它内置了便携版 Python、预编译好的 PyTorch、匹配的 CUDA 运行时,甚至连启动脚本都写好了。你不需要懂 pip,不需要懂 CUDA,解压完双击一个 bat 文件就能跑。
1.2 秋葉整合包的核心优势
秋葉 aaaki 这个整合包在国内圈子里口碑一直不错,核心原因有几个。第一是开箱即用,它把 Python、Git、CUDA 运行时全部内置在包内,不污染系统环境,你电脑上原本装没装 Python 都不影响。第二是预装插件和模型,包里通常已经带了中文界面、常用采样器、VAE、以及一个基础的大模型,解压后不用额外下载就能出图。第三是启动脚本做了大量兼容处理,比如自动检测显卡、自动设置显存优化参数、自动处理路径中文问题。
v4.10 这个版本在稳定性上做了不少改进,尤其是对 40 系显卡和新版驱动的兼容性。它内置的启动器界面也比早期版本友好很多,有一键更新、模型管理、参数预设这些功能,对新手来说省去了手动改配置文件的麻烦。
1.3 整合包适合谁,不适合谁
整合包最适合三类人:一是完全没接触过 Python 环境的新手,二是想快速验证效果不想折腾环境的创作者,三是电脑配置一般、需要现成显存优化方案的用户。
但它也不是万能的。如果你需要深度定制、要改源码、要跑最新的实验性功能,整合包反而会限制你,因为它的依赖是锁死的,升级某个组件可能破坏整体兼容性。另外整合包体积通常很大,动辄十几个 G,硬盘空间要留够。
提示:整合包本质是"预配置好的环境快照",它的价值在于省去配置时间,而不是替代你理解原理。想长期玩下去,还是建议逐步了解 Python 环境和依赖管理的基本概念。
2. 下载与解压:新手最容易翻车的两个环节
2.1 下载渠道与文件校验
整合包体积大,下载环节最容易出问题。常见的坑是下载到一半断流、文件损坏、或者下到了被二次打包塞了广告的版本。我的建议是优先从作者公布的原始渠道获取,下载完成后务必核对文件大小和哈希值。
下载完成后你会得到一个压缩包,通常是 7z 或 zip 格式。这里有个细节:不要用系统自带的解压工具解压大文件,Windows 自带的解压对超过 4G 的单文件支持不好,容易解压失败或文件损坏。推荐用 7-Zip 或 Bandizip 这类专业工具。
| 环节 | 常见问题 | 推荐做法 |
|---|---|---|
| 下载 | 断流、文件损坏 | 用支持断点续传的工具,下完核对大小 |
| 解压 | 大文件解压失败 | 用 7-Zip,不要用系统自带 |
| 存放 | 路径含中文或空格 | 放在纯英文路径下,如 D:\SD |
| 空间 | 硬盘不够 | 预留至少 30G 可用空间 |
2.2 解压路径的讲究
这一步我要重点强调,因为它是新手翻车的高发区。解压路径绝对不能包含中文、空格和特殊字符。很多人习惯解压到"桌面"或者"我的文档",这两个路径在 Windows 上实际包含中文用户名,会导致 Python 读取路径时编码出错,启动直接失败。
正确的做法是在某个盘符根目录下建一个纯英文文件夹,比如D:\SD或者E:\StableDiffusion。路径越短越好,层级越浅越好。我见过有人解压到D:\我的软件\AI绘画\秋葉整合包\,结果启动脚本里的路径拼接全乱了,排查了半天才发现是中文路径的锅。
另外,解压后的文件夹不要随意移动或改名。整合包内部有很多相对路径引用,一旦移动位置,某些脚本可能找不到依赖。如果非要移动,建议整个文件夹一起移,不要只移其中一部分。
2.3 解压后的目录结构解读
解压完成后,你会看到一堆文件夹和文件,新手容易懵。我挑几个关键的说明一下。
webui文件夹是核心,里面是 WebUI 的本体代码。models文件夹放模型,其中Stable-diffusion子目录放主模型(checkpoint),VAE放 VAE 模型,Lora放 LoRA 微调模型。extensions放插件。outputs是出图保存目录。根目录下的 bat 文件是启动脚本,通常有多个,比如启动器.exe、A启动器.exe、webui-user.bat等。
理解这个结构很重要,因为后续你要往对应目录里放模型、装插件,都得知道往哪放。比如你下载了一个新的主模型,后缀是.safetensors,就要放进models\Stable-diffusion目录,然后在界面里刷新才能看到。
3. 首次启动:从双击到看见界面
3.1 启动器的选择
秋葉整合包通常提供一个图形化的启动器,文件名类似A启动器.exe或启动器.exe。双击它,会弹出一个设置窗口,里面可以配置显存优化、端口、主题等参数。对新手来说,直接用默认配置点"一键启动"就行。
启动器背后实际执行的是webui-user.bat这个脚本,它设置了 Python 路径、启动参数,然后调用launch.py。如果你想了解底层发生了什么,可以右键编辑这个 bat 文件看看,里面通常有set COMMANDLINE_ARGS=这一行,后面跟的就是启动参数。
3.2 启动过程与常见卡顿
第一次启动会比较慢,因为要初始化环境、加载模型。控制台窗口会滚动一堆日志,正常情况下你会看到类似"Running on local URL: http://127.0.0.1:7860"的提示,然后浏览器自动打开界面。
但新手经常卡在某个环节。最常见的是卡在Installing requirements或者Installing torch。这种情况通常是整合包在尝试联网安装依赖,而网络不通或者源太慢导致的。正常来说整合包应该已经预装好所有依赖,不应该再联网安装。如果出现这种情况,说明包可能不完整,或者启动脚本被改动了。
另一个常见卡顿是卡在加载模型阶段,控制台停在某个百分比不动。这通常是显存不足或者模型文件损坏。可以尝试换一个小一点的模型,或者检查模型文件大小是否正常。
注意:如果启动时控制台报错提到
CUDA out of memory,说明显存不够。先关掉其他占显存的程序,再在启动器里开启显存优化选项。
3.3 界面初识与语言切换
进入界面后,你会看到一堆参数。新手先别慌,核心区域就几块:左上角是模型选择,中间是提示词输入框,右边是生成参数,下面是出图区域。
如果界面是英文的,可以在设置里切换中文。秋葉整合包通常预装了中文语言包,在Settings里找到User interface,把语言改成zh_CN,然后点Apply settings再Reload UI即可。
4. 出第一张图:提示词与参数怎么填
4.1 提示词的基本写法
提示词分正向和负向。正向描述你想要的画面,负向描述你不想要的。写法上,用英文逗号分隔关键词,越靠前的词权重越高。比如1girl, solo, long hair, white dress, garden, sunlight就是描述一个长发白裙女孩站在阳光花园里。
新手常犯的错误是写一长串自然语言句子,比如 "a beautiful girl standing in a garden with sunlight"。这种写法不是不行,但效果不如关键词堆叠稳定。SD 对关键词的响应更直接,所以建议用关键词列表的方式。
负向提示词是新手容易忽略的,但它对出图质量影响很大。常用的负向词包括lowres, bad anatomy, bad hands, extra fingers, worst quality, low quality。这些词能有效减少崩坏的手、模糊的画面和畸形的结构。
4.2 核心参数的含义与推荐值
采样步数(Steps)控制生成过程的精细度,一般 20 到 30 就够,太高收益递减还费时间。采样器(Sampler)推荐用DPM++ 2M Karras或Euler a,前者稳定,后者有随机性。CFG Scale 控制提示词的影响力,7 到 9 比较合适,太高画面会过饱和,太低会不听话。
分辨率方面,SD 1.5 模型的原生分辨率是 512x512,直接生成 1024x1024 容易出现人物重复或结构崩坏。正确做法是先出 512 的图,再用高清修复(Hires. fix)放大。高清修复里放大算法选R-ESRGAN 4x+或Latent,放大倍数 2 倍,重绘幅度 0.5 左右。
| 参数 | 推荐值 | 说明 |
|---|---|---|
| Steps | 20-30 | 太高收益递减 |
| Sampler | DPM++ 2M Karras | 稳定通用 |
| CFG Scale | 7-9 | 控制提示词影响力 |
| 分辨率 | 512x512 | SD1.5 原生 |
| 高清修复 | 2x, 0.5 | 放大且保持结构 |
4.3 随机种子与复现
种子(Seed)决定生成的随机性。默认是 -1,表示每次随机。如果你出了一张满意的图,想微调,可以把种子固定下来,然后小改提示词,这样能在保持整体构图的前提下调整细节。这是个非常实用的技巧,新手一定要学会。
5. 显存不够怎么办:优化策略实测
5.1 显存占用的来源
SD 跑图时显存主要被三部分占用:模型权重、推理过程中的中间张量、以及高清修复时的额外开销。一个 SD 1.5 模型大约占 2G 显存,推理时峰值可能到 4G 到 6G。如果开高清修复,峰值会更高。
6G 显存的卡跑 512 图基本没问题,但开高清修复可能爆。4G 显存的卡就比较吃力了,需要开启优化选项。
5.2 启动参数优化
在启动器的命令行参数里,有几个关键选项能显著降低显存占用。--medvram是中等显存优化,--lowvram是低显存优化,后者更激进但速度更慢。--xformers能加速注意力计算并降低显存,强烈建议开启。--opt-sdp-attention是另一种注意力优化,对某些显卡效果更好。
我的建议是 6G 以上显存用--xformers就够,4G 到 6G 加--medvram,4G 以下用--lowvram。这些参数写在COMMANDLINE_ARGS里,用空格分隔。
5.3 出图时的省显存技巧
除了启动参数,出图时也有技巧。降低分辨率、关闭高清修复、减少批量张数都能省显存。另外,生成完一张图后,显存不会立即释放,如果连续生成多张,可能越跑越卡。可以在设置里开启显存清理选项,或者定期重启 WebUI。
提示:如果频繁爆显存,可以考虑用更小的模型,比如一些剪枝过的轻量模型,或者用 SD 1.5 而不是 SDXL,后者显存需求高得多。
6. 常见问题排查速查表
6.1 启动类问题
启动类问题占了新手求助的一大半。下面这张表覆盖了最常见的几种情况。
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
| 双击无反应 | 杀毒软件拦截 | 加白名单或临时关闭 |
| 卡在 Installing | 联网装依赖失败 | 检查包完整性,断网启动 |
| 报错 CUDA 不可用 | 驱动或显卡问题 | 更新驱动,检查显卡支持 |
| 中文路径报错 | 路径含中文 | 移到纯英文路径 |
| 端口被占用 | 7860 被占 | 换端口或关占用程序 |
6.2 出图类问题
出图类问题主要是画面质量。人物畸形通常是分辨率不对或负向词不够。画面模糊可能是步数太低或模型问题。颜色发灰通常是 VAE 没加载对,需要在设置里指定 VAE 或者把 VAE 和模型放一起。
如果出图全黑或者全噪点,大概率是模型文件损坏,重新下载模型即可。如果出图风格完全不对,检查是不是选错了模型或者 LoRA 权重太高。
6.3 性能类问题
出图慢的原因很多。如果是 CPU 在跑,说明 CUDA 没生效,检查驱动和 PyTorch 版本。如果显存频繁交换,说明显存不够,开优化参数。如果第一次出图慢后续快,那是正常的模型加载过程。
我个人的经验是,RTX 3060 12G 跑 512 图,20 步,大约 3 到 5 秒一张,这个速度对新手来说完全够用。如果明显慢于这个,就要排查优化参数了。
7. 模型与插件的扩展玩法
7.1 主模型的挑选与放置
整合包自带的基础模型通常够用,但想玩出花样还得下模型。主模型文件后缀一般是.safetensors或.ckpt,放进models\Stable-diffusion目录,然后在界面左上角刷新即可切换。
选模型要看风格,写实、二次元、插画各有专攻。下载时注意模型的基础版本,SD 1.5 和 SDXL 不通用,别下错了。模型文件通常几个 G,下载要有耐心。
7.2 LoRA 的用法
LoRA 是小型的风格微调模型,体积小,通常几十到几百兆。放进models\Lora目录,在提示词里用<lora:模型名:权重>的语法调用,权重一般 0.6 到 1.0。LoRA 能快速给画面加上特定风格或角色特征,是性价比很高的玩法。
多个 LoRA 可以叠加,但权重加起来别太高,否则画面会崩。我一般同时用不超过两个,权重各 0.7 左右。
7.3 插件的安装
插件放在extensions目录。秋葉整合包通常预装了中文界面、模型预览、提示词补全这些常用插件。想装新插件,可以在界面的扩展标签页里从 URL 安装,或者手动下载放进目录。
装插件要注意兼容性,有些插件对 WebUI 版本有要求,装完启动报错的话,先禁用新插件再排查。
8. 我踩过的坑和几条实在建议
整合包虽然省事,但也不是完全没坑。我最早用的时候,因为把包放在了桌面,路径带中文,启动一直失败,查了半天日志才发现问题。还有一次是杀毒软件把启动脚本当可疑程序删了,导致双击没反应,加了白名单才解决。
另一个坑是显存。我一开始用 4G 显存的笔记本跑,没开优化参数,出图直接爆显存。后来加了--lowvram和--xformers,虽然慢了点,但至少能跑。所以配置一般的机器,启动参数一定要调。
最后说个习惯问题:定期备份你的模型和配置。整合包更新或者重装时,模型和插件目录如果没备份,重新下载很费时间。我现在的做法是把models和extensions单独放一个盘,整合包本体更新时只换本体,模型目录不动,省事很多。
这套流程走下来,从解压到出第一张满意的图,顺利的话半小时内能搞定。剩下的就是慢慢调提示词、试模型、玩 LoRA,这个过程才是真正有意思的地方。