Mole：Mac 深度清理与优化 CLI

项目简介

Mole 是一个免费开源的 macOS 清理与系统优化命令行工具，命令名为 mo。它把 CleanMyMac、AppCleaner、DaisyDisk、iStat Menus 这类工具的常见操作集中到一个终端命令里：深度清理缓存与残留、连根卸载 App、可视化分析磁盘占用、刷新系统缓存服务、实时查看硬件状态。

本仓库是免费的 CLI。官方另有一个独立的 Mac 原生应用（Mole for Mac，需单独下载，带「删除前确认」、800+ 应用的残留库、磁盘下钻、实时状态与风扇控制），Windows 原生应用见 Mole for Windows。brew install mole 只安装 CLI。README 顶部还列出了 Windows 与 Linux 分支的入口。

主要功能

• 深度清理：清理已知安全的缓存、日志、临时文件、开发者产物，以及已卸载 App 的残留数据，回收磁盘空间。
• 智能卸载：卸载 App 时一并处理 LaunchAgents、偏好设置与关联残留；若有另一份安装仍在共用数据则保留。
• 磁盘分析：交互式 TUI 可视化磁盘占用，定位大文件并在目录间浏览。
• 系统维护：刷新 DNS、QuickLook 与图标缓存，优化系统数据库。
• 实时监控：查看 CPU、内存、磁盘 I/O、网络流量与进程状态。
• 其他实用命令：purge 清理项目构建产物、installer 查找并删除安装包、slim 从通用 App 中移除 Intel 代码、touchid 配置 sudo 的 Touch ID、completion 设置 shell 补全。

安装与使用

要求 macOS 12 或更高版本，支持 Intel 与 Apple Silicon。若你的 macOS 版本已不被 Homebrew 支持，可改用脚本安装。

brew install mole

curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash

Windows CLI：

iwr -useb https://raw.githubusercontent.com/tw93/Mole/windows/quick-install.ps1 | iex

常用命令：

mo                # 交互式菜单
mo clean          # 深度清理 + 已卸载 App 残留
mo uninstall      # 卸载 App 及其残留
mo optimize       # 刷新缓存与服务
mo analyze        # 可视化磁盘分析
mo status         # 实时系统状态面板
mo history        # 查看清理历史

危险操作可先预览：

mo clean --dry-run
mo uninstall --dry-run
mo optimize --dry-run

也可以交给 AI Agent 安装与使用：

npx skills add tw93/Mole -a claude-code codex cursor -g -y

安装该 skill 后，Claude Code、Codex、Cursor 等会在删除任何东西前先用 --dry-run 展示清理内容，卸载 App 和需要管理员权限的步骤则留给你自己处理。

注意事项

• Mole 会删除文件，使用前建议先用 --dry-run 预览，必要时加 --debug 查看详细日志。
• 不要用 sudo 运行 Mole，它在需要时会自行请求管理员权限。
• mo uninstall、mo analyze、mo slim 在确认后默认把文件移入废纸篓；clean、purge、installer 是永久删除。mo uninstall --permanent 会跳过废纸篓。
• 清理记录写在 ~/Library/Logs/mole/operations.log，可用 mo history 查看，或用 MO_NO_OPLOG=1 关闭记录。
• 用 mo clean --whitelist 保护缓存，用 mo optimize --whitelist 保护维护项；白名单文件读取失败时，相关命令会直接停止而不是无保护执行。
• Mole 仅通过 Homebrew、本仓库和 mole.fit 分发，molemac.com、moleapp.net、molefit.com 并非 Mole。

本作品整理自 GitHub 开源项目 tw93/Mole，原作者 @tw93，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。