---
name: c-drive-cleaner
version: 1.1.0
description: Windows C盘清理和磁盘空间管理。当用户说C盘满了、磁盘空间不足、清理临时文件/缓存/回收站/系统日志、查找大文件、分析磁盘占用时使用。仅适用于 Windows 环境。不用于：macOS/Linux 磁盘清理、卸载软件（引导用户走系统卸载）、清理用户个人文件（只报告位置，删除决定权在用户）。
---

# C盘清理大师

安全导向的 Windows 磁盘清理：**分析 → 模拟 → 执行 → 验证**，破坏性操作永远先预览。

## 验收标准（清理任务完成前自查）

- [ ] 实际删除前完成过一次模拟运行，并把预览结果给用户看过
- [ ] `--execute` 前用户明确确认过（清理不经过回收站，不可恢复）
- [ ] 已提醒用户创建系统还原点和关闭浏览器（清缓存时）
- [ ] 未触碰"禁删清单"中的任何目录
- [ ] 清理后重跑分析,回报**实际释放的空间数字**,不是"应该清理了"
- [ ] 用户个人大文件（视频/压缩包等）只报告位置与大小，删除由用户自己决定

## 禁删清单（碰到即停）

- `C:\Windows\System32` — 核心系统文件
- `C:\Windows\WinSxS` — Windows 组件存储（要瘦身走 DISM，不许直接删）
- `C:\Program Files` / `C:\ProgramData` — 已装程序及数据
- `C:\Windows\Prefetch` — 预读取文件，删了拖慢启动
- 休眠文件与虚拟内存 — 走系统设置调整，不手动删文件

## 工作流程

### 1. 分析占用
```bash
python scripts/analyze_disk.py C:\ 2 20    # 路径 深度 显示前N项
```

### 2. 查找大文件（只报告，不删）
```bash
python scripts/find_large_files.py C:\ 100 50            # 路径 最小MB 最大结果数
python scripts/find_large_files.py C:\Users 200 100 .mp4,.avi,.mkv   # 按类型过滤
```
常见大文件类型：视频 `.mp4,.mkv,.mov`；安装包 `.iso,.exe,.msi`；压缩包 `.zip,.rar,.7z`；备份 `.bak,.sql`。

### 3. 清理（默认模拟模式）
```bash
python scripts/clean_temp.py             # 模拟：只预览
python scripts/clean_temp.py --execute   # 实际执行：需二次确认
```
覆盖范围：`%TEMP%`、`C:\Windows\Temp`、浏览器缓存（Chrome/Edge/Firefox）、`.log/.etl/.old` 日志、回收站。

### 4. 验证
重跑 `analyze_disk.py`，对比前后数字回报实际效果。

## 已知陷阱

| 陷阱 | 具体表现 | 应对 |
|------|---------|------|
| 无权限静默漏扫 | 非管理员运行，扫描结果偏小误导判断 | 提示以管理员身份运行；脚本会跳过无权目录并计数 |
| 浏览器缓存清理失败 | 浏览器进程占用文件 | 先关闭所有浏览器窗口再清 |
| 清完没效果 | 临时文件本来就不大，大头是个人文件或程序 | 回到大文件报告和目录排行,引导用户决策(卸载/转移) |
| 误以为可恢复 | 脚本删除不经回收站 | 执行前明确告知不可恢复,这也是模拟先行的原因 |
| SSD 清到贴满 | 追求 100% 利用率 | SSD 保留 15-20% 空间维持性能;低于 20% 时才建议清理 |

## 权限与配套

- 部分系统文件需管理员权限（右键"以管理员身份运行"）
- 可配合系统自带工具：`cleanmgr`、存储感知、DISM 组件清理
- 深入的垃圾文件位置、清理命令、安全实践：`references/windows_cleanup_guide.md`

## 脚本说明

| 脚本 | 功能 | 安全特性 |
|------|------|---------|
| `scripts/analyze_disk.py` | 目录占用排行 + 大文件列表 | 只读；自动跳过无权目录 |
| `scripts/find_large_files.py` | 按大小/类型查找文件 | 只读；显示访问时间辅助判断 |
| `scripts/clean_temp.py` | 清理临时文件/缓存/日志/回收站 | 默认模拟；--execute 二次确认；跳过系统关键目录 |