Mac Maintenance Cleanup

Mac Maintenance Cleanup

概述

提供完整的 macOS 系统清理和维护工作流，基于 Mole 工具实现系统缓存清理、应用卸载、磁盘空间分析和开发环境清理。支持交互式菜单选择、智能诊断和安全操作（默认 dry-run + 用户确认）。

核心原则

1. 安全第一：默认使用 --dry-run 预览，危险操作前必须使用 AskUser 获取用户确认 2. 详细日志：记录所有操作，便于审计和回溯 3. 渐进式执行：从预览到确认再到执行，逐步推进 4. 用户自主：提供清晰的指导，用户可选择手动执行或让 AI 自动执行

工作流决策树

用户请求
   │
   ├─ 不确定需要什么清理？
   │  └─→ 运行智能诊断清理
   │
   ├─ 明确的清理需求
   │  │
   │  ├─ 快速清理/定期维护
   │  │  └─→ 日常清理
   │  │
   │  ├─ 磁盘空间不足/彻底清理
   │  │  └─→ 深度清理
   │  │
   │  └─ 开发环境/构建产物
   │     └─→ 开发者清理
   │
   └─ 特定操作
      ├─ 系统缓存 → mo clean --dry-run
      ├─ 应用卸载 → mo uninstall
      ├─ 磁盘分析 → mo analyze
      ├─ 系统优化 → mo optimize --dry-run
      ├─ 项目清理 → mo purge
      └─ 安装文件 → mo installer

清理场景

场景 1：日常清理

目标：快速清理系统缓存、日志和临时文件，定期维护系统健康。

工作流程：

1. 系统诊断（可选）

   mo status

显示系统健康状态：CPU、内存、磁盘使用率等

2. 预览清理计划

   mo clean --dry-run

列出将要清理的缓存和文件大小

3. 用户确认 使用 AskUser 确认是否执行清理：

• 显示预览结果
• 询问是否继续
• 提供"仅清理特定类别"选项

4. 执行清理

   # 根据用户确认执行
   mo clean                    # 全部清理
   # 或
   mo clean --whitelist        # 选择性清理

5. 记录结果 显示清理前后的磁盘空间对比

用户交互示例：

发现以下可清理内容：
- 用户应用缓存：45.2GB
- 浏览器缓存：10.5GB
- 开发者工具：23.3GB
- 系统日志和临时文件：3.8GB
- 废纸篓：12.3GB

预计释放空间：95.5GB

是否执行清理？
1. 全部清理
2. 选择性清理（跳过浏览器缓存）
3. 仅显示详细操作计划
4. 取消

场景 2：深度清理

目标：全面清理系统，包括应用卸载、大文件分析和系统优化。

工作流程：

1. 磁盘空间分析

   mo analyze

可视化显示磁盘使用情况，找出占用空间的大文件和目录

2. 应用卸载（如果需要）

   mo uninstall

交互式选择要卸载的应用，彻底删除应用及其残留文件

3. 深度清理缓存

   mo clean --dry-run --debug

显示详细的清理计划，包括风险等级和文件信息

4. 安装文件清理

   mo installer

查找并删除下载的安装文件（.dmg、.pkg 等）

5. 系统优化

   mo optimize --dry-run

预览优化操作：重建系统缓存、刷新服务等

6. 逐步确认和执行 每个步骤使用 AskUser 获取用户确认

用户交互示例：

深度清理包括以下步骤：
1. 磁盘空间分析 ✓
2. 应用卸载（发现 3 个不常用应用）
3. 深度缓存清理（预计释放 95.5GB）
4. 安装文件清理（发现 3.8GB 安装文件）
5. 系统优化（重建缓存和刷新服务）

希望从哪一步开始？
- 逐步执行（每步确认）
- 全部执行（最后确认）
- 跳过某些步骤

场景 3：开发者清理

目标：清理开发环境，删除 node_modules、构建产物等开发相关文件。

工作流程：

1. 扫描项目构建产物

   mo purge

扫描默认项目目录（~/Projects、~/GitHub、~/dev 等）

2. 显示清理选项 列出所有项目及其构建产物大小：

• 标记近期项目（<7天）为默认不选中
• 显示每个项目的构建类型（node_modules、target、venv 等）

3. 自定义扫描路径（可选）

   mo purge --paths

配置要扫描的项目目录

4. 确认并清理 使用 AskUser 确认要清理的项目

5. 记录清理结果 显示释放的空间和清理的项目列表

用户交互示例：

发现以下项目构建产物（总计 18.5GB）：

➤ ● my-react-app       3.2GB | node_modules  >6mo
  ● old-project        2.8GB | node_modules  >6mo
  ● rust-app           4.1GB | target        >6mo
  ○ current-work       856MB | node_modules  | Recent (2天)
  ● django-api         2.3GB | venv          >6mo

要清理哪些项目？
- 全部清理（保留近期项目）
- 选择性清理
- 查看详细信息
- 取消

