# clean-c-drive

Adopt this skill: https://proskills.md/skills/other/iziqing-disk-cleaner

Page: https://proskills.md/skills/other/iziqing-disk-cleaner
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 6631
upstream: https://github.com/iziqing/-disk-cleaner/blob/HEAD/SKILL.md

````text
---
name: clean-c-drive
description: 小白安全清理C盘（Windows）。当用户想清理C盘、磁盘空间不足、系统盘快满了、想安全释放空间时使用。WizTree扫描→模式库+知识库两层分析→清理方案经用户批复→备份后执行→观察期收尾。安全第一，不确定的一律不动。
---

# /clean-c-drive Skill

利用 WizTree 的快速扫描能力和 AI 的智能分析能力，安全清理 C 盘垃圾文件。

**安全铁律（任何情况下不可违背）：**

1. 不确定用途的文件一律不动；用户说"不认识"的软件 → 列入红线并向用户询问。
2. **任何权限模式下，清理方案都必须经用户确认后才执行**——管理员权限只是免去手动跑脚本，不免审查（模式库认不出"用户常用但长得像垃圾"的东西）。
3. 清理前必须备份（backup.py），备份失败则中止清理。
4. 分析与出方案时必须对照 `references/knowledge.md`（安全红线清单 / 分层惯犯表 / 执行守则）。

## 工作流程

### 阶段 1: 检查权限和扫描数据

1. **检查管理员权限**：
   ```bash
   powershell -Command "([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)"
   ```

