Disk Cleaner - Mac 智能磁盘清理助手
基于 Mole (https://github.com/tw93/Mole) 的用户友好包装器，负责「安装 + 执行 + 解释 + 把关 + 指路 + 统计 + 分享」。
Description
Disk Cleaner 是对 tw93 开发的 Mole 清理工具的增强封装。它提供了更友好的中文界面、分类报告、三档清理策略（Air/Pro/Max）、CSV 完整清单、白名单配置，以及清理完成后的精美成就页面（包含省钱计算和趣味统计）。
When to Use
Use this skill when users:
- 说硬盘空间不够、磁盘满了、存储不足
- 想清理 Mac 缓存或临时文件
- 询问如何释放磁盘空间
- 提到 Mole 工具
Features
- 🔍 环境检测: 自动检测 Homebrew 和 Mole 安装状态
- 📦 自动安装: 支持一键安装缺失依赖
- 📊 分类报告: 按类别展示可清理项目，区分安全/谨慎
- 🧭 三档策略: Air（最安全）/ Pro（推荐）/ Max（最大化）
- 📋 CSV 清单: 生成完整文件清单，保存到桌面
- ⚙️ 白名单配置: 预设模板 + 自定义路径保护
- 🎉 成就页面: 清理后展示省钱计算、趣味统计、可分享
- 🔒 安全保护: 显示已保护项目，支持确认机制
Usage
环境检查
python scripts/mole_cleaner.py --check预览清理内容
python scripts/mole_cleaner.py --preview # 终端文本报告
python scripts/mole_cleaner.py --preview --html # HTML 报告（自动打开浏览器）
python scripts/mole_cleaner.py --preview --csv # CSV 完整清单（保存到桌面）
python scripts/mole_cleaner.py --preview --json # JSON 格式输出执行清理（三档选择）
python scripts/mole_cleaner.py --clean --tier air --confirm # Air: 最安全
python scripts/mole_cleaner.py --clean --tier pro --confirm # Pro: 推荐
python scripts/mole_cleaner.py --clean --tier max --confirm # Max: 最大化
python scripts/mole_cleaner.py --clean --confirm # 默认全量清理白名单配置
python scripts/mole_cleaner.py --whitelist --show # 查看当前白名单
python scripts/mole_cleaner.py --whitelist --preset office # 添加白领办公预设
python scripts/mole_cleaner.py --whitelist --preset developer # 添加开发者预设
python scripts/mole_cleaner.py --whitelist --add ~/Documents/重要项目 # 添加自定义路径查看磁盘状态
python scripts/mole_cleaner.py --status显示成就页（测试）
python scripts/mole_cleaner.py --show-achievementWorkflow (Claude 交互流程)
1. 环境检测与安装
首先检查 Mole 是否已安装：
python scripts/mole_cleaner.py --check如果未安装，引导用户安装或使用 --auto-install。
2. 预览扫描
运行预览获取分析报告：
python scripts/mole_cleaner.py --preview3. 向用户展示选项
根据预览结果，向用户展示清理方案：
请选择你想执行的方案：
1. 🌬️ Air - 最安全，只清浏览器和日志 → X.XX GB
2. ⚡ Pro - 推荐，平衡安全与空间 → X.XX GB
3. 🚀 Max - 最大化释放硬盘空间 → X.XX GB
4. 📋 先看完整清单 - 生成 CSV 详细列表
5. ⚙️ 配置白名单 - 保护特定路径4. 处理用户选择
选择 1-3 (Air/Pro/Max):
# 确认后执行
python scripts/mole_cleaner.py --clean --tier air --confirm # 或 pro/max选择 4 (CSV 清单):
python scripts/mole_cleaner.py --preview --csv告知用户文件已保存到桌面并自动打开。
选择 5 (白名单配置): 展示预设选项：
office: 白领办公 - 保护.doc,.docx,.xls,.xlsx,.ppt,.pptx,.pdf 等developer: 开发者 - 保护代码和配置文件media: 媒体创作 - 保护视频、音频、图像项目
python scripts/mole_cleaner.py --whitelist --preset office
# 或添加自定义路径
python scripts/mole_cleaner.py --whitelist --add ~/Documents/重要项目5. 清理完成
清理完成后自动生成成就页面，包含：
- 释放空间大小
- 省钱计算（基于 SSD 价格）
- 趣味等价物（相当于多少张照片/首歌曲）
- 随机 tw93 夸夸
- GitHub 链接方便 Star
Safety Features
- 预览优先: 默认只预览，需要
--confirm才执行清理 - 分档策略: Air/Pro/Max 让用户根据风险偏好选择
- 白名单保护: 支持预设模板和自定义路径
- 保护清单: 显示 Mole 的 whitelist 保护项目
- 日志记录: 所有操作保存日志到
~/.config/mole-cleaner/logs/
Tier Definitions
| 档位 | 清理范围 | 风险等级 |
|---|---|---|
| 🌬️ Air | 浏览器缓存、系统日志 | 低风险 |
| ⚡ Pro | Air + 用户应用缓存、包管理器缓存、废纸篓 | 中等风险 |
| 🚀 Max | 所有可清理项目 | 较高风险 |
Whitelist Presets
| 预设 | 保护内容 |
|---|---|
| office | 办公文档 (.doc,.docx,.xls,.xlsx,.ppt,.pptx,.pdf,.pages,.numbers,.key) |
| developer | 代码和配置 (.py,.js,.ts,.go,.rs,.java,.swift,.json,.yaml,.toml) |
| media | 媒体项目 (.psd,.ai,.sketch,.fig,.aep,.prproj,.fcpx,.mov,.mp4) |
Dependencies
- macOS
- Homebrew
- Mole (
brew install tw93/tap/mole) - Python:
pip install jinja2
Output Structure
~/.config/mole-cleaner/
├── logs/ # 操作日志
├── reports/ # HTML 报告
└── achievements/ # 成就页面
~/Desktop/
└── mole-clean-list-YYYYMMDD-HHMMSS.csv # CSV 完整清单Credits
- Mole: https://github.com/tw93/Mole
- 作者: tw93 (https://tw93.fun)