用途：Mole（命令名 mo）是面向 macOS 的一体化维护 CLI，把深度清理、智能卸载、磁盘分析、系统优化、实时监控和项目产物清理整合到单个二进制中。
主要能力：mo clean 清理用户应用缓存、浏览器缓存（Chrome、Safari、Firefox）、开发工具缓存（Xcode、Node.js、npm）、系统日志、临时文件、特定应用缓存（Spotify、Dropbox、Slack）及废纸篓；mo uninstall 显示应用大小与最后使用日期，并移除应用包及其 Application Support、Caches、Preferences、日志、WebKit 存储、Cookies、扩展、插件、Launch Daemons 等残留；mo optimize 重建系统数据库与缓存、重置网络服务、刷新 Finder 与 Dock、清理诊断与崩溃日志、移除 swap 文件并重启动态分页器、重建 launch services 与 Spotlight 索引；mo analyze 提供可视化磁盘空间浏览，支持 --json 机器可读输出；mo status 提供 CPU、GPU、内存、磁盘、网络、进程的实时面板，支持 --json；mo purge 扫描 node_modules、target、build、dist、venv 等目录，默认不选中 7 天内的新项目；mo installer 查找并移除 .dmg/.pkg 安装包；另有 mo touchid 配置 sudo 的 Touch ID、mo completion 设置 shell 补全、mo update 更新、mo remove 卸载自身。
使用方式：推荐 brew install mole，或用 curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash 安装，支持版本固定（如 bash -s 1.17.0）与 nightly（bash -s latest）。直接运行 mo 进入交互菜单。破坏性命令务必先加 --dry-run 预览，可配合 --debug。配置位于 ~/.config/mole/，含 purge_paths 与 operations.log；可用 MO_NO_OPLOG=1 关闭操作日志。
适用场景：日常 Mac 清理与优化、卸载应用并清除残留、排查磁盘占用、脚本化健康检查与 CI 构建产物清理。
限制：clean、uninstall、purge、installer、remove 为永久性删除，须先 dry-run；analyze 通过 Finder 移入废纸篓可恢复。Mole 会校验路径并执行受保护目录规则，跳过或拒绝高风险操作。nightly 更新仅适用于脚本安装，不适用于 Homebrew。自动化流水线使用前应查阅 SECURITY.md 与 SECURITY_AUDIT.md。安装 fd（brew install fd）可加快扫描。