用途:在用户本机磁盘满、空间不足或要求清理本地垃圾时使用,仅做应急清理并保持系统连续性;不用于在没有候选清单的情况下决定删除哪些个人文档、下载文件,也不删除仓库、工作树、会话历史、记忆、技能、插件、定时任务、认证凭据。
主要能力:先用 df 与 du 建立基线,检查 ~/.codex、~/.hermes、~/.cache、~/Library 等本地状态根目录;用 lsof 判断超大日志是否被运行中进程占用;对活动日志采用“保留尾部、截断同一 inode”的方式而非删除;按 7 天且无 Finder 标签筛选可清理的缓存、临时目录、旧 Hermes 预更新快照与 legacy 检查点;清理包管理器缓存(uv cache prune --no-progress、npm cache clean --force、python3 -m pip cache purge、go clean -cache -testcache、brew cleanup --prune=7);输出清理清单 JSON 并在清理后用 df 与 du 验证。
使用方式:先跑基线命令 df -h / /System/Volumes/Data 2>/dev/null || df -h / 与 du -xhd1 "$HOME" 2>/dev/null | sort -h | tail -30,再针对可疑目录排查;删除用户文件前检查 com.apple.metadata:_kMDItemUserTags;活动日志用提供的 Python 脚本保留尾部后截断;清单写入 ~/.hermes/logs/disk-cleanup-YYYYMMDD-HHMMSS.json。
限制:默认保护 ~/Downloads、~/Documents、~/Desktop、仓库根目录、凭据、会话记录、记忆、技能、插件与 cron 状态;macOS .Trash 等受保护目录可能权限不足,需记录错误而非强行提权;不要对全 $HOME 套用“7天未用”;资料来源未提供具体清理量与效果数据。