用途：对 macOS 或 Windows 做一次只读存储分析，扫描磁盘占用、找出占空间大户，产出交互式 HTML 报告，流程为扫描→分析分级→生成网页→打开。全程只读，只运行 df、du、diskutil、stat、ls 等扫描统计命令，禁止 rm、mv、rmdir、清空回收站、改权限等写操作；报告中的删除命令仅供用户自行确认后运行，即使用户要求代删也需先停下确认。
主要能力：scan.py 自动识别系统，macOS 扫 home、library、caches、containers、applications、downloads、dev_caches 等，Windows 扫 user_profile、appdata、temp、downloads、program_files 等，输出 JSON（含 system 与 groups，过滤 50MB 以下，读不到的目录标 denied）。分析阶段挑 Top 5 占用大户并判定类型，识别 UUID 命名的神秘大目录，按三级分类：可自动清理（纯缓存、临时文件、开发缓存等）、需人工判断（含用户数据，给内容画像与处置路径）、谨慎清理（不建议手删，给卸载步骤）。每项给预估释放空间、需关闭进程与可复制清理命令。
使用方式：python3 scripts/scan.py > /tmp/storage_scan.json 扫描；默认用 python3 scripts/server.py /tmp/storage_analysis.json 打开带删除按钮的报告（127.0.0.1、随机端口与 token，绿灯可移废纸篓或直接删除，橙灯仅可移废纸篓，红灯不给删除按钮）；仅需只读留存时用 python3 scripts/build_report.py /tmp/storage_analysis.json ~/Desktop/storage-report.html && open ~/Desktop/storage-report.html。
适用场景与限制：适合清理磁盘空间前的诊断与决策。脚本仅用 Python 3 标准库，零第三方依赖；macOS 自带 python3 开箱即用，Windows 需先装 Python 3 且命令多为 python 或 py -3。本工具由 agent 驱动，非双击即用独立 App。macOS 已完整实现并实测，Windows 代码已写但未在真实 Windows 实测，首次运行需核对路径、目录大小与回收站删除。其他细节暂未提供。