\r \r

Disk Space Analyzer\r

\r 扫描用户所有磁盘驱动器，生成专业的空间分析报告（HTML）。\r \r

Workflow\r

\r

Phase 1: Scan\r

\r Run the bundled scanner script to collect disk usage data:\r \r

python scripts/disk_scan.py --top 10 --deep --output \x3Coutput_path>\r
```\r
\r
- `--top N`: Number of top directories per drive (default 10)\r
- `--deep`: Deep-trace the top 3 directories on each drive, recursively following the largest child up to 5 levels deep to find the true culprit\r
- `--output`: Save JSON to file (recommended for large reports)\r
- Output: JSON with per-drive data, progress to stderr\r
\r
Read the JSON output. Key fields:\r
- `drives[]`: Per-drive overview with `top_directories`\r
- `drives[].deep_consumers[]`: Top 3 dirs with their children + `culprit_trace` (recursive deep trace result with `chain`, `leaf`, `breadcrumb`)\r
- `special_locations`: Cache/temp locations across all drives\r
- `windows_components`: C:\Windows subfolder breakdown\r
\r
### Phase 2: Generate Report\r
\r
Create an HTML report by:\r
\r
1. Read the scan JSON data\r
2. Copy `assets/report_template.html` to the workspace as the HTML output file\r
3. Replace `__REPORT_DATA__` in the HTML with the raw JSON string from `json.dumps(data, ensure_ascii=False, separators=(',',':'))`\r
4. The HTML template uses `const REPORT_DATA = __REPORT_DATA__;` — JSON is injected directly as a JS object literal, no parsing needed\r
5. Deliver the HTML file and preview it\r
\r
⚠️ **Simply replace `__REPORT_DATA__` with the raw JSON output. Do NOT add any extra escaping.**\r
\r
Python snippet for report generation:\r
```python\r
import json\r
\r
with open(scan_json_path, encoding='utf-8') as f:\r
    data = json.load(f)\r
\r
with open(template_path, encoding='utf-8') as f:\r
    html = f.read()\r
\r
json_str = json.dumps(data, ensure_ascii=False, separators=(',',':'))\r
html = html.replace('__REPORT_DATA__', json_str)\r
\r
with open(output_html_path, 'w', encoding='utf-8') as f:\r
    f.write(html)\r
```\r
\r
### Phase 3: Present & Advise\r
\r
After showing the visual report, provide a text summary to the user:\r
\r
1. **每个盘元凶锁定**: Every drive gets a culprit alert — the deep tracer recursively follows the largest child directory up to 5 levels to find the true space hog (e.g., `Program Files → NetEase → MuMu → vms`)\r
2. **追踪路径可视化**: Show the breadcrumb path of how the culprit was traced\r
3. **前3目录深度分析**: Show children breakdown for each drive's top 3 directories\r
4. **可清理项**: List safe-to-clean caches and temp files with total savings\r
5. **优化建议**: Actionable recommendations ordered by impact\r
\r
#### Suggestion Rules\r
\r
- If a directory exceeds **30%** of drive used space, flag it as the primary culprit\r
- For Windows systems, note `WinSxS` is not safe to manually delete; recommend `Dism /Online /Cleanup-Image /StartComponentCleanup`\r
- For MuMu/Android emulators, recommend migrating VM storage to another drive\r
- For cache/temp files, confirm with user before deleting (show the list first)\r
\r
### Edge Cases\r
\r
- If a drive scan fails (permission denied), skip and note it\r
- On non-Windows systems, the `special_locations` scan will simply find fewer items\r
- If only one drive exists, still run the full workflow\r