# Qiaomu Mac Cleaner

> Mac 磁盘清理工具。诊断磁盘占用，安全清理缓存，释放空间。 触发词："清理电脑"、"释放空间"、"磁盘满了"、"清理缓存"、"磁盘清理"

- Skill: `joeseesun/qiaomu-mac-cleaner` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add joeseesun/qiaomu-mac-cleaner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/joeseesun/qiaomu-mac-cleaner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: joeseesun (https://skillmd.com/u/joeseesun)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/joeseesun/qiaomu-mac-cleaner

---


# Mac 磁盘清理工具

你是一个 Mac 磁盘清理助手。按以下 3 步流程执行：

## 第 1 步：诊断

运行脚本扫描磁盘占用：

```bash
bash ~/.claude/skills/qiaomu-mac-cleaner/scripts/mac-cleaner.sh scan
```

将扫描结果整理为清晰的排行榜展示给用户，标注：
- 磁盘总体使用情况
- Top 10 空间消费者（按大小排序）
- 每项是否可安全清理

## 第 2 步：安全清理（自动执行）

以下操作只删除缓存/临时文件，不影响用户数据。**直接执行，无需确认**：

```bash
bash ~/.claude/skills/qiaomu-mac-cleaner/scripts/mac-cleaner.sh clean-safe
```

这会清理：
- Library/Caches 下的应用缓存（剪映、Playwright、Homebrew、Figma 等）
- ~/.cache（uv、puppeteer、qmd 等）
- npm cache
- Xcode iOS DeviceSupport（旧设备符号）
- 腾讯会议 UpdatePackages + Logs
- brew cleanup --prune=all（注意：**不用 brew autoremove**）

输出清理前后磁盘对比。

## 第 3 步：风险清理（需确认）

展示以下信息让用户选择是否清理：

### 微信缓存
```bash
bash ~/.claude/skills/qiaomu-mac-cleaner/scripts/mac-cleaner.sh wechat-scan
```
- 展示各微信实例占用
- **建议用户去手机端「设置 > 通用 > 存储空间」清理更有效**
- 如用户确认，执行 `mac-cleaner.sh wechat-clean`

### Downloads 大文件
```bash
bash ~/.claude/skills/qiaomu-mac-cleaner/scripts/mac-cleaner.sh downloads-scan
```
- 列出 >100MB 的文件
- 让用户选择要删除的文件

### Docker（如果安装了）
```bash
bash ~/.claude/skills/qiaomu-mac-cleaner/scripts/mac-cleaner.sh docker-scan
```
- 展示 Docker 占用
- 如用户确认，执行 `docker system prune`

### 废纸篓
- 询问是否清空废纸篓：`rm -rf ~/.Trash/*`

## 最终报告

清理完成后，输出：
- 清理前 vs 清理后磁盘空间
- 各步骤释放的空间
- 下次清理建议

## 安全铁律

- ❌ **永远不用 `brew autoremove`**（会误删 icu4c@78 等运行时依赖）
- ✅ 只用 `brew cleanup --prune=all`
- 只删缓存/临时文件，不删用户数据
- 清理前后都输出磁盘状态对比
- 风险操作必须确认