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