Guohua Diffusion 存储优化与系统盘空间管理实践
Guohua Diffusion 存储消耗分析
在运行 Guohua Diffusion（基于 Stable Diffusion WebUI 架构）时，系统盘（通常为C盘）空间极易被迅速耗尽。要解决这一问题，首先需要明确存储消耗的具体来源。默认安装环境下，主要的空间占用节点包括：
- 核心权重文件（.safetensors / .ckpt）：基础大模型体积通常在 2GB 至 7GB 之间，若叠加各类微调模型（LoRA），总容量会呈指数级增长。默认存储于
models/Stable-diffusion及models/Lora目录。 - 辅助模型（VAE 与 Embeddings）：VAE 用于色彩校正，Embeddings 用于文本反转，分别位于
models/VAE和embeddings目录，单体较小但累积占用不容忽视。 - 运行时缓存：包含模型首次加载时生成的加速缓存（如 HuggingFace 缓存或 SafeTensors 校验缓存），其体积往往与模型本体相当，是隐形的空间消耗大户。
- 生成产物：所有推理生成的图像及日志默认保存在
outputs目录，长期积累会占用数十甚至上百GB空间。
基础数据清理与归档
在进行底层存储重构前，应先执行安全的常规清理操作，以释放即时空间。
1. 产出物归档
进入 stable-diffusion-webui/outputs 目录，按日期或任务批次筛选高价值图像，将其迁移至外部存储或云盘。对于废弃的生成记录，可直接清空该目录下的 txt2img-images 和 img2img-images 子文件夹。
2. 临时文件 purge
WebUI 在运行和更新过程中会产生大量临时文件。在关闭 Guohua Diffusion 服务后，可手动删除以下路径的内容：
- 项目根目录下的
temp文件夹（若存在）。 - Windows 系统级临时目录：通过
Win + R输入%temp%，全选并删除其中的文件（跳过被系统占用的文件即可）。
深度存储重构方案
常规清理无法阻止空间再次被占满，必须通过系统级或应用级配置，将高吞吐目录从系统盘剥离。
方案一：通过启动参数重定向缓存（推荐）
Guohua Diffusion 支持通过命令行参数动态指定缓存路径。此方法无需修改系统文件结构，安全性最高。
- 在项目根目录找到启动脚本
webui-user.bat（Windows 环境）。 - 使用代码编辑器打开该文件，定位到
COMMANDLINE_ARGS变量。 - 注入
--cache-dir参数，将缓存指向非系统盘的大容量分区。
修改后的脚本示例如下：
@echo off
set PYTHON=python
set GIT=git
set VENV_DIR=venv
:: 重定向模型缓存与 HuggingFace 缓存至 E 盘，并开启显存优化参数
set COMMANDLINE_ARGS=--cache-dir "E:\Guohua_Cache" --opt-sdp-attention --no-half-vae
call webui.bat
保存并重启服务后，所有新生成的模型校验缓存和临时张量文件均会写入 E:\Guohua_Cache，彻底解除对C盘的占用。
方案二：利用目录联接（Junction）迁移核心资产
对于体积庞大的 models 目录，可通过 Windows 的目录联接（Directory Junction）功能实现物理迁移与逻辑映射。系统在读写联接点时，会自动将其重定向至实际物理路径，对 Guohua Diffusion 完全透明。
- 彻底关闭 WebUI 进程。
- 将
stable-diffusion-webui\models目录整体剪切至目标磁盘，例如F:\AI_Workspace\sd_models。 - 以管理员身份运行命令提示符（CMD）。
- 执行
mklink命令创建联接：
:: 语法：mklink /J [原逻辑路径] [新物理路径]
mklink /J "D:\Guohua_WebUI\stable-diffusion-webui\models" "F:\AI_Workspace\sd_models"
执行成功后，原路径下会出现一个带有快捷方式图标的文件夹。WebUI 读取该目录时，实际数据流均指向 F 盘。此方案同样适用于 outputs、extensions 等任何高频读写目录。
长效运维与监控机制
存储优化并非一次性工作，建立标准化的运维流程可确保系统长期稳定运行。
- 资产生命周期管理：定期审查
models目录，利用 Civitai Helper 等插件预览模型效果，将低频使用或效果冗余的权重文件归档至冷存储（如 NAS 或移动硬盘），保持热数据区的精简。 - 可视化空间监控：部署 WizTree 或 SpaceSniffer 等磁盘分析工具。这些工具通过读取 MFT（主文件表）能在秒级生成磁盘空间占用热力图，帮助精准定位 Guohua Diffusion 产生的异常大文件或未清理的孤立缓存。
- 初始化部署规范：在全新环境部署时，应直接利用便携版（Portable）整合包，或将项目克隆至非系统盘。配合上述的启动参数与目录联接策略，从根源上构建健康的存储架构。
