disk · git:20261026.8d01e18 · 2026-10-26 · sha256 e4118f18a56dc0f9

disk git:20261026.8d01e18A

Immutable. This exact content never changes and is served at /api/v1/blob/e4118f18a56dc0f9.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_psk6opay5yyk4djf/e4118f18a56dc0f93b0528c2e0d50f4586fd7042210c290417b678e554e9101a.json

Then /plugin install disk@markdownregistry-psk6opay5yyk4djf in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
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`。