场景 4：智能诊断清理

目标：根据系统状态自动判断需要执行哪些清理操作。

工作流程：

1. 系统健康检查

   mo status

获取系统状态：CPU、内存、磁盘、网络等

2. 磁盘空间分析

   mo analyze ~/Downloads ~/Documents

分析用户目录的磁盘使用情况

3. 智能判断 根据系统状态提出清理建议：

• 磁盘使用率 >80% → 建议深度清理
• 磁盘使用率 60-80% → 建议日常清理
• 发现大量开发项目 → 建议开发者清理
• 系统性能下降 → 建议系统优化

4. 提供清理方案 列出推荐的清理操作和预期效果

5. 用户选择 使用 AskUser 让用户选择要执行的清理方案

用户交互示例：

系统诊断结果：
- 磁盘使用率：78.3% (333/460 GB)
- 内存使用率：58.4% (14.2/24 GB)
- CPU 负载：正常
- 发现：8个旧项目，12.3GB 废纸篓，3.8GB 安装文件

推荐清理方案：
方案A：日常清理 + 开发者清理（预计释放 30GB）
方案B：深度清理（预计释放 110GB）
方案C：仅清理废纸篓和安装文件（预计释放 16GB）

选择方案或自定义清理操作？

安全策略

1. 默认 Dry-Run

所有清理操作默认使用 --dry-run 预览，不实际执行删除：

# 错误示例（直接执行）
mo clean

# 正确示例（先预览）
mo clean --dry-run

2. 用户确认

在执行任何危险操作前，必须使用 AskUser 获取用户明确同意：

确认模板：

即将执行以下操作：
- 清理系统缓存（45.2GB）
- 清理浏览器缓存（10.5GB）
- 清理废纸篓（12.3GB）

预计释放空间：67.7GB

确认执行？
- 是，执行清理
- 仅执行部分操作
- 取消

3. 详细操作日志

记录所有操作，包括：

• 执行的命令
• 时间戳
• 清理的文件和大小
• 清理前后的系统状态

4. 渐进式披露

对于高级选项，使用 --debug 和 --whitelist 提供更详细的信息：

mo clean --dry-run --debug    # 详细预览，包括风险等级
mo clean --whitelist          # 管理受保护的缓存路径

交互式菜单

主菜单结构

Mac 维护清理助手
══════════════════════════════

请选择清理模式：

1. 💨 日常清理（快速清理缓存和临时文件）
2. 🔍 深度清理（全面清理系统和应用）
3. 💻 开发者清理（清理项目构建产物）
4. 🩺 智能诊断（自动判断清理方案）
5. ⚙️  单独操作

选择模式（1-5）或描述你的需求：

单独操作菜单

单独操作
══════════════════════════════

1. 🧹 系统缓存清理（mo clean）
2. 🗑️  应用卸载（mo uninstall）
3. 📊 磁盘空间分析（mo analyze）
4. ⚡ 系统优化（mo optimize）
5. 📦 项目构建清理（mo purge）
6. 💿 安装文件清理（mo installer）
7. 📈 系统状态监控（mo status）

选择操作（1-7）：

资源引用

Mole 命令参考

详细命令说明请参考：references/mole-commands.md

包含：

• 所有 Mole 命令的详细用法
• 常用参数和选项
• 输出格式说明
• 最佳实践和注意事项

清理最佳实践

详细指南请参考：references/cleanup-best-practices.md

包含：

• 清理频率建议
• 安全注意事项
• 常见问题和解决方案
• 性能优化建议

平台兼容性

本 skill 主要基于 Mole 工具，专为 macOS 设计。对于跨平台需求：

• macOS：使用 Mole 工具（完整功能）
• Windows/Linux：提供等效的原生命令和替代工具

在非 macOS 平台上，参考 references/cross-platform-alternatives.md

使用示例

示例 1：快速日常清理

用户请求：

帮我清理一下 Mac 系统

AI 响应：

我来帮你清理 Mac 系统。首先让我检查一下系统状态：

[执行 mo status]

发现以下可清理内容：
- 用户应用缓存：45.2GB
- 浏览器缓存：10.5GB
- 系统日志：3.8GB

预计可释放：59.5GB

[使用 AskUser]
是否执行日常清理？
1. 执行清理（先预览再确认）
2. 仅显示详细清理计划
3. 自定义清理选项

示例 2：深度清理

用户请求：

我的磁盘空间不够了，需要深度清理

AI 响应：

我来帮你进行深度清理。让我先分析磁盘使用情况：

[执行 mo analyze]

发现以下问题：
- 磁盘使用率：82% (377/460 GB)
- 大型文件夹：Library (75.4GB)、Downloads (34.6GB)
- 可清理内容：缓存 95.5GB、安装文件 3.8GB

推荐深度清理方案：
1. 清理系统缓存（95.5GB）
2. 清理安装文件（3.8GB）
3. 卸载不常用应用（发现 3 个，共 12.8GB）

