Stableboost 本地缓存与输出目录管理的配置思路

Stableboost 用久了之后，缓存和输出文件会占掉大量磁盘空间。与其每次手工翻目录，不如一开始就把输出路径迁到大盘，再把缓存分类，只清理能安全删除的部分。配置的核心在配置文件的路径字段，日常维护靠定时任务。

处理 Stableboost 磁盘占用，先修改配置文件中的输出路径，将新文件迁移到目标磁盘；再区分模型缓存和临时缓存，只有临时文件可安全清理。修改后需重启观察路径变化，脚本清理仅限临时目录，避免触达模型文件。迁移前先备份输出目录更稳妥。

定位Stableboost的配置文件和默认目录

Stableboost 的配置文件常见位置是用户主目录下的 .stableboost 文件夹，也可能在应用安装根目录。文件名为 config.yaml 或 settings.json。打开后关注两个字段：output_dir（输出目录）和 cache_dir（缓存目录）。如果没找到这两个字段，可以搜索路径相关的关键字，有的版本会合并为 paths 块。

默认情况下，输出目录通常在用户目录下的 Stableboost 或 outputs 文件夹，缓存目录则可能位于系统临时目录或用户缓存目录。这些路径可以从日志启动信息中看到，例如启动时会打印“Output directory: 实际路径”。

修改输出目录并确认权限

把输出目录迁移到其他磁盘，可以避免系统盘被大量生成文件占满。修改前先关闭 Stableboost，编辑配置文件中的 output_dir，例如改为目标磁盘路径：

output_dir: D:/StableboostOutput
cache_dir: D:/StableboostCache

确保目标目录存在且当前用户有写入权限。在 Windows 上，避免选择系统保留目录或需要管理员权限的根目录。保存后重新启动 Stableboost，生成一张测试图，在日志中查看新文件路径是否指向新目录，并到该目录确认文件写入了。修改后，原输出目录中的文件不会自动移动，需要手动迁移已保留的文件，然后重新指向新位置。

识别可安全清理的缓存类型

缓存文件分三类，分别对应不同文件夹，误删代价不一样。

模型缓存：对应 models 或 weights 目录，保存下载的模型权重和自定义训练结果。删除后需要重新下载或重新训练，不可再造，不建议作为清理对象。
缩略图缓存：对应 thumbnails 或 previews 目录，是预览图的小尺寸副本。删除后会在下次浏览时自动重建，可以清理。
临时文件：对应 tmp、temp 或 intermediate 目录，是生成过程中的中间产物。删除后不影响后续生成，是最安全的清理目标。

在这三者中，只有模型缓存需要保守对待，尤其是经过微调或自定义配置的权重文件，删除后无法从官方源恢复。缩略图和临时文件可以根据空间需求定期清理。

设置定期清理的脚本或任务计划

建议只清理明确的临时目录，不要对缓存根目录直接执行批量删除。下面这段 shell 脚本删除超过 30 天的临时文件，要求临时目录结构单独存在：

#!/bin/bash
# 清理 Stableboost 临时文件，保留模型和缩略图缓存
if [ -d /mnt/d/StableboostCache/tmp ]; then
  find /mnt/d/StableboostCache/tmp -type f -mtime +30 -delete
  find /mnt/d/StableboostCache/tmp -type d -empty -delete
fi

在 Windows 下，可以用任务计划调用这段脚本：创建 clean_stableboost.bat，内容为 wsl bash /home/user/clean_stableboost.sh，然后在“任务计划程序”中设置触发器为每周或每月执行。如果本机没有 WSL，可以用 Git Bash 的 bash.exe 调用。

验证清理后Stableboost运行正常

清理完成后，重启 Stableboost，生成一张测试图，确认没有路径报错。观察启动日志中是否出现“could not find”“read-only”等关键词。如果临时目录被删除为空，部分组件会自动重建目录，这是正常现象。

对比磁盘占用可以在清理前后分别记录一次：Linux/macOS 下用 du -sh 查看缓存目录大小，Windows 下右键目录属性查看。清理后占用应明显下降，但测试图生成功能必须保持正常。如果发现模型加载失败，说明之前的清理范围包含了模型缓存，需要从备份恢复或重新下载。