---
name: easy-disk
description: Easy Disk CLI(hda-cli / Easy Disk.exe):Windows 磁盘空间分析(treemap 可视化 + 红绿安全标记)。无头 CLI 输出可被 AI/脚本直接消费(--json,含红绿分类);桌面版支持命令行直扫、自动化冒烟(--smoke)与界面自动扫描(--autoscan)。安装桌面版(≥0.9.0)后 hda-cli.exe 随安装目录提供,单文件、无其他依赖。
version: 0.9.2
updated: 2026-09-13
---

# Easy Disk CLI(hda-cli)

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

## 安装

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

- 官网 skill 下载:https://pinnadash.com/assets/skills/easydisk-SKILL.md
- 产品详情页/安装包:https://pinnadash.com/easy-disk.html
- 主程序 `Easy Disk.exe` 与无头 CLI `hda-cli.exe` 随安装包落安装目录(开始菜单/桌面快捷方式自动创建)

## 无头 CLI(推荐 AI/脚本用)

`hda-cli.exe` 不弹窗、不提权、输出结构化,直接把「扫描 + 红绿分类」给到调用方:

```powershell
# 文本报告:总量 + 一级占用排名 + 绿标(建议清理)清单
"C:\Program Files\Easy Disk\hda-cli.exe" C:\Users\lin\AppData\Local\Temp

# JSON(机器可读):tree 明细(默认 1 层,--depth 调)+ 全部绿标条目
"C:\Program Files\Easy Disk\hda-cli.exe" D:\ --json

# 参数:<path> 必填;--depth N 明细层级(默认 1,总量统计始终全树);--top N 文本输出条数上限(默认 20)
```

- 红绿标记:37 条内置规则(红色=系统/勿删,绿色=缓存类可清理),语义与桌面版完全一致;`mark.source=builtin` 时 `reason`/`action` 为前端 i18n key
- 用户自定义规则:exe 同目录 `rules.json`(与桌面版同约定,用户规则优先,同源取最长 pattern)
- 子孙继承:标记目录的子项继承其红绿状态(GUI「子孙自然继承命中」同语义);`greens` 清单只含直接命中的目录/文件
- 符号链接/junction 不跟随(防环);拒绝访问的条目计入 `denied` 不中断扫描

## 桌面版命令行(Easy Disk.exe)

```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/脚本化:无头扫描并取回红绿分类 JSON(无需界面/提权)
& "C:\Program Files\Easy Disk\hda-cli.exe" C:\ --json > disk-report.json

# 3. 清理前审计:列出全部绿标缓存目录按大小排序
& "C:\Program Files\Easy Disk\hda-cli.exe" C:\Users\lin --json --depth 1 | jq '.greens[:20]'
```

## 行为与约定

- 扫描引擎:Win32 `FindFirstFileW` 原生枚举 + 8 worker 并发(桌面版);CLI 单线程深度遍历,`\\?\` 长路径,2.5 万文件量级亚秒完成
- 红绿规则:内置 37 条(Windows/Program Files 等红色保护;Temp/npm/pip/yarn/浏览器缓存等绿色可清理),可用 exe 同目录 `rules.json` 追加自定义规则,用户规则优先
- 安全边界:软件内**不提供删除**,CLI 也不提供;在资源管理器中定位后由用户自行操作
- 前端错误日志:`%TEMP%\hda_frontend.log`(排障用)