名称： mole-mac-cleanup
描述： 集 CleanMyMac、AppCleaner、DaisyDisk 功能于一体的 Mac 清理与优化工具。提供深度清理、智能卸载、磁盘洞察和项目构建产物清理。
作者： Benjamin Jesuiter bjesuiter@gmail.com
元数据：
clawdbot:
emoji: "🧹"
os: ["darwin"]
requires:
bins: ["mo"]
install:
- id: brew
kind: brew
formula: mole
bins: ["mo"]
label: 通过 Homebrew 安装 Mole

Mole - Mac 清理与优化工具

仓库: https://github.com/tw93/Mole
命令: mo (不是 mole!)
安装: brew install mole

给人类用户的提示: 不带参数的 mo 命令会启动交互式 TUI 界面。这对自动化代理无用，但你可能想手动试试！😉

功能概述

集 CleanMyMac、AppCleaner、DaisyDisk 和 iStat Menus 功能于一体的全能工具包：
- 深度清理 — 清除缓存、日志、浏览器残留
- 智能卸载器 — 移除应用及其隐藏残留
- 磁盘洞察 — 可视化磁盘使用情况，管理大文件
- 实时监控 — 实时系统状态
- 项目构建产物清理 — 清理 node_modules、target、build 等

非交互式命令 (适用于 Clawd)

预览 / 模拟运行 (务必先执行此步)

mo clean --dry-run              # 预览清理计划
mo clean --dry-run --debug      # 带风险等级和文件详情的详细预览
mo optimize --dry-run           # 预览优化操作
mo optimize --dry-run --debug   # 详细的优化预览

执行清理

mo clean                        # 执行深度清理 (缓存、日志、浏览器数据、废纸篓)
mo clean --debug                # 清理并输出详细日志

系统优化

mo optimize                     # 重建缓存、重置服务、刷新 Finder/Dock
mo optimize --debug             # 优化并输出详细操作日志

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

白名单管理

mo clean --whitelist            # 管理受保护的缓存路径
mo optimize --whitelist         # 管理受保护的优化规则

项目构建产物清理

mo purge                        # 清理旧的构建产物 (node_modules, target, venv 等)
mo purge --paths                # 配置要扫描的目录

配置文件路径: ~/.config/mole/purge_paths

安装包清理

mo installer                    # 查找并移除 .dmg、.pkg、.zip 安装包

扫描范围: 下载文件夹、桌面、Homebrew 缓存、iCloud、邮件附件

设置与维护

mo touchid                      # 为 sudo 配置 Touch ID
mo completion                   # 设置 Shell 自动补全
mo update                       # 更新 Mole 自身
mo remove                       # 从系统中卸载 Mole
mo --version                    # 显示已安装版本
mo --help                       # 显示帮助信息

典型工作流

1. 检查将要清理的内容:
   bash mo clean --dry-run --debug

2. 如果预览结果没问题，执行清理:
   bash mo clean

3. 优化系统 (清理后执行):
   bash mo optimize --dry-run mo optimize

4. 清理开发项目构建产物:
   bash mo purge

清理范围 (mo clean)

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

注意事项

• 终端: 建议使用 Ghostty、Alacritty、kitty、WezTerm。iTerm2 可能存在兼容性问题。
• 安全性: 务必先使用 --dry-run 预览。工具内置了严格的保护机制。
• 调试: 添加 --debug 参数以获取详细日志。