2. **如果有管理员权限（返回 True）**：
   - 检查技能目录 `data/` 下是否有 24 小时内的扫描文件
   - 没有则自动扫描（WizTree 路径自动探测：环境变量 `WIZTREE_PATH` → 技能目录 `WizTree\` → Program Files → PATH）：
     ```bash
     python "<技能目录>/scan.py" C:
     ```

3. **如果没有管理员权限（返回 False）**：
   - `data/` 有现成数据就用；没有则提示用户：
     ```
     当前没有管理员权限，无法自动扫描。
     请选择：
     1. 以管理员权限重新启动 Claude Code（推荐，扫描/执行全自动）
     2. 手动以管理员身份运行 WizTree，导出数据到 data 目录后再次运行此命令
        （导出时"文件"和"文件夹"都要勾选；CSV 别存C盘）
     ```

### 阶段 2: 分析扫描数据

```bash
python "<技能目录>/analyze.py" "<csv_file>" --min-size 50
```

**两层分析，缺一不可：**
- **模式库快筛**（analyze.py 自动完成）：识别已知缓存/垃圾目录，按 高🔴/中🟡/低🟢 分级，红线目录已自动排除；
- **知识库逐案研判**（AI 来做）：模式库实测只能覆盖约 1/3 的可清理空间，剩下的大头——单个巨型转储、Chrome 端侧AI模型、软件多重安装、废弃应用数据、DISM 等系统官方机制可回收的空间——需要对照 `references/knowledge.md` 对目录/大文件排行逐案判断。
- 预估要保守：WinSxS 与 System32 之间大量硬链接，目录合计大于实际占用是正常现象。

### 阶段 3: 生成清理方案（必须等用户批复）

向用户展示：
1. **磁盘概况**：总容量、已用、可用
2. **可清理项分级列表**：每项写清 路径 / 大小 / 是什么 / 删了会怎样 / 清理方式，**逐条编号**方便逐条批复
3. **红线清单**：明确列出本次绝不碰的内容
4. 询问用户选择清理级别或逐条批复。**未批复 = 不执行；沉默 ≠ 同意。**

### 阶段 4: 备份待清理目录

**在执行任何清理操作之前，必须先备份！**

1. 检查备份驱动器（自动选非C盘剩余空间最大的，最少需要 5GB）：
   ```bash
   python "<技能目录>/backup.py" drive
   ```
2. 创建备份（小于1GB直接复制，大于等于1GB压缩；生成 manifest.json）：
   ```bash
   python "<技能目录>/backup.py" create --paths "路径1" "路径2" --priority high
   ```
   注意：robocopy 备份会保留隐藏/系统属性，核对备份目录时要用 `Get-ChildItem -Force`。
3. 备份失败（空间不足等）→ **中止清理**，提示用户处理。

### 阶段 5: 执行清理

- **有管理员权限**：按批复方案执行，显示进度和逐项释放量
- **无管理员权限**：生成 `clean_<level>.ps1` 到技能目录，提示用户以管理员身份运行
- 执行前检查进程（生成的脚本已内置警告）：浏览器 / VS Code / java（Gradle 守护进程）运行中会导致对应缓存清理不完整
- 生成的脚本已自动处理：清空目录时保留目录本身、排除 `claude*`（Claude Code 会话自身临时文件）、支持单文件目标

### 阶段 6: 验证和确认

清理完成后，询问用户系统是否正常：

```
清理已完成！请检查系统是否正常运行。
1. 系统正常 → 建议保留备份观察 7 天再删（有些问题当场看不出来，比如某应用下次启动才报错）
2. 出现问题 → 一键回滚，恢复备份
3. 稍后决定 → 保留备份，等待验证
```

- 回滚：`python "<技能目录>/backup.py" restore --id <backup_id>`
- 观察期满确认删除：`python "<技能目录>/backup.py" delete --id <backup_id>`

### 阶段 7: 清理临时文件

清理任务完成后，询问用户是否删除扫描数据和生成的清理脚本：
```bash
python "<技能目录>/scan.py" --cleanup
```
将清理 `data/*.csv` 和 `clean_*.ps1`。

## 核心脚本

| 脚本 | 职责 | 常用命令 |
|---|---|---|
| `scan.py` | WizTree 自动扫描（路径自动探测；默认导出文件行） | `python scan.py C:`、`--latest`、`--cleanup`、`--folders-only` |
| `analyze.py` | 流式解析 CSV（兼容 GUI/CLI 导出与中英文列名）、模式库分级、生成清理脚本 | `python analyze.py "<csv>" --min-size 50`、`--json`、`--output clean.ps1 --priority high` |
| `backup.py` | 备份/回滚（manifest.json 清单化） | `drive` / `create` / `list` / `restore` / `delete` |

## 可清理目录与安全红线

完整定义见两处（修改时保持同步）：
- `analyze.py` 的 `CLEANABLE_PATTERNS`（模式库）与 `EXCLUDE_PATTERNS`（安全红线）
- `references/knowledge.md`（完整知识库：红线表 / Tier分层惯犯表 / 惯犯定位正则 / 执行守则）

## WizTree 命令行参考

```bash
WizTree64.exe <drive> /export="<path>" /admin=1 /exportfolders=1 /exportfiles=1 /sortby=2 /exportdrivecapacity=1 /exportmaxdepth=0
```

**为什么默认导出文件行（/exportfiles=1）：** 实测最大的清理收益常来自单个巨型文件——4.7GB 内核转储、4GB Chrome 端侧AI模型、GB 级半成品下载——只导出文件夹时它们全部隐身。CSV 会变大（可能几百MB），analyze.py 流式解析不受影响；确需小体积用 `--folders-only`。
````

## File: README.md
upstream: https://github.com/iziqing/-disk-cleaner/blob/HEAD/README.md

````text
# Claude 磁盘清理器

[![Version](https://img.shields.io/badge/version-v1.1.0-blue.svg)](./CHANGELOG.md)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)

> ⚠️ **免责声明（请先读我）**：本技能与文档由 AI（Claude Fable 5）自行编写完成，项目实控人未做人工审查（我也不一定全部看得懂）。请使用者仔细阅读本文档和程序源码，充分理解后再使用，以减少使用风险。

🧹 **人机协作磁盘清理工具**

利用 **WizTree 快速扫描** + **AI 智能分析**，高效清理磁盘空间。

[English Documentation](./docs/README_EN.md) · [更新日志](./CHANGELOG.md)

---

## 为什么做这个？

> **C 盘爆满，却不敢清理？**

大部分电脑使用者都有这样的困扰：

- C 盘用了一两年后越来越满，但**不敢轻易清理**
- 不知道哪些文件能删、哪些不能删，怕删错导致系统崩溃
- 找收费软件清理，或者网上找人帮忙（几十到一两百不等）

**根本原因是：**
1. 我们普通人不是电脑专家，不知道哪些能清理、哪些不能清理
2. 不知道哪些文件占用空间大

**解决思路：**
- 如果能**快速找出占用大的文件**
- 再让**专业的人来判断**能不能清理
- 这个问题就解决了！

**这就是这个工具的做法：**

```
WizTree 快速扫描（3-5秒）
        ↓
    导出磁盘占用数据
        ↓
    AI 专业分析：哪些占用大、哪些能清理
        ↓
    （为了安全，初级版本暂时）避开系统文件，列出可清理目录
        ↓
    用户确认后，执行清理
```

**现在，普通用户也能安全、简单地自行清理 C 盘了。**

---

## 核心理念

> **安全 · 简单 · 给权限就全自动**

| 特点 | 说明 |
|------|------|
| 🔒 **安全** | 只清理缓存/临时文件，永不删除系统文件和用户数据 |
| 🛡️ **可回滚** | 清理前自动备份，出问题一键恢复 |
| ✨ **简单** | 一条命令 `/clean-c-drive` 搞定一切 |
| 🤖 **智能** | 给管理员权限 = 扫描/执行全自动（清理方案仍需你确认）；不给权限 = AI 分析 + 人工执行 |

```
┌─────────────────────────────────────────────────┐
│  给管理员权限  →  AI 全自动：扫描→分析→清理     │
│  不给权限      →  AI 分析 + 人工执行清理脚本    │
└─────────────────────────────────────────────────┘
```

---

## 关于 Agent Skills

### 什么是 Agent Skills？

**Agent Skill** 是一种 极简巧妙的AI Agent架构设计理念，通过模块化、可复用的"技能"封装来扩展 AI通用模型的能力。本质上，它是将复杂的业务逻辑、操作流程、专业知识打包成标准化的 Markdown 指令和脚本，让用户通过简单命令（如 `/clean-c-drive`）触发完整的自动化工作流。
Agent Skills 代表了 AI 应用架构从"大而全的通用模型"向"精而专的模块化能力"演进的重要趋势。它通过渐进式披露解决了上下文窗口的限制，通过文件系统标准化实现了知识的可发现与可组合，最终让 AI Agent 从"能做"进化到"擅长做"，从"工具"升级为"专家"。
总体说来，从MCP、claude code cli、Agent Skills到最新发布的claude cowork来看，Anthropic司在最大化销售自家token的水平上，是专业的，是值得关注和学习的。
### 核心设计理念

#### 1. **渐进式信息加载**
- 启动时仅加载技能元数据（几百 tokens）
- 匹配任务时才加载完整指令（几千 tokens）
- 执行时按需加载脚本和资源
- 结果：相比传统方案，**上下文消耗降低 95%+**，大幅降低成本

#### 2. **模块化与可组合**
- 每个 Skill 是独立的目录结构（SKILL.md + 脚本 + 资源）
- 技能之间互不干扰，可独立验证
- 支持多个技能组合解决复杂问题
- 易于在团队、项目间共享和复用

#### 3. **文件系统即知识网络**
- 文件结构本身就构成了知识图谱
- AI Agent 可自主发现可用技能
- 理解技能间的依赖关系

### 核心优势

| 维度 | 优势 |
|-----|------|
| **效率** | 上下文消耗减少 95%，API 成本大幅下降 |
| **易用** | 只需 Markdown + 简单脚本，无需部署服务器 |
| **分发** | 纯文本文件，可像分享文档一样传播 |
| **自文档化** | SKILL.md 就是完整文档和实现逻辑 |
| **可移植** | 基于文件系统，可在不同平台间无缝迁移 |
| **知识容量** | 通过外部文件和脚本，可携带超过上下文限制的知识 |
| **智能适应** | 借助 AI 推理，能灵活处理预期之外的情况 |

### 在本项目中的应用

这个清理工具正是 Agent Skill 设计理念的实践：

```
用户执行 /clean-c-drive
        ↓
  AI Agent 加载 Skill 指令和脚本
        ↓
  根据权限自动调整工作流（全自动 或 半自动）
        ↓
  调用 WizTree 扫描、AI 分析、执行清理
```

通过 Agent Skill，一个原本需要多个脚本、复杂参数、人工配置的任务，现在用户只需一条命令。

**更多信息：** 详见 [Agent Skills 官方文档](https://platform.claude.com/docs/zh-CN/agents-and-tools/agent-skills/overview)

---

## 特性

- ⚡ **极速扫描**：使用 WizTree 的 MFT 扫描技术，秒级完成
- 🤖 **AI 分析**：智能识别可清理目录，按优先级分类
- 🎯 **优先级分类**：高/中/低三级清理建议
- 🔒 **安全清理**：永不删除系统文件和用户数据
- 🤝 **人机协作**：两种模式满足不同用户需求

## 两种模式

### 模式一：普通权限 CLI

```
👤 人类：扫描 + 导出数据
🤖 AI：分析 + 生成清理脚本
👤 人类：执行清理脚本
```

适合：注重安全的用户

### 模式二：管理员权限 CLI（推荐）

```
👤 人类：只需说"帮我清理C盘"
🤖 AI：自动扫描 + 分析 → 你确认方案 → 自动清理
```

适合：追求效率的用户

## 快速开始

### 前置要求

- [WizTree](https://diskanalyzer.com/) - 免费磁盘空间分析器
- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) - Anthropic 的 CLI 工具
- Python 3.x

> **推荐使用 Opus 模型**
> 本技能涉及文件系统操作和复杂的分析任务，建议使用 Claude Opus 模型以获得最佳效果。
> 在 Claude Code 中使用 `/model opus` 切换模型。

### 安装

1. 克隆仓库：
   ```bash
   git clone https://github.com/iziqing/-disk-cleaner.git
   cd -disk-cleaner
   ```

2. 将 WizTree 放入 `WizTree/` 目录（或修改配置中的路径）

3. 安装为 Agent Skill（v1.1 起为标准 SKILL.md 结构）：
   ```bash
   # 用户级安装（推荐，所有项目可用）
   mkdir -p ~/.claude/skills/clean-c-drive
   cp -r SKILL.md scan.py analyze.py backup.py references ~/.claude/skills/clean-c-drive/
   # 或项目级：复制到 你的项目/.claude/skills/clean-c-drive/
   ```

### 使用方法

**管理员权限模式（推荐）：**

```powershell
# 以管理员身份打开终端
claude

# 输入命令：
/clean-c-drive
```

**普通权限模式：**

1. 以管理员身份运行 WizTree，扫描并导出 CSV
2. 保存到 `skills/clean-c-drive/data/`
3. 在 Claude Code 中运行 `/clean-c-drive`

## 清理内容

### 高优先级（安全清理）
| 类别 | 说明 |
|------|------|
| Windows 更新缓存 | `SoftwareDistribution\Download` |
| 内核崩溃转储 | `LiveKernelReports` / `Minidump`（实测单文件可达 4.7GB） |
| Chrome 端侧AI模型 | `OptGuideOnDeviceModel`（约4GB，删后建议禁用对应 flag 防重下） |
| NVIDIA 更新缓存 | `ota-artifacts` |
| pip/npm/yarn 缓存 | 包管理器缓存 |
| 临时文件 | Temp 目录 |

### 中优先级（谨慎清理）
| 类别 | 说明 |
|------|------|
| 应用缓存 | 各种应用程序缓存 |
| 日志文件 | 应用程序日志 |
| GPU 缓存 | 着色器缓存 |

### 低优先级（需确认）
| 类别 | 说明 |
|------|------|
| Gradle 缓存 | 构建缓存 |
| Cargo 缓存 | Rust 包缓存 |
| Go Modules | Go 包缓存 |
| Playwright 浏览器 | 测试浏览器内核，可一键重下 |
| 浏览器 IndexedDB | 网页应用离线数据/登录状态（v1.1 起从"高"降级：删后网站掉登录甚至丢数据） |

### 安全红线（永不清理）

系统还原点、`Windows\Installer`、`Package Cache` / `InstallerCache`（删了软件无法修复/卸载）、驱动库 DriverStore、用户文档/桌面/图片、微信QQ数据（`Tencent Files` / `xwechat_files`）、`.ssh` 等凭据目录。完整清单见 `references/knowledge.md`。

> 💡 清理完成后建议保留备份 **7 天观察期**——有些问题（如某应用下次启动才报错）当场看不出来。

## 工作原理

```
┌─────────────────────────────────────────────────────────────┐
│                      工作流程                                │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐     │
│  │  WizTree    │───▶│  AI Agent   │───▶│   执行清理   │     │
│  │  快速扫描    │    │  智能分析    │    │             │     │
│  └─────────────┘    └─────────────┘    └─────────────┘     │
│        │                  │                  │              │
│        ▼                  ▼                  ▼              │
│   MFT 扫描          智能模式识别         安全删除           │
│   (秒级完成)         优先级分类          确认后执行          │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

## 配置

### 自定义清理规则

编辑 `analyze.py`：

```python
CLEANABLE_PATTERNS = {
    "high": {
        "patterns": [
            {"pattern": "你的模式", "name": "描述", "safe": True},
        ]
    }
}
```

### WizTree 路径

v1.1 起 `scan.py` 自动探测：环境变量 `WIZTREE_PATH` → 技能目录 `WizTree\` → `Program Files` → PATH。也可直接指定：

```powershell
$env:WIZTREE_PATH = "你的路径\WizTree64.exe"
```

## 贡献

欢迎提交 Pull Request！

## 许可证

MIT License - 详见 [LICENSE](./LICENSE)

## 致谢

- [WizTree](https://diskanalyzer.com/) - 世界上最快的磁盘空间分析器
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) - AI 驱动的 CLI 工具

## 免责声明

⚠️ **使用风险自负。** 请在确认删除前仔细查看清理报告。作者不对任何数据丢失负责。
````
