Windows 目录 Top 10 最大文件扫描器

要解决的问题

在 Windows 机器上排查磁盘占用时，常见情况不是不知道哪些文件最大，而是要在 C:/Users、项目目录或日志目录里手动翻找。逐个目录打开资源管理器、按大小排序，容易遗漏子目录，也不方便把结果交给脚本或 Agent 后续分析。

技能如何工作

这个技能围绕一条 PowerShell 扫描链路工作：

• 指定扫描根目录：通过 -path 传入目录，默认当前目录；脚本会先 Resolve-Path，路径不存在或不可访问时直接报错退出。
• 按规则取文件：使用 Get-ChildItem -File 只收集文件，-depth 可限制递归层数，-1 表示不限深度。
• 排序并截断：按 Size 降序排列，取前 10 个文件，同时统计总文件数、总大小和扫描耗时。
• 输出可读结果：用彩色表格展示排名、字节数、可读大小、相对路径，并用进度条表达文件相对最大文件的占比。
• 输出机器可读结果：在 ---JSON_OUTPUT_START--- 和 ---JSON_OUTPUT_END--- 之间输出 JSON，包含 top10、路径、大小、修改时间和扫描统计。

适用边界

它适合做 Windows 目录级的大文件快速盘点，不适合替代完整磁盘审计或权限排查。扫描深度不受限时，目录越大耗时越长；无法访问的文件会被跳过；结果按单文件大小排序，不会聚合目录大小。若需要自动化，应解析 JSON 标记中的结构化字段，而不是直接读取彩色表格。