Storage Analyzer - 只读存储分析与磁盘清理助手

技能概述

Storage Analyzer 是一个 AI 驱动的存储分析助手：对 macOS / Windows 电脑做一次全程只读的磁盘扫描，找出占空间大户，按 🟢 可自动清理 / 🟡 需人工判断 / 🔴 谨慎清理 三级给出处置方案，并生成可折叠、命令可一键复制的交互式 HTML 报告，还能起本地服务在网页上一键删除（移废纸篓或直接删）。

适用场景

1. 电脑提示磁盘满了、空间不够：不知道是什么占地方？扫描整机磁盘占用，生成占用排行 Top 5，一句话告诉你最大占用是什么、大约能释放多少空间。
2. 开发机被缓存吃满：Xcode DerivedData、pip / uv / npm 缓存、node_modules 这类可再生开发缓存被识别为 🟢 可自动清理，给出具体清理命令，在网页上一键执行。
3. 想安全地清理，又怕误删：离线视频缓存、旧备份、聊天记录这类含用户数据的内容被标为 🟡 需人工判断，附内容画像和处置路径，网页上提供「在访达打开」和「移到废纸篓（可逆）」按钮，审查后再动手。

核心功能

1. 全程只读扫描，自动识别系统：在 macOS 上用 du、diskutil 扫描 home、Caches、Containers、开发缓存等目录；在 Windows 上扫描 AppData、Temp、Program Files 等并支持多盘符。只跑读取和统计命令，不碰任何写操作，扫描不改动任何文件。中文口语说"内存满了"也能正确理解为存储空间不足（想看 RAM 占用时会主动提示这不属于本技能）。
2. 三级分类清理决策清单：不只报"什么大"，而是回答"要不要动它"。🟢 纯缓存给出一键清理命令；🟡 含用户数据的项给内容画像、至少三条处置路径和风险提示；🔴 想卸载的大应用、重复安装的应用给具体的正规卸载步骤。UUID 命名的神秘大目录会被追查归属——例如揪出藏在 Container 里几十 GB 的离线视频缓存。
3. 交互式 HTML 报告 + 网页一键删除：报告按"现状 → 诊断 → 处方 → 操作 → 预防"组织，含磁盘总览、三色容量分段条、Top 5 排行和可折叠卡片。通过本地服务打开后，🟢 项可直接「移到废纸篓」或「立即删除」，🟡 项可跳转访达自查或移废纸篓。所有删除请求经白名单 + realpath 校验 + token 验证，每次点击都需浏览器确认。全程零第三方依赖，Python 3 标准库即可运行。

常见问题

扫描会改动我的文件吗？

不会。扫描阶段只运行 df、du、diskutil、stat 这类读取命令，属于只读操作；报告里给出的清理命令也只展示、不代跑，需要你确认后执行。即使你说"帮我删"，工具也会先停下来和你确认。

一键删除安全吗？删错了还能恢复吗？

安全模型做了分层：🟢 缓存项可移废纸篓或直接删；🟡 含用户数据的项只允许移废纸篓（可逆，清空回收站前不释放空间）；🔴 应用卸载不提供后台代删，只给按钮定位到应用让你走正规卸载流程。删除前会经路径白名单和 realpath 校验，且每次点击都有浏览器确认弹窗。

它和 CleanMyMac、DaisyDisk 有什么区别？

CleanMyMac 是通用清理软件，DaisyDisk 侧重空间可视化，两者都需要安装。Storage Analyzer 是 AI 技能：由大模型对扫描结果做逐项判读（比如识别出某个 UUID 目录其实是视频 App 的离线缓存），给出带风险分级和具体命令的决策清单，零第三方依赖。当前 macOS 为完整实测状态，Windows 支持已实现但未在真机完整实测。