/Geek-skills-c-drive-cleaner

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. 分析占用

python scripts/analyze_disk.py C:\ 2 20    # 路径 深度 显示前N项

2. 查找大文件（只报告，不删）

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. 清理（默认模拟模式）

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 二次确认；跳过系统关键目录 |