Mole Mac 清理工具

技能来自 ara.so — Daily 2026 Skills 系列。

Mole (mo) 是一个集成了深度清理、智能应用卸载、磁盘分析、系统优化、实时监控和项目构建产物清除功能的全能 macOS 维护 CLI 工具。

安装

# 通过 Homebrew (推荐)
brew install mole

# 通过安装脚本 (支持版本锁定)
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash

# 指定版本
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash -s 1.17.0

# 最新主分支 (每日构建版)
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash -s latest

核心命令

mo                    # 交互式菜单 (方向键或 vim h/j/k/l)
mo clean              # 深度清理系统缓存 + 浏览器 + 开发工具
mo uninstall          # 卸载应用及其所有残留文件
mo optimize           # 重建缓存、重置网络、刷新 Finder/Dock
mo analyze            # 可视化磁盘空间分析器
mo status             # 实时系统健康仪表盘
mo purge              # 清理项目构建产物 (node_modules, target, dist)
mo installer          # 查找并删除安装程序 .dmg/.pkg 文件

mo touchid            # 为 sudo 配置触控 ID
mo completion         # 设置 shell 命令补全
mo update             # 更新 Mole
mo update --nightly   # 更新到最新的未发布版本 (仅限脚本安装)
mo remove             # 卸载 Mole 本身
mo --help
mo --version

删除前安全预览

在执行破坏性命令前，始终先使用试运行模式：

mo clean --dry-run
mo uninstall --dry-run
mo purge --dry-run

# 结合 debug 获取详细输出
mo clean --dry-run --debug
mo optimize --dry-run --debug

核心命令详解

mo clean — 深度清理

清理用户应用缓存、浏览器缓存（Chrome、Safari、Firefox）、开发工具缓存（Xcode、Node.js、npm）、系统日志、临时文件、特定应用缓存（Spotify、Dropbox、Slack）以及废纸篓。

mo clean                  # 交互式清理
mo clean --dry-run        # 预览将被删除的内容
mo clean --whitelist      # 管理受保护的缓存（排除在清理之外）

白名单配置位于 ~/.config/mole/。编辑它以保护你想保留的路径。

mo uninstall — 智能应用卸载

查找应用，显示大小和最后使用日期，然后删除应用程序包及其所有相关文件：

• 应用程序支持、缓存、偏好设置
• 日志、WebKit 存储、Cookie
• 扩展、插件、启动守护进程

mo uninstall              # 交互式多选列表
mo uninstall --dry-run    # 预览将要删除的内容

mo optimize — 系统刷新

mo optimize               # 运行所有优化
mo optimize --dry-run     # 预览
mo optimize --whitelist   # 排除特定的优化步骤

优化包括：

• 重建系统数据库和清理缓存
• 重置网络服务
• 刷新 Finder 和 Dock
• 清理诊断和崩溃日志
• 删除交换文件并重启动态分页器
• 重建启动服务和 Spotlight 索引

mo analyze — 磁盘分析器

mo analyze                # 分析主目录（默认跳过 /Volumes）
mo analyze ~/Downloads    # 分析指定路径
mo analyze /Volumes       # 明确包含外置驱动器

# 机器可读输出，用于脚本处理
mo analyze --json ~/Documents

JSON 输出示例：

{
  "path": "/Users/you/Documents",
  "entries": [
    { "name": "Library", "path": "...", "size": 80939438080, "is_dir": true }
  ],
  "total_size": 168393441280,
  "total_files": 42187
}

mo analyze 内的导航快捷键：

mo status — 实时仪表盘

mo status                 # 实时 CPU、GPU、内存、磁盘、网络、进程
mo status --json          # 用于脚本的 JSON 输出
mo status | jq '.health_score'   # 自动检测管道 → 输出 JSON

JSON 输出示例：

{
  "host": "MacBook-Pro",
  "health_score": 92,
  "cpu": { "usage": 45.2, "logical_cpu": 8 },
  "memory": { "total": 25769803776, "used": 15049334784, "used_percent": 58.4 },
  "disks": [],
  "uptime": "3d 12h 45m"
}

mo status 内的快捷键：k 切换猫吉祥物，q 退出。

mo purge — 项目构建产物清理

扫描 node_modules、target、build、dist、venv 等目录。默认情况下，创建时间少于 7 天的项目不会被选中。

mo purge                  # 交互式多选
mo purge --dry-run        # 预览
mo purge --paths          # 配置自定义扫描目录

配置自定义扫描路径 (~/.config/mole/purge_paths)：

~/Documents/MyProjects
~/Work/ClientA
~/Work/ClientB

当此文件存在时，Mole 仅使用这些路径。否则，默认为 ~/Projects、~/GitHub、~/dev。

安装 fd 以获得更快的扫描速度：brew install fd

mo installer — 安装程序文件清理

mo installer              # 在下载、桌面、Homebrew 缓存、iCloud、邮件中查找 .dmg/.pkg 文件
mo installer --dry-run    # 预览将要删除的内容

配置文件

所有配置位于 ~/.config/mole/：

禁用操作日志记录：

export MO_NO_OPLOG=1
mo clean

Shell 命令补全

mo completion             # 交互式设置 bash/zsh/fish 补全

为 sudo 配置触控 ID

mo touchid                # 为 sudo 命令启用触控 ID 身份验证
mo touchid enable --dry-run

脚本编写与自动化模式

在脚本中检查磁盘健康状态

#!/bin/bash
health=$(mo status --json | jq -r '.health_score')
if [ "$health" -lt 70 ]; then
  echo "健康分数较低: $health — 正在运行清理"
  mo clean --dry-run  # 准备好后改为 `mo clean`
fi

获取最大的目录并输出 JSON，用 jq 处理

mo analyze --json ~/Downloads | jq '.entries | sort_by(-.size) | .[0:5] | .[] | {name, size_gb: (.size / 1073741824 | . * 100 | round / 100)}'

在 CI 清理阶段自动清理项目产物

#!/bin/bash
# CI 后非交互式清理构建产物
MO_NO_OPLOG=1 mo purge --dry-run   # 在脚本中始终先预览

Raycast / Alfred 快速启动器

curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash
# 然后在 Raycast 中将 `mo clean`, `mo status`, `mo analyze` 绑定为脚本命令

安全边界

• mo analyze 通过访达将文件移至废纸篓（可恢复），而不是直接删除 — 临时清理时优先使用
• clean、uninstall、purge、installer 和 remove 是永久性删除操作 — 始终先使用 --dry-run
• Mole 会验证路径并强制执行受保护目录规则；它会跳过或拒绝高风险操作
• 操作日志：~/.config/mole/operations.log — 使用 MO_NO_OPLOG=1 禁用
• 在自动化管道中使用前，请查阅 SECURITY.md 和 SECURITY_AUDIT.md

故障排除

更新与卸载

mo update                 # 更新到最新稳定版
mo update --nightly       # 更新到最新主分支（仅限脚本安装）
mo remove                 # 完全卸载 Mole
mo remove --dry-run       # 预览卸载将删除的内容