#disk-cleanup #developer-tools #macos #bash

开发环境体检器 env-doctor

会勇禾口王 · 开发环境体检器（第三把 doctor）。扫描 Mac/Linux 上被开发工具占掉的磁盘空间，把每个目录判定成「数据 / 缓存 / 残留」三类，重点识别**你已经换掉但从没卸干净的旧工具**（如还留着 nvm 却早就在用 fnm），逐条给出判定依据、官方清理命令与代价。配交互式清理选择器（空格勾选、数据类锁死勾不上、确认后才执行、支持 --dry-run），删什么由你逐项勾。触发：用户说「磁盘满了 / 硬盘不够了 / 清理缓存 / 电脑越用越满 / 开发环境体检 / 查查什么占空间 / env-doctor / 环境体检 / disk doctor / 我的 Mac 空间去哪了 / node_modules 太大 / 缓存清理 / 残留清理 / 换过 nvm 想清干净」。任何「查/清本机磁盘被开发工具占用」的请求都应触发。

会勇禾口王的AI笔记@huiyonghkw

Install

openclaw skills install @huiyonghkw/hekouwang-env-doctor-skill

开发环境体检器 · env-doctor

「体检器家族」第三把：claude-md-doctor（配置）→ skill-doctor（技能）→ env-doctor（环境）。前两把体检文件，这把体检机器。

它跟市面清理工具差在哪（先读这条，它决定了全部行为）

市面上的 Mac 清理工具回答的是「哪个目录大」。本器回答的是「这个工具你还在用吗」。

体积能扫出来，身份只能推理出来——要判断 nvm 是不是残留，得同时看 shell 配置加载了谁、PATH 里有谁、node 实际由谁提供、目录多久没动。这是本器唯一的差异化，任何改动都不许削弱它。

⛔ 三条铁律（细则见 `references/safety.md`）

删除只能来自用户逐项勾选（走 scripts/clean.sh）。模型自己不拼 rm 去跑；用户说「你直接帮我删」→ 引导他跑选择器。默认全不选、数据类锁死、只跑白名单命令、输入 yes 才动手。
只读扫描。scripts/scan.sh 不含任何写操作。
不确定就说不确定。信号矛盾时如实标注，不为报告好看而猜。

标准流程

第 1 步 · 扫描

bash

bash scripts/scan.sh          # 全量（含家目录大户发现，约 30–60 秒）
bash scripts/scan.sh --quick  # 快扫（跳过发现扫描，约 20 秒）

输出五节原始数据：DISK（真实磁盘，macOS 走数据卷）· SIZES（候选目录体积）· MANAGERS（版本管理器四信号）· RUNTIME（运行时实际来源）· DISCOVER（规则库未覆盖的大户）。

第 2 步 · 判定

对照 references/rules.md：

三分法（数据 / 缓存 / 残留）给每个目录定身份；
四信号判定表（shell_loaded × cmd_in_path × runtime owner × last_modified）判版本管理器是活跃还是残留；
同一版本被两个管理器各装一份 → 单列一条提示。

第 3 步 · 出报告

按 references/report.md 的四步对话流程走：先给结论 → 分三组呈现（残留→缓存→数据）→ 逐组问用户 → 确认后才生成命令块。

⚠️ 别把几十行清单一次糊给用户；⚠️ 每条建议必带「是什么 / 多大 / 凭什么判 / 官方命令 / 代价」五要素。

第 4 步 · 想清理时，交给选择器