已成功复制到剪贴板！
disk-cleanup-audit v0.1.0
🌐 EN / 中文 GitHub 下载工具
🛡️ 100% 严格只读 · 零破坏性调用 · 静态 AST 验证 · Windows 10/11

不删错一个字节，掌控每一寸磁盘

模块化、企业级 Windows 磁盘垃圾深度审计工具。全方位扫描系统临时文件、浏览器缓存、开发环境依赖包与社交通讯软件，精确分流三级安全风险，提供官方处置指南与多格式审计报表。

立即下载便携版 (v0.1.0) 查看 GitHub 源码
终端一键安装: pip install git+https://github.com/cjingwei6-hub/disk_cleanup_audit.git
0
写入/删除系统调用 (AST 守护)
383 / 383
全套单元/集成/安全测试通过
3 级
智能安全分流 (Safe/Caution/Warn)
< 5s
快速扫描 30,000+ 文件与目录
Interactive Terminal

沉浸式真实控制台审计模拟

体验纯正 ANSI 彩色输出与针对 CJK 东亚宽字符优化的完美对齐表格。

Windows PowerShell - disk-cleanup-audit (Host: ROG)
Reliability Engineering

四大高可靠性架构基石

专为对数据安全有极高要求的专业开发者、企业系统管理员与效率极客设计。

100% 绝对只读铁律

从源码设计层面彻底杜绝破坏性原语，为每一次磁盘分析提供绝对的心理安全感。

  • 零删除原语：绝不调用 os.remove, rmdir, unlink 或 DeleteFileW
  • AST 语法树守卫：CI 阶段自动化遍历 Python AST 严查写操作
  • 动态猴子补丁：运行时拦截破坏性系统调用并立即抛错熔断

Windows 特殊文件系统屏障

针对 NTFS 各种历史遗留特性、软硬链接以及锁机制做足了深层防御。

  • Junction 软链接防护：精准识别 Reparse Points，阻断目录死循环
  • WinError 32 共享冲突免疫：只读元数据探测，不霸占文件独占锁
  • 超长路径突破：自动注入 \\?\ 扩展前缀，超越 260 字符限制
  • 恒定 Exit Code 0：即使遇到受保护目录也作为遥测记录，绝不崩溃

三级安全与风险分类分流

遵循微软官方 VolumeCaches 规范与领域知识，精准辨识临时缓存与个人资产。

  • Safe (绿色)：系统崩溃转储、缩略图、临时下载，随时可删
  • Caution (黄色)：pip、npm、Gradle 依赖缓存，删了需重下
  • Warning (红色)：微信/QQ 发来的文档与发票，严禁盲目自动清理

东亚 CJK 宽字符终端对齐

解决 Windows 终端打印中文路径或文件名时表格边框参差不齐的顽疾。

  • East Asian Width 算力：双全角字符精算 2 字符宽度对齐
  • Unicode 优雅边框：专业表格边框无缝贴合，赏心悦目
  • --no-color 纯文本降级：无色模式完美支持自动化脚本与管道输出
Risk Assessment

三级安全风险分类准则

清楚知道每一项垃圾清理后的实际影响，拒绝“一键清理导致的痛哭流涕”。

SAFE · 零风险 · 可直接清除

系统临时与快照类缓存

临时文件、崩溃转储（.dmp）、已完成更新安装包与缩略图缓存。清理后系统会根据需要静默重新创建，对日常使用完全透明。

%TEMP% SoftwareDistribution\Download CrashDumps thumbcache_*.db $Recycle.Bin
CAUTION · 中风险 · 构建与网络惩罚

开发工具包与依赖镜像

删掉后不会导致项目损毁或系统报错，但离线构建时可能会被迫从网络重新拉取依赖，消耗宝贵的宽带流量与编译时间。

pip\cache npm-cache .m2\repository .gradle\caches Docker WSL VHDX
WARNING · 高危风险 · 不可逆个人资产

社交办公文档与用户专属文件

用户在微信、QQ 群中接收到的商务合同、开票 PDF、高清照片，以及长期未整理的 Downloads 大文件。严禁工具自动化批量删除！

Documents\WeChat Files Documents\Tencent Files User Downloads (>100MB)
Remediation Playbook

官方与厂商推荐处置方案

审计工具只做严谨诊断，绝不盲目越权。清理操作请使用官方安全命令：

Safe 1. 官方 Windows 磁盘清理与更新包回收 (CMD / PowerShell)
cleanmgr.exe /d C: ; Clear-RecycleBin -Force
Safe 2. WinSxS 组件存储清理 (需以管理员权限运行)
Dism.exe /online /Cleanup-Image /StartComponentCleanup
Caution 3. Python pip 与 Node.js npm 缓存安全清理
pip cache purge ; npm cache clean --force
Caution 4. Docker 冗余构建缓存与无用容器卷清理
docker system prune -a --volumes
Warning 5. 微信聊天文件人工清理引导
打开微信客户端 → 左下角菜单 → 设置 (Settings) → 通用设置 (General) → 存储空间管理 (Storage Management)，在界面中选择性清理朋友圈缓存或单项会话附件。
User Guide & Tutorials

使用教程：从新手上手到高阶巡检

纯只读安全审计，绝不误伤系统与个人资产。跟随以下实战场景，轻松诊断磁盘占用瓶颈。

第 1 步 · 基础上手

3 秒快速全盘体检

