使用方式

磁盘分析

扫描结果页包含“软件占用”页签，默认展示占用最大的 10 个应用。应用的安装目录、用户 AppData、ProgramData、WindowsApps、Steam/Epic 游戏库以及常见便携软件目录会按规范化名称合并；同一应用分布在多个盘时，会展示跨盘合计与各盘明细。该排名属于基于目录归属的估算，共享运行库或自定义安装目录可能无法准确归属；选择“全部磁盘”扫描可获得完整的跨盘统计。

选择目标磁盘或整个硬盘。
点击开始分析；扫描期间会实时展示已扫描目录数、当前路径和耗时，也可以随时取消。
查看容量统计、Top 大目录和 Top 大文件，或选择两份历史报告生成差量报告。
点击让 AI 分析，当前会话会收到扫描报告的 @文件 引用。AI 可以据此给出“可安全删除、不要动、适合迁移、建议清理顺序”等建议。

在对话中也可以直接让 Agent 使用工具：

帮我分析一下 C 盘空间，并在确认后清理可安全删除的缓存。

推荐先调用 clean_disk 的 list 和 estimate，明确预计删除范围，再由用户确认是否执行 clean。

开发环境分析

进入开发环境分析页后会自动扫描路径型开发环境变量，以及用户目录和 AppData 中的常见开发缓存。24 小时内默认优先使用工作区缓存；点击“重新扫描开发环境”会跳过缓存并重新统计。

真实扫描期间页面会持续展示：

已扫描文件数
已扫描目录数
已统计路径数
当前扫描路径
已用时间

文件数和目录数使用平滑数字动画追随后台实时计数；动画过程可能跳过中间整数，但扫描完成后的最终值以实际统计结果为准。只有真实扫描才展示这段进度，从缓存读取结果时不会伪造扫描动画。

Path、SystemRoot、ProgramFiles、TEMP 等 Windows 通用变量位于本地黑名单中，不展示也不扫描。常见开发目录会同时检查默认路径、受支持的工具配置和专用环境变量；如果工具已经迁移，页面会显示“默认路径 → 当前生效路径”，统计当前生效目录的体积并标记“已迁移”。

手动迁移入口按工具的持久化方式处理：

工具或目录	迁移后修改内容
Maven 本地仓库	`settings.xml` 的 `localRepository`
npm 缓存	用户级 `.npmrc` 的 `cache`
pnpm store	pnpm 配置中的 `store-dir`
Yarn 缓存	Yarn 配置中的缓存目录
Go 工作区	Go 持久配置中的 `GOPATH`
NuGet 包缓存	`NuGet.Config` 的 `globalPackagesFolder`
Gradle 缓存	Windows 用户环境变量 `GRADLE_USER_HOME`
Cargo 缓存	Windows 用户环境变量 `CARGO_HOME`
Rustup 工具链	Windows 用户环境变量 `RUSTUP_HOME`
Android 用户目录	Windows 用户环境变量 `ANDROID_USER_HOME`

因此，迁移并不是只复制文件：配置文件型目录会修改对应工具配置，环境变量型目录会修改对应的 Windows 用户环境变量。插件不会把所有迁移都统一改成环境变量，也不会修改系统 Path。

页面只有在源目录存在，并且受支持的持久配置可解析、可写或存在专用用户环境变量时，才显示“迁移”按钮。没有手动入口的扫描目录可以交给 AI 分析；AI 仍需先通过 dev_env_migrate 生成计划，用户明确确认后才能执行。迁移完成后应重启终端和 IDE，确认工具使用新目录，再自行处理原目录备份。

每次生成新的开发环境迁移分析报告后，只保留最新的 开发环境迁移分析-*.md，并自动删除旧报告和 开发环境分析.json 扫描缓存；磁盘扫描与差量报告不受影响。

配置

配置项	默认值	说明
`scanTimeoutMs`	300000	磁盘扫描超时，默认 5 分钟
`cleanTimeoutMs`	120000	清理超时，默认 2 分钟
`migrationTimeoutMs`	1800000	开发环境目录迁移超时，默认 30 分钟
`maxDepth`	8	工具默认递归深度
`topDirsCount`	30	返回的 Top 目录数
`topFilesCount`	50	返回的 Top 文件数
`treeRenderMaxNodes`	200	树形文本最大渲染节点数

@dsh-plugin/disk-sentinel

설치

문서

使用方式

磁盘分析

开发环境分析

配置