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-achievement

Workflow (Claude 交互流程)

1. 环境检测与安装

首先检查 Mole 是否已安装：

python scripts/mole_cleaner.py --check

如果未安装，引导用户安装或使用 --auto-install。

2. 预览扫描

运行预览获取分析报告：

python scripts/mole_cleaner.py --preview

3. 向用户展示选项

根据预览结果，向用户展示清理方案：

请选择你想执行的方案：

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

Whitelist Presets

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)