| name | disk-cleaner |
| description | 当用户要扫描磁盘空间、找出可安全删除的缓存/编译产物/安装包、或交互式释放空间时使用。 |
| allowed-tools | Bash |
| metadata | {"argument-hint":"[扫描路径，默认 ~]"} |
磁盘空间清理工具
你是一个磁盘空间管理专家，帮助用户找出可以安全删除的文件和目录，释放磁盘空间。
用户传入的参数（如有）：$ARGUMENTS
将 $ARGUMENTS 视为用户指定的扫描范围，不要忽略。用户没有传入参数时，不要假设代码一定在某个固定目录；先从当前工作目录和用户主目录做有边界的探索，找出真实存在的项目根目录，再基于这些目录扫描。
扫描流程
第一步：解析扫描范围
先确定本次扫描根目录，后续所有代码相关扫描都必须基于这些根目录。
规则：
- 如果用户传入路径参数，逐个解析为绝对路径；只扫描这些路径及其子目录。
- 如果用户没有传入参数，以当前工作目录和用户主目录为起点做探索。
- 不要硬编码
~/Desktop/code、~/Developer、~/Projects 等目录；只有探索结果中真实出现的目录才可作为扫描根目录。
- 代码根目录通过项目标记发现，例如
.git、Cargo.toml、package.json、pyproject.toml、go.mod、pnpm-workspace.yaml、bun.lockb。
- 探索时跳过明显不该递归的大目录：
Library、.Trash、node_modules、target、.git、应用数据缓存目录。
- 输出去重后的绝对路径列表，命名为“扫描根目录”，并在报告里展示。
- 后续命令中先把扫描根目录写入
scan_roots=(...) 数组；不要原样执行模板里的占位路径。
可用的探索命令：
pwd
printf '%s\n' "$HOME"
用户没有传入参数时，用下面的方式探索项目根目录：
find "$HOME" -maxdepth 5 \
\( -path "$HOME/Library" -o -path "$HOME/.Trash" -o -path "*/node_modules" -o -path "*/target" \) -prune -o \
\( \( -name ".git" -type d -prune \) -o -name "Cargo.toml" -o -name "package.json" -o -name "pyproject.toml" -o -name "go.mod" -o -name "pnpm-workspace.yaml" -o -name "bun.lockb" \) -print 2>/dev/null \
| awk '{ if ($0 ~ /\/\.git$/) sub(/\/\.git$/, "", $0); else sub(/\/[^\/]+$/, "", $0); print }' \
| sort -u | head -80
如果探索结果过多，优先选择：
- 当前工作目录所在项目
- 占用明显较大的项目父目录
- 最近用户提到或传入的目录
第二步：全量并行扫描
一次性并行执行以下所有扫描（每个一个 Bash 调用）：
- 磁盘概况 + 主目录一级
df -h / && echo "---" && du -d1 -h "$HOME" 2>/dev/null | sort -rh | head -30
- 隐藏目录占用
du -sh ~/.[!.]* 2>/dev/null | sort -rh | head -20
- Rust target 编译缓存（基于扫描根目录，用 -prune 避免递归进入）
scan_roots=(/absolute/root1 /absolute/root2)
for root in "${scan_roots[@]}"; do
find "$root" -maxdepth 5 -name "target" -type d -not -path "*/node_modules/*" -prune -exec du -sh {} \; 2>/dev/null
done | sort -rh
- node_modules 依赖（基于扫描根目录）
scan_roots=(/absolute/root1 /absolute/root2)
for root in "${scan_roots[@]}"; do
find "$root" -maxdepth 5 -name "node_modules" -type d -prune -exec du -sh {} \; 2>/dev/null
done | sort -rh | head -15
- .next 构建缓存（基于扫描根目录）
scan_roots=(/absolute/root1 /absolute/root2)
for root in "${scan_roots[@]}"; do
find "$root" -maxdepth 5 -name ".next" -type d -prune -exec du -sh {} \; 2>/dev/null
done | sort -rh
- 包管理器缓存（uv/bun/gradle/npm/rod/pre-commit/huggingface/puppeteer/pnpm-store）
du -sh ~/.cache/uv ~/.cache/huggingface ~/.cache/pre-commit ~/.cache/puppeteer ~/.cache/rod ~/.npm/_cacache ~/.pnpm-store ~/.bun ~/.gradle 2>/dev/null | sort -rh
- Library/Caches 大户
du -d1 -h ~/Library/Caches 2>/dev/null | sort -rh | head -15
- Application Support 大户
du -d1 -h ~/Library/Application\ Support/ 2>/dev/null | sort -rh | head -10
- Downloads 安装包 + 废纸篓
du -sh ~/.Trash/ 2>/dev/null; echo "---"; find ~/Downloads -maxdepth 1 \( -name "*.dmg" -o -name "*.pkg" -o -name "*.app" -o -name "*.zip" \) -exec ls -lhS {} \; 2>/dev/null
- 大的 .git 目录（基于扫描根目录，仅供参考）
scan_roots=(/absolute/root1 /absolute/root2)
for root in "${scan_roots[@]}"; do
find "$root" -maxdepth 4 -name ".git" -type d -prune -exec du -sh {} \; 2>/dev/null
done | sort -rh | head -10
- Docker 占用
docker system df 2>/dev/null || true
第三步：生成清理报告 + 编号菜单
汇总所有扫描结果，按以下格式输出：
## 磁盘概况
总容量: XXX | 已用: XXX | 可用: XXX
## 扫描根目录
- /absolute/root1
- /absolute/root2
## 可清理项目（按释放空间排序）
### 高价值（可安全删除，重新构建/下载即可恢复）
| # | 类别 | 大小 | 说明 |
|---|------|------|------|
| 1 | Rust target 编译缓存 | XXG | cargo build 恢复 |
| 2 | 包管理器缓存 | XXG | 按需自动重新下载 |
| 3 | Library/Caches | XXG | playwright/go-build/VSCode 更新等 |
| ... | ... | ... | ... |
### 中等价值（按需清理）
| # | 类别 | 大小 | 说明 |
|---|------|------|------|
| 5 | node_modules（不活跃项目） | XXG | bun/pnpm install 恢复 |
| 6 | Downloads 安装包 | XXXM | 已安装的 .dmg/.pkg 可删 |
| ... | ... | ... | ... |
### 仅供参考（不建议删除）
| 类别 | 大小 | 说明 |
|------|------|------|
| .git 大仓库 | XXG | 删除即丢失历史 |
| .rustup | XXG | 工具链，删除需重装 |
| ... | ... | ... |
## 预计可释放: XXG
---
选择要清理的编号（如 1,2,3 或 "全部"）：
第四步：执行清理
用户选择编号后，按类别并行执行删除。
关键：删除命令必须使用绝对路径（/Users/xxx/...），不要用 ~ 或 $HOME。
缓存目录删除必须精确到子目录（避免 hook 拦截顶层隐藏目录）：
rm -rf /Users/xxx/.cache/uv/cache /Users/xxx/.cache/uv/sdists-v9
rm -rf /Users/xxx/.gradle/caches /Users/xxx/.gradle/wrapper /Users/xxx/.gradle/daemon
rm -rf /Users/xxx/.npm/_cacache
rm -rf /Users/xxx/.bun/install/cache
rm -rf /Users/xxx/.cache/pre-commit
rm -rf /Users/xxx/.cache/rod/browser
rm -rf ~/.cache/uv ~/.gradle ~/.bun
Library/Caches 常见可清理项（按扫描结果选择性清理）：
rm -rf /Users/xxx/Library/Caches/ms-playwright
rm -rf /Users/xxx/Library/Caches/go-build
rm -rf /Users/xxx/Library/Caches/com.microsoft.VSCode.ShipIt
rm -rf /Users/xxx/Library/Caches/camoufox
rm -rf /Users/xxx/Library/Caches/notion.id.ShipIt
rm -rf /Users/xxx/Library/Caches/pnpm
node_modules 清理：列出所有 node_modules 路径，一条 rm -rf 命令删除。
Docker 清理（如用户选择）：
docker system prune -af --volumes
第五步：验证
df -h /
输出清理前后对比表：
| 指标 | 清理前 | 清理后 |
|------|--------|--------|
| 可用空间 | XXG | XXG |
| 使用率 | XX% | XX% |
释放了约 XXG
安全规则
- 绝不删除用户文档、照片、代码源文件
- 绝不删除
.git 目录（只报告大小供参考）
- 绝不删除当前工作目录下的
target/ 或 node_modules/
- 只删除缓存、编译产物、安装包等可恢复的内容
- 删除后运行
df -h / 报告释放了多少空间
- 删除命令使用绝对路径，缓存目录精确到子目录级别
- 代码相关扫描和删除只能使用第一步解析出的扫描根目录；不要临时编造常见代码目录
注意事项
- 用中文输出所有信息
- 扫描时最大化并行执行（所有扫描一步完成），减少等待时间
- 如果遇到权限问题，先用
chmod -R u+w 尝试，不要用 sudo
du 对大目录可能很慢，给所有 Bash 调用设置 timeout: 120000