[使用 AskUser]
希望执行哪些清理操作？

示例 3：开发者清理

用户请求：

清理我的开发环境，删除旧的 node_modules

AI 响应：

我来帮你清理开发环境的构建产物：

[执行 mo purge]

发现以下项目构建产物（18.5GB）：
- my-react-app (3.2GB, node_modules)
- old-project (2.8GB, node_modules)
- current-work (856MB, node_modules, Recent)

[使用 AskUser]
要清理哪些项目？
1. 清理全部（保留近期项目）
2. 选择性清理
3. 查看详细信息

注意事项

1. 数据安全：虽然 Mole 设计安全，但文件删除是永久的，请仔细审查操作 2. 终端兼容性：iTerm2 有已知兼容性问题，推荐使用 Alacritty、kitty、WezTerm、Ghostty 或 Warp 3. 定期清理：建议每周或每月执行一次日常清理，保持系统健康 4. 备份重要数据：在执行深度清理前，建议备份重要数据

Mac 系统清理最佳实践

本文档提供 Mac 系统清理的最佳实践、安全注意事项和维护建议。

清理频率建议

日常清理（每周）

目标：保持系统流畅，防止缓存堆积

操作：

# 快速检查系统状态
mo status

# 预览并清理缓存
mo clean --dry-run
mo clean

清理内容：

• 系统缓存
• 浏览器缓存
• 应用临时文件
• 废纸篓

预期效果：释放 5-15GB 空间

深度清理（每月）

目标：彻底清理系统，释放更多空间

操作：

# 1. 磁盘分析
mo analyze

# 2. 深度清理缓存
mo clean --dry-run --debug
mo clean

# 3. 清理安装文件
mo installer

# 4. 系统优化
mo optimize --dry-run
mo optimize

清理内容：

• 所有缓存（包括开发者工具）
• 安装文件（.dmg、.pkg）
• 旧应用卸载
• 系统优化

预期效果：释放 30-100GB 空间

开发者清理（按需）

目标：清理开发环境，回收项目构建产物

操作：

# 扫描项目构建产物
mo purge

清理内容：

• node_modules
• target、build、dist
• venv、.venv
• .gradle、.m2

预期效果：释放 10-50GB 空间

---

清理前准备

1. 数据备份

在执行深度清理前，建议备份重要数据：

# 使用 Time Machine 备份
# 或手动备份重要文件到外部存储

2. 关闭应用

关闭所有正在运行的应用，尤其是：

• 浏览器（Chrome、Safari、Firefox）
• 开发工具（Xcode、IDE）
• 创意软件（Photoshop、Premiere）

3. 检查活动进程

# 检查是否有大文件正在使用
lsof | grep -E "(node|java|python)"

# 检查下载进程
ps aux | grep -E "(wget|curl)"

4. 保存工作

• 保存所有文档
• 提交代码更改
• 导出重要数据

---

安全注意事项

1. 始终预览

原则：永远不要在未预览的情况下执行清理

正确做法：

# 先预览
mo clean --dry-run

# 检查清理内容
# 确认无误后再执行
mo clean

2. 检查清理内容

在执行清理前，检查：

• 是否包含重要文件
• 是否正在下载或安装
• 是否有应用正在使用

3. 保护重要路径

使用 whitelist 保护重要缓存：

mo clean --whitelist

建议保护的路径：

• 工作项目缓存
• VPN 配置
• 应用特定数据

4. 分步执行

对于大型清理，分步执行：

# 第一步：清理缓存
mo clean

# 等待完成，检查系统状态

# 第二步：清理安装文件
mo installer

# 第三步：系统优化
mo optimize

---

清理后验证

1. 检查磁盘空间

# 查看磁盘使用情况
df -h

# 使用 Mole 查看详细状态
mo status

2. 验证应用功能

测试常用应用是否正常工作：

• 浏览器启动和加载
• 开发工具编译和运行
• 创意软件打开和保存

3. 检查系统功能

验证系统功能正常：

• 搜索功能（Spotlight）
• 通知中心
• Launchpad
• 系统偏好设置

4. 监控系统性能

观察清理后的性能变化：

• 应用启动速度（可能稍慢，缓存重建中）
• 系统响应速度
• 磁盘读写速度

注意：清理后首次启动应用可能较慢，这是正常现象（缓存重建中）

---

常见问题和解决方案

问题 1：清理后磁盘空间未释放

可能原因：

• 废纸篓未清空
• 交换文件未删除
• 本地快照占用空间

解决方案：