无序任何繁琐配置，直接在终端中运行主程序。工具将在 3 秒内完成 Windows 核心目录深度巡检，输出 ANSI 彩色 KPI 看板与 Top 10 占用排行榜。

disk-cleanup-audit
第 2 步 · 报表导出

导出 Markdown / JSON 审计报告

在屏幕展示控制台仪表盘的同时，自动生成包含三级风险矩阵和清理建议的结构化 Markdown 报告，供汇报归档或在 VS Code / 飞书中查阅。

disk-cleanup-audit -f both -o C盘体检报告.md
第 3 步 · 模块定点

程序员 / 社交大文件专项排查

通过 -c 参数指定排查目标。例如快速揪出 pip、npm、Gradle、Docker 虚拟磁盘及休眠的 node_modules；或排查微信 QQ 接收的陈年附件。

disk-cleanup-audit -c dev,social -n 20
第 4 步 · 抓大放小

大文件门槛过滤与告警阈值

屏蔽海量几 KB 的琐碎小文件，只聚焦占用超过 100MB 的重大吞噬源，同时可自定义单分类告警红线（如超过 2GB 高亮报警）。

disk-cleanup-audit --min-size 100MB --threshold 2GB
第 5 步 · 安全处置

依据官方指导安全清理

根据审计报告中的官方建议自主执行清理。绿色的 Safe 项放心用官方命令清空；红色的 Warning 项（微信/下载）在微信客户端中人工按好友管理，绝不盲删。

cleanmgr.exe /d C: ; pip cache purge
第 6 步 · 定期巡检

自动化后台定期审计

结合 Windows 任务计划程序或 CI/CD 流水线，静默运行并输出无 ANSI 乱码纯文本或 JSON 格式健康报表，及时发现异常写盘与空间异常暴增。

disk-cleanup-audit -f json -o report.json -q
Download & Install

获取 disk-cleanup-audit

提供免安装便携版 Windows 可执行程序、Python Wheel 二进制包与完整源码归档。

推荐 · 零依赖免安装

Windows 便携版 (.zip)

内置独立 Python 运行时与完整引擎，解压即用，无需配置环境。

版本: v0.1.0
平台: Windows 10 / 11 (x86_64)
文件体积: 10.1 MB (打包归档)
SHA-256 校验码:
0c7f7055f05a6850ee01463199df4f31a01f035af07aaf8c427daf6d8129b6b5
下载绿色便携 ZIP (10.1 MB) 下载独立便携程序 (.exe, 10.8 MB) GitHub Releases 官方发布页

Python Wheel 安装包

适合已配置 Python 3.10+ 环境的开发者或企业自动化流水线。

格式: .whl (PEP 427)
运行时: Python >= 3.10
文件体积: 47.5 KB
SHA-256 校验码:
fbca89c6d190132035f8ebc568d1f539f5a2e25da728fa21bcf886e65d278800
下载 .whl 文件

Git 源码与归档

包含 383 项单元测试、安全验证套件、开发文档与 CLI 源码。

开源协议: MIT License
Git Remote: cjingwei6-hub/disk_cleanup_audit
源码 ZIP: 139.4 KB
SHA-256 校验码:
7d16f5781669d7ac5f663fc9608894921fac0de8015ea444e8b1cb5791161a59
下载完整源码 ZIP 在 GitHub 上浏览
CLI Reference

命令行参数速查表

参数选项 默认值 说明与示例
-c, --categories all 过滤扫描分类: system, browser, dev, social, all
-f, --format console 输出格式: console, markdown, json, both
-o, --output None 报表输出文件目标路径 (*.md, *.json)
-m, -s, --min-size 0B 最低统计体积阈值，如 50MB, 1GB
--threshold 1GB 分类警告阈值 (超标时触发重点警告)
-n, --top-n 10 展示占用最大空间的前 N 项路径
--no-color False 禁用 ANSI 转义字符，适合管道重定向与 CI/CD
--dry-run True 再次重申严格只读审计（工具始终恒定为只读）
Frequently Asked Questions

常见问题与解答

这个工具真的不会误删我的任何文件吗？ +
是的，绝对不会。工具的底层代码中完全不存在任何删除和修改原语（零 os.remove，零 shutil.rmtree）。在持续集成与发布测试中，有专门的 AST 静态语法树检查器确保代码库中无任何破坏性系统调用。工具只做只读探测与报表呈现。
运行这个工具需要以管理员（Administrator）身份运行吗？ +
普通用户权限即可正常运行并审计绝大多数用户目录（用户 Temp、浏览器、开发缓存、微信文件）。如果以管理员身份运行，可以进一步审计属于系统全局的 Windows Update 交付缓存与系统级 CrashDumps。无论是否有权限，遇到受保护文件夹都会平滑跳过，绝不报错中断。
为什么微信和 QQ 的文件被归类为 Warning，而不是建议清理？ +
社交通讯工具的接收目录（WeChat Files、Tencent Files）极高概率存放着不可恢复的个人工作资产，如合同协议、单据、发票、历史照片等。市面上许多“一键垃圾清理”软件盲目清理这些目录导致用户资产永久丢失。我们坚守安全底线，将其定性为 Warning，引导用户在官方客户端内审慎处置。
扫描过程会造成电脑卡顿或占用大量 CPU 吗？ +
不会。工具采用轻量级 os.scandir() 流式元数据遍历，不打开文件只读句柄，单次 30,000+ 文件的全面审计通常在 3~5 秒内即可完成，内存占用极低。