Linux Storage Analyzer

Claude Code Skill — Ubuntu/Debian/Linux 只读存储分析与保守清理助手

安全第一：默认只读扫描 → 三色分级 → 二次确认 → 保守清理。不删密钥、不碰 Docker volumes、不动浏览器 Profile。

English: README_en.md

---

功能

• 只读审计：一键扫描系统存储，生成 Markdown 报告
• 三色分级：绿灯(安全清理) / 黄灯(人工判断) / 红灯(绝不触碰)
• 保守清理：APT 缓存、journal 日志、Docker safe prune
• 可选清理：Docker 安全清理、Snap 旧版本清理

支持系统

Ubuntu 24.04/26.04、Lubuntu、Debian、Mint、MX Linux 等 apt 系发行版。

快速安装

方式一：手动安装（推荐）

git clone https://github.com/Igzela/linux-storage-analyzer.git
cp -r linux-storage-analyzer ~/.claude/skills/

方式二：一行命令

git clone https://github.com/Igzela/linux-storage-analyzer.git ~/.claude/skills/linux-storage-analyzer

安装后 Claude Code 会自动发现 skill。无需重启，直接对话即可触发。

使用方法

Step 1：只读审计

在 Claude Code 中说：

"帮我看看 Linux 存储" / "磁盘满了" / "清理一下磁盘" / "哪些目录占空间"

或手动运行：

cd ~/.claude/skills/linux-storage-analyzer
bash scripts/audit.sh

生成报告到 /tmp/linux-storage-audit-YYYYMMDD-HHMMSS.md。

Step 2：三色分级

Agent 自动读取报告，按以下规则分类：

级别	类别	示例	操作
🟢 绿灯	可再生缓存	APT 缓存、npm/pip/uv 缓存、journal 旧日志、Docker 构建缓存	可安全清理
🟡 黄灯	用户数据	Downloads、大模型文件、项目 node_modules、ISO 镜像	需人工判断
🔴 红灯	敏感/系统	~/.ssh、~/.gnupg、浏览器 Profile、Docker volumes、EFI	绝不自动删除

Step 3：保守清理

Agent 展示清理计划并等待确认后执行：

# dry-run（预览将执行的操作）
bash scripts/safe-clean.sh

# 确认后执行（仅 APT + journal）
CONFIRM_LINUX_STORAGE_CLEAN=1 bash scripts/safe-clean.sh --apply

Step 4：Docker 安全清理（可选）

# 展示 Docker 占用
docker system df

# 安全清理（悬空镜像、停止容器、构建缓存、未用网络）
CONFIRM_LINUX_STORAGE_CLEAN=1 bash scripts/safe-clean.sh --apply --docker-safe

注意：脚本永远不执行 docker volume prune。除非用户明确批准。

Step 5：Snap 旧版本清理（可选）

CONFIRM_LINUX_STORAGE_CLEAN=1 bash scripts/safe-clean.sh --apply --snap-disabled

安全铁律

1. 默认全程只读。先审计，不清理。
2. 不删除：用户项目、Git 仓库、~/.ssh、~/.gnupg、浏览器 Profile、密码库、桌面/下载/文档里的不确定文件。
3. 不删除 Docker volumes，除非用户明确点名批准。
4. 不动 /boot/efi、分区表、挂载点、系统启动文件。
5. 不使用宽泛 rm -rf。禁止对 /、/home、/var、/usr、/opt、/mnt、/media 做递归删除。
6. 任何写操作前，先总结"将执行什么、预计释放多少、风险是什么"，等待用户确认。
7. Docker 清理只允许：停止容器、悬空镜像、构建缓存、未用网络。禁止 --volumes。

目录结构

linux-storage-analyzer/
├── README.md              # 本文档
├── SKILL.md               # Claude Code skill 定义（Agent 读取）
├── LICENSE                # MIT License
├── scripts/
│   ├── audit.sh           # 只读审计脚本
│   └── safe-clean.sh      # 保守清理脚本（需确认）
└── references/
    └── linux.md           # 分级规则参考

脚本参数

audit.sh

bash scripts/audit.sh                          # 默认输出到 /tmp/linux-storage-audit-*.md
bash scripts/audit.sh /path/to/report.md       # 指定输出路径

safe-clean.sh

bash scripts/safe-clean.sh                                  # dry-run
CONFIRM_LINUX_STORAGE_CLEAN=1 bash scripts/safe-clean.sh --apply             # APT + journal
CONFIRM_LINUX_STORAGE_CLEAN=1 bash scripts/safe-clean.sh --apply --docker-safe  # + Docker safe prune
CONFIRM_LINUX_STORAGE_CLEAN=1 bash scripts/safe-clean.sh --apply --snap-disabled # + Snap 旧版本

典型输出示例

审计后 Agent 会这样回复：

结论：你的根分区已用 55%，主要占用来自 .cache、Projects、.lmstudio。
保守清理预计能释放约 27 GB。

绿灯：APT 缓存 (725M)、journal 日志 (609M)、uv 缓存 (16G)、npm 缓存 (2.8G)、Docker 构建缓存 (6.1G)。
黄灯：LM Studio 模型 (29G)、ventoy ISO (16G)、项目 target (54G)，需要你判断。
红灯：EFI、SSH/GPG、Docker volumes、浏览器 Profile，不动。

我建议先执行：apt + journal + 开发缓存清理；Docker 只做 safe prune，不碰 volumes。

License

MIT License. 自由使用、修改、分发。