SuperAPI AI 工具集

c-drive-cleaner

办公与效率

查看项目

更新于 10-16 04:45

技能介绍

C盘清理大师是一款安全导向的 Windows 磁盘清理技能,核心流程为“分析 → 模拟 → 执行 → 验证”,所有破坏性操作都先预览再执行。

用途 当用户说 C 盘满了、磁盘空间不足,或需要清理临时文件、缓存、回收站、系统日志,以及查找大文件、分析磁盘占用时使用。仅适用于 Windows 环境。不用于 macOS/Linux 磁盘清理、卸载软件(引导用户走系统卸载)、清理用户个人文件(只报告位置,删除决定权在用户)。

主要能力 技能提供三个脚本:

  • scripts/analyze_disk.py:目录占用排行 + 大文件列表,只读,自动跳过无权目录。用法示例:python scripts/analyze_disk.py C:\ 2 20(路径 深度 显示前N项)。
  • scripts/find_large_files.py:按大小/类型查找文件,只读,显示访问时间辅助判断。用法示例: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。
  • scripts/clean_temp.py:清理临时文件/缓存/日志/回收站,默认模拟,--execute 二次确认,跳过系统关键目录。用法示例:python scripts/clean_temp.py(模拟:只预览);python scripts/clean_temp.py --execute(实际执行:需二次确认)。覆盖范围:%TEMP%、C:\Windows\Temp、浏览器缓存(Chrome/Edge/Firefox)、.log/.etl/.old 日志、回收站。

使用方式

  1. 分析占用:运行 analyze_disk.py 查看目录占用排行与大文件列表。
  2. 查找大文件(只报告,不删):运行 find_large_files.py,可按大小或类型过滤。
  3. 清理(默认模拟模式):先运行 clean_temp.py 预览,确认后再加 --execute 实际执行。
  4. 验证:重跑 analyze_disk.py,对比前后数字回报实际效果。

验收标准(清理任务完成前自查)

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

禁删清单(碰到即停)

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

适用场景

  • C 盘空间不足,需要定位占用大头。
  • 清理临时文件、浏览器缓存、系统日志、回收站。
  • 查找大文件(视频、安装包、压缩包、备份等)并报告位置与大小。
  • 分析磁盘占用排行,辅助用户决定卸载或转移。

限制与已知陷阱

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

权限与配套

  • 部分系统文件需管理员权限(右键“以管理员身份运行”)。
  • 可配合系统自带工具:cleanmgr、存储感知、DISM 组件清理。
  • 深入的垃圾文件位置、清理命令、安全实践见 references/windows_cleanup_guide.md。