mole-mac-cleanup

Mole - Mac 清理与优化工具

仓库： https://github.com/tw93/Mole 命令： mo（不是 mole！） 安装： brew install mole

给用户的提示： 不带参数运行 mo 会打开交互式 TUI 模式。对 Agent 没什么用，不过你可以手动试试！😉

功能

集 CleanMyMac、AppCleaner、DaisyDisk 和 iStat Menus 于一体的工具包：

• 深度清理 — 移除缓存、日志和浏览器残留
• 智能卸载程序 — 移除应用及隐藏的残留文件
• 磁盘分析 — 可视化磁盘使用情况，管理大型文件
• 实时监控 — 实时查看系统状态
• 项目构建产物清理 — 清理 node_modules、target、build 等

---

非交互式命令（适用于 Clawd）

预览 / 试运行（务必先执行）

mo clean --dry-run              # Preview cleanup plan
mo clean --dry-run --debug      # Detailed preview with risk levels & file info
mo optimize --dry-run           # Preview optimization actions
mo optimize --dry-run --debug   # Detailed optimization preview

执行清理

mo clean                        # Run deep cleanup (caches, logs, browser data, trash)
mo clean --debug                # Cleanup with detailed logs

系统优化

mo optimize                     # Rebuild caches, reset services, refresh Finder/Dock
mo optimize --debug             # With detailed operation logs

mo optimize 的功能：

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

白名单管理

mo clean --whitelist            # Manage protected cache paths
mo optimize --whitelist         # Manage protected optimization rules

项目构建产物清理

mo purge                        # Clean old build artifacts (node_modules, target, venv, etc.)
mo purge --paths                # Configure which directories to scan

配置文件：~/.config/mole/purge_paths

安装程序清理

mo installer                    # Find/remove .dmg, .pkg, .zip installers

扫描位置：下载目录、桌面、Homebrew 缓存、iCloud、邮件附件

设置与维护

mo touchid                      # Configure Touch ID for sudo
mo completion                   # Set up shell tab completion
mo update                       # Update Mole itself
mo remove                       # Uninstall Mole from system
mo --version                    # Show installed version
mo --help                       # Show help

---

典型工作流

1. 查看将要清理的内容：

   mo clean --dry-run --debug
   

2. 确认无误后，运行清理：

   mo clean
   

3. 优化系统（清理后）：

   mo optimize --dry-run
   mo optimize
   

4. 清理开发项目构建产物：

   mo purge
   

---

清理内容（mo clean）

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

注意事项

• 终端： 推荐使用 Ghostty、Alacritty、kitty、WezTerm。iTerm2 存在问题。
• 安全： 请先使用 --dry-run。该工具内置了严格的保护措施。
• 调试： 添加 --debug 可查看详细日志。