前言¶

磁盘空间告警、C 盘只剩几 GB、用户只说「电脑变慢是不是满了」——这类问题在运维和桌面支持里很常见。手工打开资源管理器逐个目录看体积，既慢又难给出「能不能删」的结论；通用清理工具往往黑盒，也不适合交给 Agent 按对话上下文执行。

下面介绍 SkillHub 上的 storage-analyzer-windows：让 AI 在 纯 Windows 环境里做 只读扫描，用固定规则把占用归到三档，再生成可交互的 HTML 报告，并在本地起服务支持受控删除。实现侧只依赖 Python 3.10+ 标准库，无需额外第三方包，也不覆盖 macOS。

这是什么¶

storage-analyzer-windows 是社区来源（community）的 Agent Skill，坐标为 @user_3a8d4fb8/storage-analyzer-windows，SkillHub 分类为 it-ops-security，当前版本 1.0.1，发布者为 user_3a8d4fb8（SkillHub 页面标注作者 GARYLOOOOP）。requires_api_key=false，安装与使用不依赖外部 API Key。

一句话定位：在 Windows 上扫描多类系统与用户目录的磁盘占用，按风险分级，输出 HTML 报告，并可经本地服务执行一键删除（在 Agent 流程中由 Skill 指引完成）。Skill 内节点名称为「存储分析(Windows)」。

官方入口：

• API / 坐标页：https://api.skillhub.cn/user_3a8d4fb8/storage-analyzer-windows
• SkillHub 展示页：https://www.skillhub.cn/skills/user_3a8d4fb8/storage-analyzer-windows

核心功能¶

以下能力均来自官方简介与 SkillHub 页面说明，可按条目核对。

扫描范围¶

对 12 组以上 预设目标做只读分析，覆盖常见「吃盘」位置，其中包括 Installer、ProgramData、回收站 等（完整列表以 Skill 包内 SKILL.md 为准）。扫描阶段不修改文件，先汇总体积与路径，再进入分级与报告。

三灯分级¶

扫描结果会归入三档，便于人和 Agent 共同决策：

1. 绿灯（可自动清）：相对安全、Skill 逻辑允许自动处理的缓存或临时类占用。
2. 黄灯（需判断）：可能有用或依赖业务场景，删除前需要确认。
3. 红灯（建议卸载）：通常对应大型应用或安装残留，更适合卸载或专门处理，而不是随手删目录。

分级把「有多大」和「能不能动」绑在一起，避免只报数字、不给操作建议。

交互式 HTML 报告与本地删除¶

分析结束后生成交互式 HTML 报告，便于按目录、按级别浏览占用。需要清理时，Skill 会配合 本地服务 提供「一键删」能力（在报告或本地接口侧操作，具体步骤以 Skill 文档为准），删除动作仍在用户可控的 Windows 本机环境中完成。

与运行内存（RAM）的边界¶

用户若明确问 哪个进程吃内存、内存占用高，指的是 RAM，不应触发本 Skill。简介中的触发词包含「看下内存」「内存满了」等口语，Skill 设计意图仍是 磁盘 / 存储；Agent 应根据上下文区分存储与内存，避免误用。

安装与启用¶

SkillHub 提供的通用安装方式，是向你的 AI 客户端发送一段安装提示，并引用官方安装说明文档。

在 Cursor、Codex CLI、Claude Code 等支持 SkillHub 技能协议的客户端中，可将下面提示交给 Agent（各客户端最终落盘路径以 https://skillhub.cn/install/skillhub.md 为准）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_3a8d4fb8/storage-analyzer-windows`。

安装完成后，Agent 会在匹配到存储类意图时加载该 Skill；无需配置 API Key。

环境要求（官方明确）：

• 操作系统：仅 Windows（零 macOS 支持）。
• Python：3.10+，仅使用标准库。

典型用法¶

本 Skill 主要通过 自然语言触发，由 Agent 按 SKILL.md 执行扫描与报告流程。下列表述与官方「触发词」一致，可在对话中直接使用或改写：

• 磁盘满了 / C 盘满了 / D 盘满了 / 空间不够
• 清理空间、清理磁盘、清理 C 盘、清缓存
• 占空间、哪些东西占地方、存储分析、磁盘分析、看一下存储、电脑空间
• 英文：storage analysis、disk cleanup

建议对话流程：

1. 说明现象与盘符（例如 C 盘剩余不足、某盘告警）。
2. 明确要求 存储分析 或 清理建议，不要与 RAM 排查混在同一句话里。
3. 等待 Agent 完成只读扫描后，打开生成的 HTML 报告 查看三灯分级。
4. 对绿灯项可同意自动清理；黄灯、红灯项按报告说明逐项确认，必要时在本地服务界面执行删除或改为卸载软件。

官方页面未单独列出可复制的一行 shell 命令；可复现路径是 安装 Skill → 用触发词发起对话 → 按 Skill 指引运行 Python 扫描脚本并查看报告。脚本名与参数以安装包内文档为准。

适用场景与注意¶

适合：

• Windows 桌面/办公机磁盘告急，需要快速看清「谁在占空间」并拿到分级建议。
• 希望通过 Agent 统一完成「扫描 → 报告 → 受控清理」，而不是手动装多款清理工具。
• 希望依赖 Python 标准库、减少第三方依赖的轻量方案。

限制与注意：

• 不支持 macOS；在 Linux 或其他系统上不应启用本 Skill。
• 扫描为 只读，但 一键删 会改动文件系统，黄灯、红灯务必人工确认。
• ProgramData、Installer 等目录误删可能导致软件异常；三灯分级用于降低风险，不能替代变更窗口与备份策略。
• SkillHub 统计（截至页面信息）：评分 100000，下载 14074；社区 Skill，行为细节以 v1.0.1 包内 SKILL.md 为最终依据。

结尾¶

storage-analyzer-windows 把 Windows 上常见的「磁盘满了」问题收成一条 Agent 链路：标准库扫描、三灯分级、HTML 报告与本地受控删除。适合在 SkillHub 已接入的 AI 客户端里，用对话触发存储分析，而不是和 RAM 排查混用。

安装与详情见 SkillHub：https://www.skillhub.cn/skills/user_3a8d4fb8/storage-analyzer-windows