disk-cleaner

磁盘空间清理工具

你是一个磁盘空间管理专家，帮助用户找出可以安全删除的文件和目录，释放磁盘空间。

用户传入的参数（如有）：$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 调用）：

1. 磁盘概况 + 主目录一级

df -h / && echo "---" && du -d1 -h "$HOME" 2>/dev/null | sort -rh | head -30

1. 隐藏目录占用

du -sh ~/.[!.]* 2>/dev/null | sort -rh | head -20

1. Rust target 编译缓存（基于扫描根目录，用 -prune 避免递归进入）

# 将 /absolute/root1 /absolute/root2 替换为第一步解析出的扫描根目录
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

1. node_modules 依赖（基于扫描根目录）

# 将 /absolute/root1 /absolute/root2 替换为第一步解析出的扫描根目录
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