---
name: easy-disk
description: Easy Disk CLI(hda):Windows 磁盘空间分析(treemap 可视化 + 红绿安全标记)。支持命令行直扫指定路径、自动化冒烟扫描(--smoke)与界面自动扫描(--autoscan),扫描统计可直接被 AI/脚本消费。安装桌面版(≥0.6.0)后即可调用,单文件、无其他依赖。
---

# Easy Disk CLI(hda)

磁盘空间分析工具:用矩形树图(Treemap)把整盘占用画成一张图——块面积即大小,红绿安全标记标出"红色=系统目录请勿删除、绿色=缓存类建议清理"。软件内不做删除,只负责看和定位(右键直达资源管理器)。**全程本机扫描,不上传任何数据。**

## 安装

从官网直链下载安装包(**v0.6.0 及以上**),per-machine 装 `C:\Program Files\Easy Disk`:

- 官网:https://pinnadash.com/easydisk.html
- 主程序 `Easy Disk.exe` 随安装包落安装目录(开始菜单/桌面快捷方式自动创建)

## 命令行用法

安装目录下的 `Easy Disk.exe` 支持以下参数(可加入 PATH 或用完整路径调用):

```powershell
# 命令行直扫:启动后自动扫描指定路径(盘符或任意子目录),界面保持打开
"C:\Program Files\Easy Disk\Easy Disk.exe" C:\

# 冒烟模式:自动扫描 → 完成后向 stdout 打印统计(JSON)并退出(自动化验证/脚本消费)
"C:\Program Files\Easy Disk\Easy Disk.exe" --smoke C:\Users\lin\AppData\Local\Temp

# 自动扫描:启动即扫,不退出(界面验证/演示)
"C:\Program Files\Easy Disk\Easy Disk.exe" --autoscan D:\
```

## 典型示例

```powershell
# 1. 快速看 D 盘哪个目录最占空间(扫描中即可边看边浏览)
& "C:\Program Files\Easy Disk\Easy Disk.exe" D:\

# 2. CI/脚本化验证:对临时目录冒烟扫描并取回统计
& "C:\Program Files\Easy Disk\Easy Disk.exe" --smoke $env:TEMP
```

## 行为与约定

- 扫描引擎:Win32 `FindFirstFileW` 原生枚举 + 8 worker 并发,目录完成即推流,边扫边出图
- 红绿规则:内置 37 条(Windows/Program Files 等红色保护;Temp/npm/pip/yarn/浏览器缓存等绿色可清理),可用 exe 同目录 `rules.json` 追加自定义规则,用户规则优先
- 安全边界:软件内**不提供删除**,右键/回车直接在资源管理器中定位,删除由用户自行操作
- 前端错误日志:`%TEMP%\hda_frontend.log`(排障用)