Mole Mac Cleanup

核心用法

Mole 是专为 macOS 设计的命令行清理优化套件，通过单一 CLI mo 整合多款付费工具的核心能力。主要功能模块包括：

1. 深度清理（`mo clean`）：移除用户应用缓存、浏览器数据（Chrome/Safari/Firefox）、开发者工具残留（Xcode/Node/npm）、系统日志、应用专属缓存（Spotify/Dropbox/Slack）及废纸篓
2. 智能卸载：彻底移除应用及其隐藏残留文件
3. 系统优化（`mo optimize`）：重建系统数据库、刷新 Finder/Dock、重置网络服务、清理诊断日志与交换文件、重建 Launch Services 和 Spotlight 索引
4. 磁盘洞察：可视化存储占用，定位大文件
5. 项目产物清理（`mo purge`）：批量清理 node_modules、target、build、venv 等开发构建目录
6. 安装包清理（`mo installer`）：扫描并移除 Downloads/Desktop/Homebrew 缓存等位置的 .dmg/.pkg/.zip

关键安全机制

• 强制预览模式：所有清理/优化操作均支持 --dry-run 先预览，建议首次使用必须执行
• 白名单保护：--whitelist 可配置保护路径，避免误删关键缓存
• 详细日志：--debug 提供风险等级与文件详情，增强可控性

局限性

• macOS 独占：仅支持 Darwin 系统（os: [darwin]），无跨平台能力
• 终端兼容性：官方提示 iTerm2 存在问题，推荐 Ghostty/Alacritty/kitty/WezTerm
• 非交互式限制：TUI 模式（无参数 mo）对自动化代理无效，需显式传参
• Homebrew 依赖：安装渠道单一，无官方 pkg/dmg 分发
• 安全报告占位：当前附带的认证报告为系统自动生成，未执行实际安全扫描

适合人群

• 开发者：需要频繁清理 node_modules/构建产物的工程团队
• 运维/系统管理员：追求自动化、可脚本化的 Mac 维护方案
• 隐私敏感用户：希望彻底清理浏览器与系统痕迹
• 付费软件替代寻求者：不愿订阅 CleanMyMac 等工具的用户

常规风险

• 数据误删风险：虽有多重保护，但系统级清理（mo optimize 含交换文件删除、服务重启）仍可能导致未保存数据丢失或短暂系统不稳定
• 权限操作：mo touchid 修改 sudo 配置，需理解其安全影响
• 第三方源风险：通过 Homebrew 安装，依赖社区维护的 formula 完整性

核心用法

Mole（命令名 mo）是专为 macOS 设计的系统清理与优化工具，由知名开源开发者 tw93 维护。该 Skill 为纯文档型指令集，提供非交互式命令参考，适用于自动化工作流和 AI Agent 调用。

安装与基础命令

brew install mole          # Homebrew 官方源安装
mo --version               # 验证安装

四大核心功能模块

1. 深度清理（`mo clean`）

• 清理用户应用缓存、浏览器数据（Chrome/Safari/Firefox）、开发者工具残留（Xcode/Node/npm）、系统日志、应用专属缓存（Spotify/Dropbox/Slack）及废纸篓
• 关键安全实践：始终先执行 mo clean --dry-run 预览待删除文件，确认后再执行实际清理

2. 系统优化（`mo optimize`）

• 重建系统数据库与缓存、重置网络服务、刷新 Finder/Dock、清理诊断日志与崩溃报告、移除交换文件并重建 Launch Services 和 Spotlight 索引
• 适合系统运行缓慢或重大更新后执行

3. 项目构建产物清理（`mo purge`）

• 智能扫描并清理 node_modules、target、build、venv 等开发环境累积的大型目录
• 自定义扫描路径：~/.config/mole/purge_paths

4. 安装包管理（`mo installer`）

• 扫描 Downloads/Desktop/Homebrew 缓存/iCloud/Mail 附件中的 .dmg/.pkg/.zip 安装包，支持批量清理

高级管理功能

• 白名单管理：--whitelist 保护指定缓存路径
• TouchID sudo 配置：mo touchid
• 自动补全设置：mo completion

显著优点

• 功能整合度高：单一工具替代 CleanMyMac + AppCleaner + DaisyDisk + 手动脚本的多工具组合
• 开发者友好：专为技术用户设计的项目级清理，精准识别各类构建产物
• 安全机制完善：--dry-run 预览、--debug 详细日志、白名单机制三层防护
• T2 级可信来源：作者 tw93 GitHub 账号创建于 2014 年，拥有 10,290+ followers，Mole 项目获 51,702 stars、1.6K+ forks，社区认可度高
• MIT 开源许可：代码完全公开可审计，无商业软件的后门风险

潜在缺点与局限性

• macOS 独占：仅支持 Darwin 系统，无 Linux/Windows 版本
• 外部依赖风险：Skill 本身为纯文档，实际执行依赖用户本地安装的 mo 二进制文件，需确保从官方 Homebrew 源获取
• 终端兼容性限制：文档注明 iTerm2 存在显示问题，推荐使用 Ghostty、Alacritty、kitty、WezTerm
• 无图形界面反馈：非交互模式下无法直观查看磁盘可视化分析（TUI 模式需手动启动）
• 权限要求：部分系统级清理需管理员权限，执行 sudo 操作前无二次确认（区别于部分商业工具的弹窗机制）

适合人群

• macOS 开发者：需要定期清理 node_modules、DerivedData、target 等构建产物的技术用户
• 存储空间紧张用户：SSD 容量有限，需精细化磁盘管理的 MacBook 用户
• 追求自动化的高级用户：希望替代图形界面工具、将清理流程脚本化的效率爱好者
• 开源偏好者：拒绝订阅制商业软件（CleanMyMac）、倾向透明开源方案的隐私敏感用户

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| **误删数据** | 自动清理可能误判缓存为无用文件 | 强制使用 `--dry-run` 预览，配置白名单保护关键路径 |

| **系统不稳定** | `mo optimize` 重建系统服务期间可能短暂影响功能 | 避免在工作关键期执行，执行后重启系统验证 |

| **供应链风险** | Homebrew 源被污染或本地二进制被替换 | 验证 `brew install mole` 来源为 `tw93/mole` 官方 tap，定期检查 `mo --version` 签名 |

| **权限滥用** | `mo touchid` 修改 sudo 配置可能扩大攻击面 | 仅在可信设备配置，定期检查 `/etc/pam.d/sudo_local` |

认证信息

• 安全等级：S（92分）
• 来源可信度：T2（可信个人开发者）
• 认证编号：CLS-2026-0518-MOLE-7A3F
• 有效期：30天