Help us improve
Share bugs, ideas, or general feedback.
From greentrain-files
Mac disk cleanup assistant wrapping the Mole tool. Detects, previews, and cleans cache/temp files with tiered safety levels, whitelist config, CSV reports, and achievement pages.
npx claudepluginhub crazynomad/skills --plugin greentrain-mediaHow this skill is triggered — by the user, by Claude, or both
Slash command
/greentrain-files:disk-cleanerThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
基于 Mole (https://github.com/tw93/Mole) 的用户友好包装器,负责「安装 + 执行 + 解释 + 把关 + 指路 + 统计 + 分享」。
Automates macOS disk cleanup and memory monitoring with Mole-based safety guards and LaunchAgent alerting. Responds to low disk space, kernel panics, and vm-compressor shortages on Apple Silicon.
Analyzes local Mac disk usage, validates snapshot completeness, and identifies cleanup candidates. Defaults to dry-run preview and requires explicit approval before any deletion. Useful when disk usage is high or user wants to understand disk growth.
Orchestrates a three-phase Mac file management workflow: disk cleanup, file organization, and document analysis using sub-skills disk-cleaner, file-organizer, and doc-mindmap.
Share bugs, ideas, or general feedback.
基于 Mole (https://github.com/tw93/Mole) 的用户友好包装器,负责「安装 + 执行 + 解释 + 把关 + 指路 + 统计 + 分享」。
Disk Cleaner 是对 tw93 开发的 Mole 清理工具的增强封装。它提供了更友好的中文界面、分类报告、三档清理策略(Air/Pro/Max)、CSV 完整清单、白名单配置,以及清理完成后的精美成就页面(包含省钱计算和趣味统计)。
Use this skill when users:
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
首先检查 Mole 是否已安装:
python scripts/mole_cleaner.py --check
如果未安装,引导用户安装或使用 --auto-install。
运行预览获取分析报告:
python scripts/mole_cleaner.py --preview
根据预览结果,向用户展示清理方案:
请选择你想执行的方案:
1. 🌬️ Air - 最安全,只清浏览器和日志 → X.XX GB
2. ⚡ Pro - 推荐,平衡安全与空间 → X.XX GB
3. 🚀 Max - 最大化释放硬盘空间 → X.XX GB
4. 📋 先看完整清单 - 生成 CSV 详细列表
5. ⚙️ 配置白名单 - 保护特定路径
选择 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/重要项目
清理完成后自动生成成就页面,包含:
--confirm 才执行清理~/.config/mole-cleaner/logs/| 档位 | 清理范围 | 风险等级 |
|---|---|---|
| 🌬️ Air | 浏览器缓存、系统日志 | 低风险 |
| ⚡ Pro | Air + 用户应用缓存、包管理器缓存、废纸篓 | 中等风险 |
| 🚀 Max | 所有可清理项目 | 较高风险 |
| 预设 | 保护内容 |
|---|---|
| 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) |
brew install tw93/tap/mole)pip install jinja2~/.config/mole-cleaner/
├── logs/ # 操作日志
├── reports/ # HTML 报告
└── achievements/ # 成就页面
~/Desktop/
└── mole-clean-list-YYYYMMDD-HHMMSS.csv # CSV 完整清单