メニュー
分析并通过智能清理建议回收 macOS 磁盘空间。当用户报告磁盘空间问题、需要清理 Mac 或想了解什么占用了存储空间时，应使用此技能。专注于安全的交互式分析，在执行任何删除操作前需要用户确认。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/evanfang0054/cc-system-creator-scripts --skill macos-cleanerコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
Mac 系统深度清理和优化工具。使用 Mole (mo 命令) 执行系统清理、磁盘分析、应用卸载、系统优化等任务。 触发场景（当用户提到以下任一内容时使用此 skill）： - 清理 Mac、清理磁盘、释放空间、清理缓存、清理系统 - 卸载应用、删除应用、移除应用及其残留 - 磁盘分析、查看磁盘占用、大文件查找、空间分析 - 系统优化、系统维护、刷新系统、重建缓存 - 系统状态、系统监控、CPU/内存/磁盘监控 - 清理 node_modules、清理构建产物、清理项目依赖 - 清理安装包、删除 dmg/pkg 文件 - Mac 清理工具、类似 CleanMyMac 的功能 - "我的 Mac 太慢了"、"磁盘空间不足"、"电脑卡顿" - 即使没有明确说 "Mole"，只要涉及上述场景就应使用
构建 CLI / command-line 工具时使用，支持两种模式。模式 A 人类 CLI（终端 UX、彩色、交互式提示、进度条、Shell 自动补全），关键词包括 commander / yargs / oclif / typer / click / cobra。模式 B agent-native CLI（JSON envelope / schema 自省 / dry-run 写入安全 / 契约驱动），关键词包括 agent-native CLI、JSON envelope、friction signal。混合场景默认走 B（agent 约束更严格）。只要用户提到 CLI、command-line、命令行工具、agent-native、envelope、schema、friction signal，或要给 agent 提供可调用的 CLI 工具，就应主动使用此 skill。
快速搭建和配置 pnpm monorepo 项目结构，包含 TypeScript、tsup 构建、私有 npm registry 配置。当用户需要"创建 monorepo"、"初始化 monorepo 项目"、"配置 pnpm workspace"、"设置 monorepo 构建"、"monorepo setup"时使用。特别适合需要统一管理多个包、配置构建工具、处理 TypeScript 路径问题的场景。即使用户只是说"帮我搭建项目结构"或"配置构建"，如果涉及多包管理也应该使用此 skill。
| name | macos-cleaner |
| description | 分析并通过智能清理建议回收 macOS 磁盘空间。当用户报告磁盘空间问题、需要清理 Mac 或想了解什么占用了存储空间时，应使用此技能。专注于安全的交互式分析，在执行任何删除操作前需要用户确认。 |
智能分析 macOS 磁盘使用情况并提供可执行的清理建议以回收存储空间。此技能遵循安全第一的原则：彻底分析，呈现清晰的发现，并在执行任何删除操作前要求明确的用户确认。
目标用户：具有基本技术知识的用户，了解文件系统但需要指导哪些内容在 macOS 上可以安全删除。
rm -rf、mo clean 等）。没有捷径，没有变通方法。绝对禁止：
rm -rfmo cleandocker volume prune -f 或 docker system prune -a --volumes--help（除了 mo --help）用户报告磁盘空间问题
↓
快速诊断
↓
┌──────┴──────┐
│ │
立即清理 深度分析
│ (继续下方)
│ │
└──────┬──────┘
↓
呈现发现
↓
用户确认
↓
执行清理
↓
验证结果
主要工具：使用 Mole 进行磁盘分析。它提供全面的、分类的结果。
# 检查 Mole 安装和版本
which mo && mo --version
# 如果未安装
brew install tw93/tap/mole
# 检查更新（Mole 经常更新）
brew info tw93/tap/mole | head -5
# 如果过时则升级
brew upgrade tw93/tap/mole
重要：使用 mo analyze 作为主要分析工具，而不是 mo clean --dry-run。
| 命令 | 目的 | 使用时机 |
|---|---|---|
mo analyze | 交互式磁盘使用浏览器（TUI 树视图） | 主要：了解什么占用了空间 |
mo clean --dry-run | 预览清理类别 | 次要：仅在 mo analyze 之后查看清理预览 |
为什么优先使用 mo analyze：
重要：Mole 需要 TTY。从 Claude Code 使用时始终使用 tmux。
关键时间说明：主目录扫描很慢（对于大目录需要 5-10 分钟或更长时间）。提前告知用户并耐心等待。
# 创建 tmux 会话
tmux new-session -d -s mole -x 120 -y 40
# 运行磁盘分析（主要工具 - 交互式 TUI）
tmux send-keys -t mole 'mo analyze' Enter
# 等待扫描 - 耐心等待！
# 主目录扫描通常需要 5-10 分钟
# 定期向用户报告进度
sleep 60 && tmux capture-pane -t mole -p
# 使用箭头键导航 TUI
tmux send-keys -t mole Down # 移动到下一项
tmux send-keys -t mole Enter # 展开/选择项目
tmux send-keys -t mole 'q' # 完成后退出
替代方案：清理预览（在 mo analyze 之后使用）
# 运行试运行预览（安全 - 无删除）
tmux send-keys -t mole 'mo clean --dry-run' Enter
# 等待扫描（每 30 秒向用户报告进度）
# 耐心等待！大目录需要 5-10 分钟
sleep 30 && tmux capture-pane -t mole -p
定期向用户报告扫描进度：
📊 磁盘分析进行中...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⏱️ 已用时间：2 分钟
当前状态：
✅ 应用程序：49.5 GB（完成）
✅ 系统库：10.3 GB（完成）
⏳ 主目录：扫描中...（这可能需要 5-10 分钟）
⏳ 应用库：待处理
我正在耐心等待扫描完成。
将在 30 秒后再次报告...
扫描完成后，呈现结构化结果：
📊 磁盘空间分析（通过 Mole）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
可用空间：27 GB
🧹 可恢复空间（试运行预览）：
➤ 用户必备项
• 用户应用缓存： 16.67 GB
• 用户应用日志： 102.3 MB
• 废纸篓： 642.9 MB
➤ 浏览器缓存
• Chrome 缓存： 1.90 GB
• Safari 缓存： 4 KB
➤ 开发工具
• uv 缓存： 9.96 GB
• npm 缓存： （已检测）
• Docker 缓存： （已检测）
• Homebrew 缓存： （已检测）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
总可恢复：~30 GB
⚠️ 这是试运行预览。未删除任何文件。
系统地扫描以下类别。参考 references/cleanup_targets.md 获取详细说明。
要分析的位置：
~/Library/Caches/* - 用户应用缓存/Library/Caches/* - 系统范围缓存（需要 sudo）~/Library/Logs/* - 应用日志/var/log/* - 系统日志（需要 sudo）分析脚本：
scripts/analyze_caches.py --user-only
安全级别：🟢 通常可以安全删除（应用会重新生成缓存）
要保留的例外：
要分析的位置：
~/Library/Application Support/* - 应用数据~/Library/Preferences/* - 偏好设置文件~/Library/Containers/* - 沙盒应用数据分析方法：
/Applications 中已安装的应用~/Library/Application Support 交叉引用分析脚本：
scripts/find_app_remnants.py
安全级别：🟡 需要谨慎
分析脚本：
scripts/analyze_large_files.py --threshold 100MB --path ~
查找重复项（可选，资源密集型）：
# 如果安装了 fdupes 则使用
if command -v fdupes &> /dev/null; then
fdupes -r ~/Documents ~/Downloads
fi
呈现发现：
📦 大文件（>100MB）：
━━━━━━━━━━━━━━━━━━━━━━━━
1. movie.mp4 4.2 GB ~/Downloads
2. dataset.csv 1.8 GB ~/Documents/data
3. old_backup.zip 1.5 GB ~/Desktop
...
🔁 重复文件：
- screenshot.png（3 个副本） 每个 15 MB
- document_v1.docx（2 个副本） 每个 8 MB
安全级别：🟡 需要用户判断
目标：
node_modules、npm 缓存__pycache__、venv.git 文件夹分析脚本：
scripts/analyze_dev_env.py
示例发现：
🐳 Docker 资源：
- 未使用的镜像： 12 GB
- 已停止的容器： 2 GB
- 构建缓存： 8 GB
- 孤立的卷： 3 GB
总潜在： 25 GB
📦 包管理器：
- Homebrew 缓存： 5 GB
- npm 缓存： 3 GB
- pip 缓存： 1 GB
总潜在： 9 GB
🗂️ 旧项目：
- archived-project-2022/.git 500 MB
- old-prototype/.git 300 MB
清理命令（需要确认）：
# Homebrew 清理（安全）
brew cleanup -s
# npm _npx 仅限（安全 - 临时包）
rm -rf ~/.npm/_npx
# pip 缓存（谨慎使用）
pip cache purge
Docker 清理 - 需要特殊处理：
⚠️ 绝不使用这些命令：
# ❌ 危险 - 无确认删除所有卷
docker volume prune -f
docker system prune -a --volumes
✅ 正确方法 - 逐卷确认：
# 1. 列出所有卷
docker volume ls
# 2. 确定每个卷属于哪个项目
docker volume inspect <volume_name>
# 3. 要求用户确认要删除的每个项目
# 示例："您想删除 'ragflow' 项目的所有卷吗？"
# 4. 仅在确认后删除特定卷
docker volume rm ragflow_mysql_data ragflow_redis_data
安全级别：🟢 Homebrew/npm 清理，🔴 Docker 卷需要按项目确认
Mole（https://github.com/tw93/Mole）是一个用于全面 macOS 清理的**命令行界面（CLI）**工具。它为缓存、日志、开发工具等提供基于交互式终端的分析和清理。
关键要求：
tmux。mo --help 是安全的。不要在其他命令后附加 --help。安装检查和升级：
# 检查是否安装并获取版本
which mo && mo --version
# 如果未安装
brew install tw93/tap/mole
# 检查更新
brew info tw93/tap/mole | head -5
# 如果需要则升级
brew upgrade tw93/tap/mole
使用 tmux 与 Mole 一起使用（Claude Code 必需）：
# 创建 tmux 会话以获得 TTY 环境
tmux new-session -d -s mole -x 120 -y 40
# 运行分析（安全，只读）
tmux send-keys -t mole 'mo analyze' Enter
# 等待扫描（耐心 - 大目录可能需要 5-10 分钟）
sleep 60
# 捕获结果
tmux capture-pane -t mole -p
# 完成后清理
tmux kill-session -t mole
可用命令（来自 mo --help）：
| 命令 | 安全性 | 说明 |
|---|---|---|
mo --help | ✅ 安全 | 查看所有命令（唯一安全的帮助） |
mo analyze | ✅ 安全 | 磁盘使用浏览器（只读） |
mo status | ✅ 安全 | 系统健康监控 |
mo clean --dry-run | ✅ 安全 | 预览清理（无删除） |
mo clean | ⚠️ 危险 | 实际删除文件 |
mo purge | ⚠️ 危险 | 删除项目工件 |
mo uninstall | ⚠️ 危险 | 删除应用程序 |
参考指南：
详见 references/mole_integration.md 获取详细的 tmux 工作流程和故障排除。
关键：为了全面分析，您必须执行多层探索，而不仅仅是顶层扫描。本节记录了导航 Mole TUI 的经过验证的工作流程。
# 创建会话
tmux new-session -d -s mole -x 120 -y 40
# 开始分析
tmux send-keys -t mole 'mo analyze' Enter
# 等待初始扫描
sleep 8 && tmux capture-pane -t mole -p
# 导航键（通过 tmux 发送）
tmux send-keys -t mole Enter # 进入/展开选定目录
tmux send-keys -t mole Left # 返回父目录
tmux send-keys -t mole Down # 移动到下一项
tmux send-keys -t mole Up # 移动到上一项
tmux send-keys -t mole 'q' # 退出 TUI
# 捕获当前视图
tmux capture-pane -t mole -p
步骤 1：顶层概览
# 启动 mo analyze，等待初始菜单
tmux send-keys -t mole 'mo analyze' Enter
sleep 8 && tmux capture-pane -t mole -p
# 示例输出：
# 1. 主目录 289.4 GB (58.5%)
# 2. 应用库 145.2 GB (29.4%)
# 3. 应用程序 49.5 GB (10.0%)
# 4. 系统库 10.3 GB (2.1%)
步骤 2：进入最大目录（主目录）
tmux send-keys -t mole Enter
sleep 10 && tmux capture-pane -t mole -p
# 示例输出：
# 1. 库 144.4 GB (49.9%)
# 2. 工作区 52.0 GB (18.0%)
# 3. .cache 19.3 GB (6.7%)
# 4. 应用程序 17.0 GB (5.9%)
# ...
步骤 3：深入特定目录
# 进入 .cache（第 3 项：Down Down Enter）
tmux send-keys -t mole Down Down Enter
sleep 5 && tmux capture-pane -t mole -p
# 示例输出：
# 1. uv 10.3 GB (55.6%)
# 2. modelscope 5.5 GB (29.5%)
# 3. huggingface 887.8 MB (4.7%)
步骤 4：返回并探索另一个分支
# 返回父目录
tmux send-keys -t mole Left
sleep 2
# 导航到不同目录
tmux send-keys -t mole Down Down Down Down Enter # 进入 .npm
sleep 5 && tmux capture-pane -t mole -p
步骤 5：深入库
# 返回主目录，然后进入库
tmux send-keys -t mole Left
tmux send-keys -t mole Up Up Up Up Up Up Enter # 进入库
sleep 10 && tmux capture-pane -t mole -p
# 示例输出：
# 1. 应用支持 37.1 GB
# 2. 容器 35.4 GB
# 3. 开发者 17.8 GB ← Xcode 在这里
# 4. 缓存 8.2 GB
为了全面分析，请遵循此探索树：
mo analyze
├── 主目录（进入）
│ ├── 库（进入）
│ │ ├── 开发者（进入） → Xcode/DerivedData、iOS DeviceSupport
│ │ ├── 缓存（进入） → Playwright、JetBrains 等
│ │ └── 应用支持（进入） → 应用数据
│ ├── .cache（进入） → uv、modelscope、huggingface
│ ├── .npm（进入） → _cacache、_npx
│ ├── 下载（进入） → 待审查的大文件
│ ├── .Trash（进入） → 确认废纸篓内容
│ └── miniconda3/其他开发工具（进入） → 检查最后使用时间
├── 应用库 → 通常与 ~/Library 重叠
└── 应用程序 → 已安装的应用
| 目录 | 扫描时间 | 说明 |
|---|---|---|
| 顶层菜单 | 5-8 秒 | 快速 |
| 主目录 | 5-10 分钟 | 大型，请耐心 |
| ~/Library | 3-5 分钟 | 许多小文件 |
| 子目录 | 2-30 秒 | 根据大小变化 |
# 1. 创建会话
tmux new-session -d -s mole -x 120 -y 40
# 2. 开始分析并获取概览
tmux send-keys -t mole 'mo analyze' Enter
sleep 8 && tmux capture-pane -t mole -p
# 3. 进入主目录
tmux send-keys -t mole Enter
sleep 10 && tmux capture-pane -t mole -p
# 4. 进入 .cache 查看开发缓存
tmux send-keys -t mole Down Down Enter
sleep 5 && tmux capture-pane -t mole -p
# 5. 返回主目录，然后到 .npm
tmux send-keys -t mole Left
sleep 2
tmux send-keys -t mole Down Down Down Down Enter
sleep 5 && tmux capture-pane -t mole -p
# 6. 返回主目录，进入库
tmux send-keys -t mole Left
sleep 2
tmux send-keys -t mole Up Up Up Up Up Up Enter
sleep 10 && tmux capture-pane -t mole -p
# 7. 进入开发者查看 Xcode
tmux send-keys -t mole Down Down Down Enter
sleep 5 && tmux capture-pane -t mole -p
# 8. 进入 Xcode
tmux send-keys -t mole Enter
sleep 5 && tmux capture-pane -t mole -p
# 9. 进入 DerivedData 查看项目
tmux send-keys -t mole Enter
sleep 5 && tmux capture-pane -t mole -p
# 10. 清理
tmux kill-session -t mole
经过多层探索后，您将发现：
关键：以下项目通常建议清理，但在大多数情况下不应删除。它们提供的显著价值超过了它们占用的空间。
| 项目 | 大小 | 为什么不删除 | 删除的实际影响 |
|---|---|---|---|
| Xcode DerivedData | 10+ GB | 构建缓存每次完整重新构建节省 10-30 分钟 | 下次构建需要额外 10-30 分钟 |
| npm _cacache | 5+ GB | 下载的包在本地缓存 | npm install 重新下载所有内容（中国 30分钟-2小时） |
| ~/.cache/uv | 10+ GB | Python 包缓存 | 每个 Python 项目从 PyPI 重新安装依赖 |
| Playwright 浏览器 | 3-4 GB | 自动化测试的浏览器二进制文件 | 每次重新下载 2GB+（30分钟-1小时） |
| iOS DeviceSupport | 2-3 GB | 设备调试所需 | 连接设备时从 Apple 重新下载 |
| Docker 已停止的容器 | <500 MB | 可能随时使用 docker start 重新启动 | 丢失容器状态，需要重新创建 |
| ~/.cache/huggingface | 变化 | AI 模型缓存 | 重新下载大模型（数小时） |
| ~/.cache/modelscope | 变化 | AI 模型缓存（中国） | 同上 |
| JetBrains 缓存 | 1+ GB | IDE 索引和缓存 | IDE 需要 5-10 分钟重新索引 |
虚荣陷阱：显示"清理了 50GB！"感觉很爽，但：
正确心态："我发现了 50GB 缓存。以下是为什么其中大部分实际上有价值应该保留..."
| 项目 | 为什么安全 | 影响 |
|---|---|---|
| 废纸篓 | 用户已删除这些文件 | 无 - 用户的决定 |
| Homebrew 旧版本 | 被新版本替换 | 罕见：无法回滚到旧版本 |
| npm _npx | 临时 npx 执行 | 轻微：npx 下次使用时重新下载 |
| 孤立应用残留 | 应用已卸载 | 无 - 应用不存在 |
| 特定未使用的 Docker 卷 | 项目确认已放弃 | 无 - 如果真的已放弃 |
每个清理报告必须遵循此格式并包含影响分析：
## 磁盘分析报告
### 分类图例
| 符号 | 含义 |
|--------|---------|
| 🟢 | **绝对安全** - 无负面影响，真正未使用 |
| 🟡 | **需要权衡** - 有用缓存，删除有成本 |
| 🔴 | **不要删除** - 包含有价值的数据或正在使用 |
### 发现
| 项目 | 大小 | 分类 | 是什么 | 删除后影响 |
|------|------|----------------|------------|-------------------|
| 废纸篓 | 643 MB | 🟢 | 您删除的文件 | 无 |
| npm _npx | 2.1 GB | 🟢 | 临时 npx 包 | 轻微重新下载 |
| npm _cacache | 5 GB | 🟡 | 包缓存 | 30分钟-2小时重新下载 |
| DerivedData | 10 GB | 🟡 | Xcode 构建缓存 | 10-30分钟重新构建 |
| Docker 卷 | 11 GB | 🔴 | 项目数据库 | **数据丢失** |
### 建议
仅标记为 🟢 的项目建议清理。
标记为 🟡 的项目需要您根据使用模式进行判断。
标记为 🔴 的项目需要每项明确确认。
经过多层探索后，使用此经过验证的模板呈现发现：
## 📊 磁盘空间深度分析报告
**分析日期**：YYYY-MM-DD
**使用工具**：Mole CLI + 多层目录探索
**分析原则**：安全第一，价值优于虚荣
---
### 总览
| 区域 | 总占用 | 关键发现 |
|------|--------|----------|
| **主目录** | XXX GB | 库占一半(XXX GB) |
| **应用库** | XXX GB | 与主目录/库重叠统计 |
| **应用程序** | XXX GB | 应用本体 |
---
### 🟢 绝对安全可删除（约 X.X GB）
| 项目 | 大小 | 位置 | 删除后影响 | 清理命令 |
|------|------|------|-----------|---------|
| **废纸篓** | XXX MB | ~/.Trash | 无 - 您已决定删除的文件 | 清空废纸篓 |
| **npm _npx** | X.X GB | ~/.npm/_npx | 下次 npx 命令重新下载 | `rm -rf ~/.npm/_npx` |
| **Homebrew 旧版本** | XX MB | /opt/homebrew | 无 - 已被新版本替代 | `brew cleanup --prune=0` |
**废纸篓内容预览**：
- [列出主要文件]
---
### 🟡 需要您确认的项目
#### 1. [项目名] (X.X GB) - [状态描述]
| 子目录 | 大小 | 最后使用 |
|--------|------|----------|
| [子目录1] | X.X GB | >X个月 |
| [子目录2] | X.X GB | >X个月 |
**问题**：[需要用户回答的问题]
---
#### 2. Downloads 中的旧文件 (X.X GB)
| 文件/目录 | 大小 | 年龄 | 建议 |
|-----------|------|------|------|
| [文件1] | X.X GB | - | [建议] |
| [文件2] | XXX MB | >X个月 | [建议] |
**建议**：手动检查 Downloads，删除已不需要的文件。
---
#### 3. 停用的 Docker 项目 Volumes
| 项目前缀 | 可能包含的数据 | 需要您确认 |
|---------|--------------|-----------|
| `project1_*` | MySQL、Redis | 还在用吗？ |
| `project2_*` | Postgres | 还在用吗？ |
**注意**：我不会使用 `docker volume prune -f`，只会在您确认后删除特定项目的 volumes。
---
### 🔴 不建议删除的项目（有价值的缓存）
| 项目 | 大小 | 为什么要保留 |
|------|------|-------------|
| **Xcode DerivedData** | XX GB | [项目名]的编译缓存，删除后下次构建需要X分钟 |
| **npm _cacache** | X.X GB | 所有下载过的 npm 包，删除后需要重新下载 |
| **~/.cache/uv** | XX GB | Python 包缓存，重新下载在中国网络下很慢 |
| [其他有价值的缓存] | X.X GB | [保留原因] |
---
### 📋 其他发现
| 项目 | 大小 | 说明 |
|------|------|------|
| **OrbStack/Docker** | XX GB | 正常的 VM/容器占用 |
| [其他发现] | X.X GB | [说明] |
---
### 推荐操作
**立即可执行**（无需确认）：
```bash
# 1. 清空废纸篓 (XXX MB)
# 手动：Finder → 清空废纸篓
# 2. npm _npx (X.X GB)
rm -rf ~/.npm/_npx
# 3. Homebrew 旧版本 (XX MB)
brew cleanup --prune=0
预计释放：~X.X GB
需要您确认后执行：
### 报告质量检查清单
在呈现报告之前，验证：
- [ ] 每个项目都有"删除后影响"说明
- [ ] 🟢 项目真正安全（废纸篓、_npx、旧版本）
- [ ] 🟡 项目需要用户决定（年龄信息、使用模式）
- [ ] 🔴 项目解释为什么要保留
- [ ] Docker 卷按项目列出，而不是全面清理
- [ ] 考虑网络环境（中国 = 重新下载慢）
- [ ] 没有建议删除有用的缓存只是为了夸大数字
- [ ] 清晰的操作项和确切的命令
## 第四步：呈现建议
将发现格式化为具有风险级别的可执行建议：
```markdown
# macOS 清理建议
## 摘要
总可恢复空间：~XX GB
当前使用率：XX%
## 推荐操作
### 🟢 可以安全执行（低风险）
这些可以安全删除，将根据需要重新生成：
1. **清空废纸篓**（~12 GB）
- 位置：~/.Trash
- 命令：`rm -rf ~/.Trash/*`
2. **清除系统缓存**（~45 GB）
- 位置：~/Library/Caches
- 命令：`rm -rf ~/Library/Caches/*`
- 注意：应用下次启动可能会稍微慢一些
3. **删除 Homebrew 缓存**（~5 GB）
- 命令：`brew cleanup -s`
### 🟡 建议审查（中等风险）
删除前审查这些项目：
1. **大文件下载**（~38 GB）
- 位置：~/Downloads
- 操作：手动审查并删除不需要的文件
- 文件：[列出前 10 个最大文件]
2. **应用残留**（~8 GB）
- 应用：[列出检测到的已卸载应用]
- 位置：[列出路径]
- 操作：在删除数据前确认应用真的已卸载
### 🔴 除非确定否则保留（高风险）
仅在您知道自己在做什么时才删除：
1. **Docker 卷**（~3 GB）
- 可能包含重要数据
- 使用以下命令审查：`docker volume ls`
2. **Time Machine 本地快照**（~XX GB）
- 自动备份，需要空间时将删除
- 检查命令：`tmutil listlocalsnapshots /`
关键：没有明确的用户确认绝不执行删除操作。
交互式确认流程：
# 来自 scripts/safe_delete.py 的示例
def confirm_delete(path: str, size: str, description: str) -> bool:
"""
请求用户确认删除。
参数：
path：文件/目录路径
size：人类可读的大小
description：此文件/目录是什么
返回：
如果用户确认则为 True，否则为 False
"""
print(f"\n🗑️ 确认删除")
print(f"━━━━━━━━━━━━━━━━━━")
print(f"路径： {path}")
print(f"大小： {size}")
print(f"说明：{description}")
response = input("\n删除此项目？[y/N]：").strip().lower()
return response == 'y'
对于批量操作：
def batch_confirm(items: list) -> list:
"""
显示所有项目，请求批量确认。
返回用户批准的项目列表。
"""
print("\n📋 要删除的项目：")
print("━━━━━━━━━━━━━━━━━━")
for i, item in enumerate(items, 1):
print(f"{i}. {item['path']} ({item['size']})")
print("\n选项：")
print(" 'all' - 删除所有项目")
print(" '1,3,5' - 按编号删除特定项目")
print(" 'none' - 取消")
response = input("\n您的选择：").strip().lower()
if response == 'none':
return []
elif response == 'all':
return items
else:
# 解析数字
indices = [int(x.strip()) - 1 for x in response.split(',')]
return [items[i] for i in indices if 0 <= i < len(items)]
清理后，验证结果并报告：
# 比较之前/之后
df -h /
# 计算恢复的空间
#（由 scripts/cleanup_report.py 处理）
报告格式：
✅ 清理完成！
之前：已使用 450 GB（90%）
之后： 已使用 385 GB（77%）
━━━━━━━━━━━━━━━━━━━━━━━━
已恢复：65 GB
细分：
- 系统缓存： 45 GB
- 下载： 12 GB
- Homebrew 缓存： 5 GB
- 应用残留： 3 GB
⚠️ 注意：
- 某些应用首次启动可能需要更长时间
- 除非您有 Time Machine 备份，否则无法恢复已删除的项目
- 建议每月运行此清理一次
💡 维护提示：
- 设置自动 Homebrew 清理：每周 `brew cleanup`
- 每月审查 Downloads 文件夹
- 在 Finder 偏好设置中启用"自动清空废纸篓"
没有明确的用户指示绝不删除这些：
~/Documents、~/Desktop、~/Pictures 内容这些操作需要提升的权限。要求用户手动运行命令：
/Library/Caches（系统范围）/var/log（系统日志）/private/var/folders（系统临时）示例提示：
⚠️ 此操作需要管理员权限。
请手动运行此命令：
sudo rm -rf /Library/Caches/*
⚠️ 您将被要求输入密码。
在执行任何 >10GB 的清理之前，建议：
💡 安全提示：
在清理 XX GB 之前，考虑创建 Time Machine 备份。
快速备份检查：
tmutil latestbackup
如果没有最近备份，运行：
tmutil startbackup
macOS 可能由于 SIP（系统完整性保护）而阻止删除某些系统文件。
解决方案：不要强制操作。这些保护是为了安全而存在的。
罕见但可能。解决方案：重新启动应用，它将重新生成必要的缓存。
预防：清理前始终列出 Docker 卷：
docker volume ls
docker volume inspect <volume_name>
analyze_caches.py - 扫描和分类缓存目录find_app_remnants.py - 检测孤立的应用数据analyze_large_files.py - 使用智能过滤查找大文件analyze_dev_env.py - 扫描开发环境资源safe_delete.py - 带确认的交互式删除cleanup_report.py - 生成之前/之后报告cleanup_targets.md - 每个清理目标的详细说明mole_integration.md - 如何与此技能一起使用 Molesafety_rules.md - 绝不删除的内容的综合列表用户请求："我的 Mac 空间不足，你能帮助吗？"
工作流程：
rm -rf ~/Library/Caches/*用户请求："我是开发人员，我的磁盘满了"
工作流程：
scripts/analyze_dev_env.py用户请求："什么占用了这么多空间？"
工作流程：
scripts/analyze_large_files.py --threshold 100MB在这些情况下，解释局限性并建议替代方案。