storage-analyzer

1# Storage Analyzer
2 
3对 macOS / Windows / Linux 做一次只读存储分析，产出交互式 HTML 报告。流程：扫描 → 分析分级 → 生成网页 → 打开。
4 
5## 铁律
6 
7- **全程只读。** 只能跑扫描/统计/列目录/读元信息（df、du、diskutil、stat、ls）。扫描阶段不执行删除、移动、清空回收站或改权限。
8- **清理必须有明确授权。** 只请求分析不等于授权删除；用户已批准具体对象时，Agent 可在相同边界内代为操作，无需要求再点一次浏览器。网页按钮保留逐次确认。
9- **估算标注清楚。** 涉及"可释放空间"一律说明是估算值。
10- **路径、命令保留原文不翻译。**
11 
12## 执行流程
13 
14### Step 1 扫描（只读）
15 
16从宿主当前加载的 Skill 位置取得实际绝对目录并设为 `STORAGE_SKILL_DIR`；每个新 shell 都要重新赋值。输出写入当前任务的工作目录，脚本使用带引号的绝对路径：
17 
18```bash
19python3 "$STORAGE_SKILL_DIR/scripts/scan.py" > storage_scan.json
20```
21 
22`scan.py` 自动识别系统（`sys.platform`）：
23- **macOS**：扫 home、library、caches、containers、group_containers、app_support、applications、downloads、dev_caches，用 `du -x` 算大小（不跨卷）。挂载点会被跳过并写进 `warnings`，例如 Xcode 的 `~/Library/Developer/CoreDevice/DeviceFS`：它是模拟器/设备文件系统的虚拟挂载，显示几十 GB 但不占本盘空间，不要当成清理项。二次深入查看时同样用 `du -x`。
24- **Windows**：扫 user_profile、appdata_local、appdata_roaming、temp、downloads、program_files(_x86)、dev_caches，用 `os.scandir` 算大小；`system.disks` 含所有盘符。
25- **Linux**：扫 home、`.cache`、`.local/share`、downloads、`/var`、`/tmp`、dev_caches（pip/uv/cargo/npm/go/docker/snap 等），用 `du` 算大小，不跳过挂载点（ZFS 数据集、btrfs 子卷和本盘同池）；`system.disks` 来自 GNU `df`，按 ZFS 池或设备合并，主盘是装着 `/` 的那个（解析失败时降级为根分区信息）。
26 
27输出 JSON：`system`（系统/磁盘信息，含 `disk_name` 主盘名 + `disks` 全部盘）+ `groups`（各组子目录大小，已降序、过滤 50MB 以下）。Windows 同次扫描复用子目录统计，避免重复遍历。顶层分组存在父子包含关系，不能直接相加；可释放空间还受硬链接、压缩和回收站保留影响。读取 `warnings` 并在报告中说明未读全的路径。读不到的目录标 `denied`，需在报告里列出并提示遗漏体量。
28…