---

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