Windows 存储分析器

它解决什么问题

Windows 磁盘告急时，常见痛点不是“没有工具”，而是扫描结果散乱、路径过长、系统目录不敢碰、临时文件和应用缓存混在一起。storage-analyzer-windows 面向这个场景：先在本地完成只读扫描，再让 Agent 把大小、归属和风险整理成结构化 JSON，最后通过本地服务打开交互式 HTML 报告。它的目标不是直接替你删文件，而是把“哪里大、能不能清、怎么清”拆成可核对的三档。

核心能力与关键步骤

• 扫描：scan.py 使用标准库遍历 12 组目标，包括临时目录、浏览器缓存、开发缓存、ProgramData、回收站相关区域等；支持 --quick 快速概览，也支持 --cache 减少重复扫描。
• 分级：Agent 读取 storage_scan.json 后生成 storage_analysis.json，按 🟢 可自动清理、🟡 需人工判断、🔴 建议卸载处理 输出说明。
• 报告：server.py 启动本地服务，页面可查看 Top 目录、大小估算、命令建议和清理按钮；绿色项默认走“移到废纸篓”确认流程，避免误删。
• 安全约束：扫描阶段只读；删除命令默认展示，由用户确认；系统目录有保护范围；长路径使用 \\?\ 前缀处理。

适用边界

它适合 Windows 10/11 的本地排查，依赖 Python 3.10+。不适合作为生产批量清理工具：某些路径会受权限、占用、OneDrive 同步影响；回收站在普通用户下可能无法直接读取；涉及系统组件、应用数据和虚拟机镜像时，报告更偏向“解释风险”而不是给出绝对结论。