SBH(Storage Ballast Helper)用于防止 AI 编程工作负载因磁盘写满而中断,主要从三方面入手:压舱文件(ballast,可毫秒级释放空间)、扫描器(识别陈旧产物)以及特殊位置(/tmp、/dev/shm、swap)。
用途与主要能力:快速检查磁盘压力与剩余空间(sbh status、sbh check --need 5G、sbh check --predict 30),退出码 0 表示健康、1 表示有压力、2 表示错误。守护进程可前台运行或通过 systemd/launchd 安装(sbh daemon、sbh install --systemd --user --auto、sbh install --launchd --auto、sbh install --wizard),信号 SIGHUP 重载配置、SIGUSR1 立即扫描、SIGTERM 优雅停止。压舱管理支持查看、创建、释放与补充(sbh ballast status/provision/release/replenish),默认 10×1 GiB。扫描与清理可按评分排序并预览或执行删除(sbh scan、sbh clean --dry-run、sbh clean --target-free 50G --yes),评分由位置、名称、年龄、大小、结构加权。保护机制使用 .sbh-protect 标记,硬性否决包括 .git 目录、打开中的文件、年龄小于 10 分钟及父目录不可写。紧急恢复为零写入模式,无需配置文件(sbh emergency /data --yes)。可观测性包括 TUI 仪表盘、统计、压力来源与决策解释。配置位于 ~/.config/sbh/config.toml,支持环境变量 SBH_ 前缀与 /etc/sbh/config.toml 回退。
使用方式与限制:需按文档命令操作,压舱目录应与压力来源同一挂载点,避免放在 /tmp;守护进程与 CLI 应使用同一用户范围以避免状态文件权限不一致;建议在 CI 或钩子中预先检查空间,并在黄色压力级别即采取行动。具体平台支持、安装细节与完整配置项以官方文档为准,本资料未提供收费、价格或效果保证等信息。