---
name: disk
description: 磁盘快照（关键词 · 跨平台）：采集 HOME 与可配置路径占用 → .growing/disk-snapshots/，并与上次对比。
disable-model-invocation: true
---

# disk · 磁盘快照

**工具技能**（无 slash · 非 plan/run 主路径）。**用这个**：占用快照与对比。**不是那个**：业务代码清理重构 → **refactor**；系统清理流程 → **maintain** skill。

结构化采集磁盘占用，写入 **`.growing/disk-snapshots/`**（本地、**不提交 git**），支持对比两次快照的变动。

## 何时进入

- 用户说「磁盘快照」「空间占用」「哪个目录变大了」「disk snapshot」
- `/master` 或关键词命中

## 流程（Agent 一次跑完）

### 1. 采集快照

```bash
python3 .cursor/skills/disk/scripts/collect-disk.py snapshot
```

可选：

- `--home ~` — HOME 目录（默认 `~`）
- `--project-dir .` — 相对路径类条目（`./build` 等）的基准目录
- `--snapshot-dir .growing/disk-snapshots`（默认已是）
- `--config .growing/disk-paths.json` — 自定义采集表（见模板 `templates/growing/disk-paths.example.json`）

### 2. 对比变动（需 ≥2 份快照）

```bash
python3 .cursor/skills/disk/scripts/collect-disk.py diff
```

输出 `.growing/disk-snapshots/diff-latest.md`，并打印 Markdown 对比表。

### 3. 查看

```bash
python3 .cursor/skills/disk/scripts/collect-disk.py list
python3 .cursor/skills/disk/scripts/collect-disk.py report
```

### 4. 确认

```bash
git status   # .growing/ 不应出现在待提交列表
```

**禁止** `git add .growing/disk-snapshots/`。

## 快照结构

每次快照为 JSON；默认路径见 `skills/disk/config/default-paths.json`：

| 分组 | 示例 key |
|------|----------|
| 根分区 | `disk.root` |
| Home | `home.cache` · `home.downloads` · `home.config` … |
| IDE | `ide.cursor` · `ide.cursor_state` · `ide.vscode` |
| 当前项目 | `pkg.build` · `pkg.node_modules` · `pkg.target`（相对 `--project-dir`） |

对比时按 **变动绝对值** 排序。可在 `.growing/disk-paths.json` 增删路径，**勿写入个人信息**。

## 与 maintain 的分工

| 工具 | 职责 |
|------|------|
| **maintain** | 诊断 + 安全清理 |
| **disk** | 只读快照 + diff |

建议：清理前/后各 `snapshot`，中间 `--clean`，最后 `diff`。
