DiskCleaner — Windows 磁盘清理工具（侧重 C 盘）

零依赖（仅用 Python 标准库）的小工具，提供命令行与图形界面两种用法。 默认 只扫描不删除，确认后再清理。

功能

• 用户 / 系统临时目录、Prefetch、SoftwareDistribution\Download、WER 错误报告
• IE/旧版 Edge 缓存（INetCache）、缩略图缓存（仅 thumbcache_*.db）、CrashDumps
• Chrome / Edge / Firefox 浏览器缓存：自动遍历所有 Profile，仅清理 Cache / Code Cache / GPUCache / ShaderCache / Service Worker 等纯缓存子目录，不会动书签、登录状态、扩展、Cookie
• 传递优化（Delivery Optimization）缓存
• 回收站全盘清空（调用 Clear-RecycleBin）
• hiberfil.sys —— 一键 powercfg /h off 关闭休眠并删除该文件（需要管理员）
• pagefile.sys / swapfile.sys —— 仅显示大小（不参与清理，避免误操作）
• 可选 DISM 组件存储清理（/StartComponentCleanup /ResetBase，需要管理员；耗时较长）

用法

图形界面（推荐）

python disk_cleaner_gui.py

• 顶部选择 目标盘，点 扫描 后中部表格列出每项体积。
• 点击行首 [ ] / [x] 勾选；[i] 表示仅信息（不可勾选）。
• 默认勾选所有“安全”项；hibernation、prefetch 等敏感项默认 不 勾选。
• 点 清理选中 后弹窗二次确认，所有操作在后台线程中执行，UI 不卡顿。
• 没有管理员权限时，标题栏右侧会显示 以管理员身份重启 按钮。

命令行

# 仅扫描 C 盘（不删除任何文件）
python disk_cleaner.py --drive C:

# 真正清理；同时执行 DISM 组件清理
python disk_cleaner.py --drive C: --apply --dism

# 只清理指定项（key 见扫描输出第一列）
python disk_cleaner.py --drive C: --apply --targets user_temp,chrome_cache,edge_cache,inet_cache

打包成单文件 EXE

需要本机已安装 Python 3.9+，然后双击 build_exe.bat 或：

build_exe.bat

脚本会自动创建 .venv、安装 pyinstaller，并打包出 dist\DiskCleaner.exe（GUI、单文件、自动请求管理员）。

安全设计

• 清理目录时 保留目录本身，仅删除其中内容，避免破坏系统结构（如 Windows\Temp）。
• 缩略图只动 thumbcache_*.db；浏览器只动各 Profile 的 cache 子目录。
• 任何文件被占用 / 无权限只会被记入“失败项”，不会中断流程。
• 信息项（pagefile.sys、swapfile.sys）显式标注且不可清理。

备注

• hiberfil.sys、pagefile.sys 在 非管理员 下可能读取不到大小，显示 0 字节属正常；以管理员运行后即可看到真实大小。
• 关闭休眠 (powercfg /h off) 之后将 无法使用 Windows 快速启动 / 休眠；如需恢复，运行管理员 PowerShell：powercfg /h on。
• DISM /ResetBase 之后将 无法卸载已安装的更新，请评估后再使用。

关于 OPC Studio · About

DiskCleaner 是 OPC Studio 的开源项目之一 —— 一个专注于 AI 工具与交互式体验的独立工作室。

• 🧹 DiskCleaner · 磁盘清理工具 —— 本项目（Windows 磁盘清理，含 EXE 下载与源码）
• ✈️ AirportTwin · 机场数字孪生 —— 机场地面运行数字孪生
• 🛗 ElevatorTwin · 电梯数字孪生 —— 电梯调度数字孪生
• 🏠 HouseTwin · 3D 住宅设计器 —— 参数化 3D 户型 / 室内设计
• 🌐 全部项目 → opcstudio.cc