# 1. 清空废纸篓
rm -rf ~/.Trash/*

# 2. 检查本地快照
tmutil listlocalsnapshots /
tmutil deletelocalsnapshots com.apple.TimeMachine.

# 3. 重启系统（清理交换文件）
sudo reboot

问题 2：应用无法启动或崩溃

可能原因：

• 误删了应用必需的缓存
• 应用配置损坏

解决方案：

# 1. 重新安装应用
brew reinstall <app-name>

# 2. 恢复应用配置
# 从 Time Machine 恢复
~/Library/Preferences/<app-plist>

# 3. 重置应用
defaults delete com.<developer>.<app>

问题 3：系统性能下降

可能原因：

• Spotlight 正在重建索引
• 系统正在重建缓存

解决方案：

# 等待系统稳定（通常 1-2 小时）

# 检查 Spotlight 索引状态
mdutil -s /

# 如果需要，强制重建索引
sudo mdutil -E /

# 检查系统负载
mo status

问题 4：浏览器书签或历史丢失

可能原因：

• 误删了浏览器数据

解决方案：

# 从 Time Machine 恢复
~/Library/Safari/
~/Library/Application Support/Google/Chrome/
~/Library/Application Support/Firefox/

问题 5：开发环境损坏

可能原因：

• 误删了 node_modules 或其他依赖

解决方案：

# 重新安装依赖
npm install
# 或
yarn install

# 重新构建项目
npm run build

---

维护建议

1. 定期维护计划

创建定期维护计划：

# 每周一次日常清理
# 每月一次深度清理
# 每季度一次全面维护

# 使用 cron 或 launchd 自动化
# 创建定期清理提醒

2. 监控磁盘使用

定期检查磁盘使用情况：

# 每周检查
df -h

# 分析大文件
mo analyze ~/Documents ~/Downloads

# 设置磁盘空间警报
# 当磁盘使用率 >80% 时提醒

3. 管理下载文件

定期清理下载文件夹：

# 检查下载文件
ls -lh ~/Downloads

# 删除旧安装文件
mo installer

# 清理其他下载文件
find ~/Downloads -type f -mtime +30 -delete

4. 管理媒体文件

定期管理媒体文件：

# 检查媒体文件大小
du -sh ~/Movies ~/Music ~/Pictures

# 删除重复文件（使用第三方工具）
# gem install duplicates

# 压缩旧视频
# ffmpeg -i input.mp4 -crf 28 output.mp4

5. 管理开发项目

定期清理开发项目：

# 删除旧项目
find ~/Projects -type d -mtime +180 -exec rm -rf {} \;

# 清理构建产物
mo purge

# 清理 npm 缓存
npm cache clean --force

---

性能优化建议

1. 系统优化

# 重建系统数据库
mo optimize

# 重建 Spotlight 索引
sudo mdutil -E /

# 修复磁盘权限
diskutil repairDisk /

2. 应用优化

• 关闭不必要的启动项
• 禁用不必要的通知
• 清理应用偏好设置

3. 网络优化

# 重置网络
mo optimize

# 清理 DNS 缓存
sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder

# 更换 DNS 服务器（如果需要）
# 系统偏好设置 > 网络 > 高级 > DNS

4. 显示优化

• 减少透明度和动画效果
• 关闭动态壁纸
• 调整显示器分辨率

---

专业建议

1. 备份策略

• 使用 Time Machine 定期备份
• 使用云服务备份重要文件
• 定期测试备份恢复

2. 清理时机

• 在系统空闲时清理
• 避免在重要任务前清理
• 选择周末或假期进行深度清理

3. 清理日志

记录清理操作：

# 创建清理日志
echo "$(date): 开始清理" >> ~/cleanup.log

# 记录清理结果
mo clean --dry-run >> ~/cleanup.log

# 保存清理前后对比

4. 自动化

使用自动化工具：

# 创建清理脚本
cat > ~/cleanup.sh << 'EOF'
#!/bin/bash
mo clean --dry-run
mo clean
EOF

# 设置可执行权限
chmod +x ~/cleanup.sh

# 使用 launchd 定期执行
# 创建 ~/Library/LaunchAgents/com.user.cleanup.plist

---

参考资源

• Mole 官方文档：https://github.com/tw93/mole
• Apple 官方维护指南：https://support.apple.com/zh-cn/macos
• macOS 存储管理：系统偏好设置 > 关于本机 > 存储空间

---

总结

遵循这些最佳实践，可以：

1. 安全清理：避免误删重要文件 2. 优化性能：保持系统流畅运行 3. 释放空间：最大化磁盘使用效率 4. 预防问题：减少系统故障和数据丢失

记住：清理是为了优化，不是为了冒险。始终谨慎操作，定期备份。

跨平台清理替代方案

本文档提供在不同操作系统上执行系统清理的替代方案和工具。

目录

• Windows 替代方案
• Linux 替代方案
• 跨平台工具
• 命令对照表

---

Windows 替代方案

系统缓存清理

内置工具

1. 磁盘清理工具

# 打开磁盘清理
cleanmgr

# 通过命令行运行
cleanmgr /d C: /lowdisk

功能：

• 临时文件清理
• 系统缓存清理
• 回收站清理
• 缩略图缓存

2. Storage Sense（存储感知）

Windows 10/11 内置的自动清理功能。

设置路径：设置 > 系统 > 存储 > 存储感知

3. PowerShell 命令

# 清理临时文件
Remove-Item -Path $env:TEMP\* -Recurse -Force
Remove-Item -Path C:\Windows\Temp\* -Recurse -Force

# 清理 Windows Update 缓存
Stop-Service -Name wuauserv
Remove-Item -Path C:\Windows\SoftwareDistribution\Download\* -Recurse -Force
Start-Service -Name wuauserv

# 清理回收站
Clear-RecycleBin -Force

第三方工具

1. BleachBit

开源的磁盘清理工具，类似 CCleaner。

下载：https://www.bleachbit.org/

功能：

• 缓存清理
• 临时文件清理
• 浏览器历史清理
• 隐私保护

使用方法：

# 下载并安装 BleachBit
# 运行图形界面或命令行
bleachbit.exe --clean

2. WizTree

快速的磁盘空间分析工具。

下载：https://www.diskanalyzer.com/

功能：

• 磁盘空间分析
• 大文件查找
• 文件类型统计

---

应用卸载

内置工具

1. 控制面板

# 打开程序和功能
appwiz.cpl

2. PowerShell

# 列出已安装程序
Get-WmiObject -Class Win32_Product | Select-Object Name, Version

# 卸载程序（需要程序的具体 GUID）
msiexec /x {GUID} /qn

第三方工具

1. Revo Uninstaller

强大的卸载工具，可以彻底卸载应用及其残留文件。

下载：https://www.revouninstaller.com/

功能：

• 彻底卸载
• 残留文件清理
• 注册表清理
• 强制卸载

2. Geek Uninstaller

轻量级的卸载工具。

下载：http://www.geekuninstaller.com/

---

磁盘空间分析

内置工具

1. Storage Usage

设置 > 系统 > 存储

2. PowerShell

# 查看磁盘使用情况
Get-PSDrive -PSProvider FileSystem

# 查找大文件
Get-ChildItem -Path C:\ -Recurse -ErrorAction SilentlyContinue |
    Where-Object { $_.Length -gt 1GB } |
    Select-Object FullName, @{Name='Size(GB)';Expression={[math]::Round($_.Length/1GB,2)}} |
    Sort-Object 'Size(GB)' -Descending

第三方工具

1. WinDirStat

磁盘空间可视化工具。

下载：https://windirstat.net/

2. SpaceSniffer

磁盘空间分析工具。

下载：http://www.uderzo.it/main_products/space_sniffer/

---

项目构建清理

Node.js 项目

# 删除 node_modules
Get-ChildItem -Include node_modules -Recurse | Remove-Item -Recurse -Force

# 删除 npm 缓存
npm cache clean --force

Python 项目

# 删除虚拟环境
Get-ChildItem -Include venv,.venv -Recurse -Directory | Remove-Item -Recurse -Force

# 删除 __pycache__
Get-ChildItem -Include __pycache__ -Recurse | Remove-Item -Recurse -Force

---

Linux 替代方案

系统缓存清理

包管理器清理

Debian/Ubuntu (apt)

# 清理不再需要的包
sudo apt autoremove

# 清理 apt 缓存
sudo apt clean
sudo apt autoclean

# 删除孤立的包
sudo deborphan | xargs sudo apt-get -y remove --purge

Fedora/RHEL (dnf)

# 清理不再需要的包
sudo dnf autoremove

# 清理 dnf 缓存
sudo dnf clean all

# 删除重复的包
sudo dnf repoquery --duplicates

Arch Linux (pacman)

# 清理缓存
sudo pacman -Sc

# 删除不再需要的包
sudo pacman -Qtdq | sudo pacman -Rns -

# 清理未安装包的缓存
sudo paccache -ruk0

系统清理工具

1. BleachBit

# 安装
sudo apt install bleachbit  # Debian/Ubuntu
sudo dnf install bleachbit  # Fedora

# 运行
bleachbit

2. Stacer

Linux 系统优化和清理工具。

# 安装
sudo apt install stacer  # Debian/Ubuntu

# 运行
stacer

---

应用卸载

Debian/Ubuntu

# 卸载但保留配置
sudo apt remove package-name

# 完全卸载（包括配置）
sudo apt purge package-name

# 清理残留配置
sudo apt autoremove

Fedora/RHEL

# 卸载
sudo dnf remove package-name

# 删除不再需要的依赖
sudo dnf autoremove

Arch Linux

# 卸载
sudo pacman -R package-name

# 完全卸载（包括配置和依赖）
sudo pacman -Rns package-name

---

磁盘空间分析

1. ncdu

基于 ncurses 的磁盘使用分析工具。

# 安装
sudo apt install ncdu  # Debian/Ubuntu
sudo dnf install ncdu  # Fedora

# 运行
ncdu /
ncdu ~/

2. du + human-readable

# 查看目录大小
du -sh ~/* | sort -hr

# 查看最大的 10 个目录
du -h --max-depth=1 ~/ | sort -hr | head -n 10

# 查找大于 100MB 的文件
find ~ -type f -size +100M -exec du -sh {} \; | sort -hr

3. df

# 查看磁盘使用情况
df -h

---

项目构建清理

Node.js

# 删除 node_modules
find ~ -type d -name "node_modules" -prune -exec rm -rf {} \;

# 清理 npm 缓存
npm cache clean --force

# 清理 yarn 缓存
yarn cache clean

Python

# 删除虚拟环境
find ~ -type d -name "venv" -prune -exec rm -rf {} \;
find ~ -type d -name ".venv" -prune -exec rm -rf {} \;

# 删除 __pycache__
find ~ -type d -name "__pycache__" -prune -exec rm -rf {} \;
find ~ -type f -name "*.pyc" -delete

Rust

# 删除 target 目录
find ~ -type d -name "target" -prune -exec rm -rf {} \;

# 清理 Cargo 缓存
cargo clean

Java/Maven

# 删除 .m2 目录
find ~ -type d -name ".m2" -prune -exec rm -rf {} \;

Go

# 清理 Go 模块缓存
go clean -modcache

---

跨平台工具

1. BleachBit

支持 Windows、Linux 的跨平台清理工具。

网站：https://www.bleachbit.org/

功能：

• 系统缓存清理
• 浏览器数据清理
• 临时文件清理
• 隐私保护

2. ncdu

终端磁盘使用分析工具，支持 Linux、macOS。

# 安装
sudo apt install ncdu  # Debian/Ubuntu
brew install ncdu      # macOS

3. du 和 df

所有 Unix-like 系统（Linux、macOS）都内置的工具。

# 查看目录大小
du -sh directory

# 查看磁盘使用
df -h

4. Fossil

跨平台的磁盘清理工具。

网站：https://github.com/maxkluster/fossil

---

命令对照表

系统状态查看

缓存清理

应用卸载

项目清理

---

平台检测脚本

在跨平台脚本中，可以这样检测平台：

#!/bin/bash

# 检测操作系统
OS="$(uname -s)"
case "${OS}" in
  Linux*)     machine=Linux;;
  Darwin*)    machine=Mac;;
  MINGW*MSYS*)machine=Windows;;
  *)          machine="UNKNOWN:${OS}"
esac

echo "检测到平台: ${machine}"

# 根据平台执行不同命令
if [ "${machine}" = "Mac" ]; then
  # macOS 命令
  mo clean --dry-run
elif [ "${machine}" = "Linux" ]; then
  # Linux 命令
  sudo apt clean
elif [ "${machine}" = "Windows" ]; then
  # Windows 命令
  cleanmgr
fi

PowerShell 版本：

# 检测平台
if ($IsMacOS) {
    # macOS 命令
    mo clean --dry-run
} elseif ($IsLinux) {
    # Linux 命令
    sudo apt clean
} elseif ($IsWindows) {
    # Windows 命令
    cleanmgr
}

---

建议

1. macOS 用户

• 使用 Mole（主要工具）
• 参考 mole-commands.md

2. Windows 用户

• 使用 BleachBit 和 Revo Uninstaller
• 定期运行磁盘清理工具
• 考虑使用 Storage Sense 自动清理

3. Linux 用户

• 使用包管理器清理
• BleachBit 和 Stacer
• ncdu 进行磁盘分析

4. 跨平台项目

• 使用平台检测脚本
• 为每个平台提供等效命令
• 测试所有平台的功能

---

注意事项

1. Windows 和 Linux 的清理工具功能可能不如 Mole 全面 2. 某些功能可能需要组合多个工具才能实现 3. 建议在清理前备份重要数据 4. Linux 不同发行版的包管理器命令可能不同 5. Windows 工具通常需要管理员权限

---

参考资源

• BleachBit: https://www.bleachbit.org/
• Revo Uninstaller: https://www.revouninstaller.com/
• Stacer: https://oguzhaninan.github.io/Stacer-Web/
• ncdu: https://dev.yorhel.nl/ncdu

Mole 命令参考

本文档提供 Mole 工具的详细命令说明、参数选项和最佳实践。

安装

# 通过 Homebrew 安装
brew install mole

# 或通过安装脚本
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash

核心命令

mo clean - 深度系统清理

清理系统缓存、日志和临时文件。

基本用法：

mo clean

推荐用法（先预览）：

mo clean --dry-run

常用参数：

• --dry-run - 预览清理计划，不实际删除
• --debug - 显示详细日志，包括风险等级和文件信息
• --whitelist - 管理受保护的缓存路径

输出示例：

Scanning cache directories...

  ✓ User app cache                                           45.2GB
  ✓ Browser cache (Chrome, Safari, Firefox)                  10.5GB
  ✓ Developer tools (Xcode, Node.js, npm)                    23.3GB
  ✓ System logs and temp files                                3.8GB
  ✓ App-specific cache (Spotify, Dropbox, Slack)              8.4GB
  ✓ Trash                                                    12.3GB

====================================================================
Space freed: 95.5GB | Free space now: 223.5GB
====================================================================

清理内容：

• 用户应用缓存（~/Library/Caches）
• 浏览器缓存（Chrome、Safari、Firefox）
• 开发者工具缓存（Xcode、npm、yarn）
• 系统日志和临时文件
• 应用特定缓存
• 废纸篓

安全注意事项：

• 始终先使用 --dry-run 预览
• 检查清理内容，确认没有重要文件
• 某些缓存删除后可能会影响应用启动速度（首次启动时重新生成）

---

mo uninstall - 智能应用卸载

彻底卸载应用及其相关文件。

基本用法：

mo uninstall

工作流程： 1. 显示已安装应用列表 2. 选择要卸载的应用 3. 扫描并显示相关文件 4. 确认后彻底删除

输出示例：

Select Apps to Remove
═════════════════════════════
▶ ☑ Photoshop 2024            (4.2G) | Old
  ☐ IntelliJ IDEA             (2.8G) | Recent
  ☐ Premiere Pro              (3.4G) | Recent

Uninstalling: Photoshop 2024

  ✓ Removed application
  ✓ Cleaned 52 related files across 12 locations
    - Application Support, Caches, Preferences
    - Logs, WebKit storage, Cookies
    - Extensions, Plugins, Launch daemons

====================================================================
Space freed: 12.8GB
====================================================================

清理位置：

• 应用程序本身
• ~/Library/Application Support
• ~/Library/Caches
• ~/Library/Preferences
• ~/Library/Logs
• ~/Library/WebKit
• ~/Library/Extensions
• ~/Library/LaunchAgents/Daemons

注意事项：

• 卸载是永久性的，无法撤销
• 某些应用可能需要手动清理残留文件
• 检查应用是否有内置的卸载程序

---

mo analyze - 磁盘空间分析

可视化的磁盘空间分析工具。

基本用法：

mo analyze

# 分析特定目录
mo analyze ~/Documents ~/Downloads

输出示例：

Analyze Disk  ~/Documents  |  Total: 156.8GB

 ▶  1. ███████████████████  48.2%  |  📁 Library                     75.4GB  >6mo
    2. ██████████░░░░░░░░░  22.1%  |  📁 Downloads                   34.6GB
    3. ████░░░░░░░░░░░░░░░  14.3%  |  📁 Movies                      22.4GB
    4. ███░░░░░░░░░░░░░░░░  10.8%  |  📁 Documents                   16.9GB
    5. ██░░░░░░░░░░░░░░░░░   5.2%  |  📄 backup_2023.zip              8.2GB

  ↑↓←→ Navigate  |  O Open  |  F Show  |  ⌫ Delete  |  L Large files  |  Q Quit

快捷键：

• ↑↓←→ 或 hjkl - 导航
• O - 打开文件/文件夹
• F - 显示文件信息
• ⌫ 或 d - 删除文件
• L - 显示大文件列表
• Q - 退出

使用场景：

• 找出占用大量空间的文件和目录
• 识别可以清理的内容
• 规划清理策略

---

mo optimize - 系统优化

重建系统缓存、刷新服务和优化性能。

基本用法：

mo optimize

推荐用法（先预览）：

mo optimize --dry-run

输出示例：

System: 5/32 GB RAM | 333/460 GB Disk (72%) | Uptime 6d

  ✓ Rebuild system databases and clear caches
  ✓ Reset network services
  ✓ Refresh Finder and Dock
  ✓ Clean diagnostic and crash logs
  ✓ Remove swap files and restart dynamic pager
  ✓ Rebuild launch services and spotlight index

====================================================================
System optimization completed
====================================================================

优化内容：

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

参数：

• --dry-run - 预览优化操作
• --debug - 显示详细操作日志
• --whitelist - 管理受保护的优化规则

注意事项：

• 某些优化可能需要重启才能生效
• 重建 Spotlight 索引可能需要较长时间
• 建议在系统空闲时执行

---

mo purge - 项目构建产物清理

清理开发项目的构建产物（node_modules、target、build 等）。

基本用法：

mo purge

自定义扫描路径：

mo purge --paths

输出示例：

Select Categories to Clean - 18.5GB (8 selected)

➤ ● my-react-app       3.2GB | node_modules
  ● old-project        2.8GB | node_modules
  ● rust-app           4.1GB | target
  ● next-blog          1.9GB | node_modules
  ○ current-work       856MB | node_modules  | Recent
  ● django-api         2.3GB | venv
  ● vue-dashboard      1.7GB | node_modules
  ● backend-service    2.5GB | node_modules

清理的构建产物类型：

• node_modules (Node.js/npm)
• target (Rust/Cargo)
• build、dist (前端框架)
• venv、.venv (Python)
• .gradle (Android/Java)
• .m2 (Maven)

智能识别：

• 标记近期项目（<7天）为默认不选中
• 显示项目最后修改时间
• 按大小排序

注意事项：

• 删除后需要重新构建项目
• 建议在清理前提交代码更改
• 保留正在活跃开发的项目

---

mo installer - 安装文件清理

查找并删除安装文件（.dmg、.pkg、.zip 等）。

基本用法：

mo installer

输出示例：

Select Installers to Remove - 3.8GB (5 selected)

➤ ● Photoshop_2024.dmg     1.2GB | Downloads
  ● IntelliJ_IDEA.dmg       850.6MB | Downloads
  ● Illustrator_Setup.pkg   920.4MB | Downloads
  ● PyCharm_Pro.dmg         640.5MB | Homebrew
  ● Acrobat_Reader.dmg      220.4MB | Downloads
  ○ AppCode_Legacy.zip      410.6MB | Downloads

扫描位置：

• ~/Downloads
• ~/Desktop
• ~/Library/Caches/Homebrew
• iCloud Drive
• Mail 附件

支持的文件类型：

• .dmg (磁盘镜像)
• .pkg (macOS 安装包)
• .zip (压缩包)
• .tar.gz (压缩包)
• .exe (Windows 安装程序)

---

mo status - 系统状态监控

实时显示系统健康状态和性能指标。

基本用法：

mo status

输出示例：

Mole Status  Health ● 92  MacBook Pro · M4 Pro · 32GB · macOS 14.5

⚙ CPU                                    ▦ Memory
Total   ████████████░░░░░░░  45.2%       Used    ███████████░░░░░░░  58.4%
Load    0.82 / 1.05 / 1.23 (8 cores)     Total   14.2 / 24.0 GB
Core 1  ███████████████░░░░  78.3%       Free    ████████░░░░░░░░░░  41.6%
Core 2  ████████████░░░░░░░  62.1%       Avail   9.8 GB

▤ Disk                                   ⚡ Power
Used    █████████████░░░░░░  67.2%       Level   ██████████████████  100%
Free    156.3 GB                         Status  Charged
Read    ▮▯▯▯▯  2.1 MB/s                  Health  Normal · 423 cycles
Write   ▮▮▮▯▯  18.3 MB/s                 Temp    58°C · 1200 RPM

⇅ Network                                ▶ Processes
Down    ▮▮▯▯▯  3.2 MB/s                  Code       ▮▮▮▮▯  42.1%
Up      ▮▯▯▯▯  0.8 MB/s                  Chrome     ▮▮▮▯▯  28.3%
Proxy   HTTP · 192.168.1.100             Terminal   ▮▯▯▯▯  12.5%

显示内容：

• CPU 使用率和负载
• 内存使用情况
• 磁盘使用和 I/O
• 电池状态和健康
• 网络流量
• 资源占用最高的进程

快捷键：

• k - 切换猫咪可见性
• q - 退出

健康评分： 基于 CPU、内存、磁盘、温度和 I/O 负载综合计算。

---

配置命令

mo touchid - 配置 Touch ID

配置 Touch ID 用于 sudo 验证。

mo touchid

mo completion - Shell 自动补全

设置命令行自动补全。

mo completion

支持的 Shell：bash、zsh、fish

mo update - 更新 Mole

更新到最新版本。

mo update

mo remove - 卸载 Mole

从系统中卸载 Mole。

mo remove

---

常用组合命令

日常清理流程

# 1. 查看系统状态
mo status

# 2. 预览清理计划
mo clean --dry-run

# 3. 执行清理
mo clean

深度清理流程

# 1. 磁盘分析
mo analyze

# 2. 清理缓存
mo clean --dry-run --debug

# 3. 清理安装文件
mo installer

# 4. 系统优化
mo optimize --dry-run

开发者清理流程

# 1. 检查项目构建产物
mo purge

# 2. 清理开发者工具缓存
mo clean --dry-run --debug | grep -E "(Xcode|Node|npm|yarn)"

---

最佳实践

1. 安全第一

• 始终使用 --dry-run 预览
• 检查清理内容
• 定期备份重要数据

2. 定期清理

• 日常清理：每周一次
• 深度清理：每月一次
• 项目清理：根据需要

3. 清理前检查

• 关闭所有应用
• 保存工作
• 检查正在运行的服务

4. 清理后验证

• 检查应用是否正常工作
• 验证系统功能
• 监控系统性能

5. 日志记录

• 保存清理日志
• 记录清理时间
• 跟踪清理效果

---

故障排查

问题：命令执行失败

解决方案：

# 检查 Mole 是否正确安装
which mo
mo --version

# 重新安装
brew reinstall mole

问题：清理后应用变慢

原因：缓存删除后需要重新生成

解决方案：

• 正常现象，首次启动时会重建缓存
• 考虑使用 --whitelist 保护某些缓存

问题：磁盘空间未释放

检查：

# 清废纸篓
rm -rf ~/.Trash/*

# 检查交换文件
swapfile list

---

参考链接

• 官方文档：https://github.com/tw93/mole
• 问题反馈：https://github.com/tw93/mole/issues