tw93/Mole

项目用途

Mole 是一套运行在终端里的 Mac 维护工具，把平时需要多个 App 才能完成的事情集中到一个 mo 命令：清理缓存和日志、卸载 App 并清理残留、交互式磁盘占用分析、刷新 DNS 与 QuickLook 等系统维护、清理项目构建产物、查找安装包、在 Apple Silicon 上剥离通用 App 的 Intel 代码，以及实时查看 CPU、内存、磁盘、网络和进程状态。仓库里的免费部分是命令行工具；Mac 原生 App 和 Windows 原生 App 通过 mole.fit 单独提供（README 介绍）。

安装与上手

需要 macOS 12 或更新版本，Intel 和 Apple Silicon 均支持。首选通过 Homebrew 安装（安装段落）：

brew install mole

如果当前 macOS 版本已不被 Homebrew 支持，README 也提供了脚本安装方式（脚本安装说明）；Windows 和 Linux 有各自的安装入口：Windows、Linux。安装后先跑交互菜单，或先预览一次清理：

mo                    # 交互菜单
mo clean --dry-run    # 预览将被删除的内容
mo status             # 实时系统面板

完整命令包括 clean、uninstall、optimize、analyze、status、purge、installer、slim，以及 touchid、completion、update、remove（命令列表）。需要脚本化时，mo analyze --json <path>、mo status --json、mo history --json 会输出 JSON，README 给出了字段示例（JSON 说明）。

使用约束

Mole 会删除文件，因此 clean、uninstall、purge、installer、slim 这些有破坏性的命令建议先加 --dry-run 预览。项目说明它会校验路径、保护共享和系统目录，对无法确认安全的操作跳过或拒绝执行，并建议不要用 sudo 运行，只在必要时请求管理员权限（安全说明）。uninstall、analyze、slim 默认把删除内容移到废纸篓，而 clean、purge、installer 是永久删除。清理记录可在 mo history 中查看，缓存和维护项可通过白名单保护；慢盘或网络盘上可以通过 MOLE_TIMEOUT_* 环境变量调整超时（配置说明）。CLI 采用 GPL-3.0，Mac App 是独立的闭源产品。具体可清理项和结果因机器而异，磁盘扫描不完整时结果会标记为 partial 或 unavailable，不会当作完整结果。

HotRepo 点评

2026-03-21 的 HN 讨论热度不高，33 分、1 条评论，但那条评论点出了这类清理工具最实用的两个特性：文档化的 --dry-run 和白名单，以及轻量、输出详细的脚本实现 HN 讨论。对一个 Shell 项目来说，Mole 的命令面相当宽，analyze、status、history 的 JSON 接口也让它能进入脚本和自动化流程，而不只是手动清理。免费 GPL CLI 与付费原生 App 的分界在 README 中写得很明确，想用图形界面的用户需要知道本仓库不提供那部分。