前言¶
磁盤空間告警、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 共同決策：
- 綠燈（可自動清）：相對安全、Skill 邏輯允許自動處理的緩存或臨時類佔用。
- 黃燈（需判斷）：可能有用或依賴業務場景，刪除前需要確認。
- 紅燈（建議卸載）：通常對應大型應用或安裝殘留，更適合卸載或專門處理，而不是隨手刪目錄。
分級把「有多大」和「能不能動」綁在一起，避免只報數字、不給操作建議。
交互式 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
建議對話流程：
- 說明現象與盤符（例如 C 盤剩餘不足、某盤告警）。
- 明確要求 存儲分析 或 清理建議，不要與 RAM 排查混在同一句話裏。
- 等待 Agent 完成只讀掃描後，打開生成的 HTML 報告 查看三燈分級。
- 對綠燈項可同意自動清理；黃燈、紅燈項按報告說明逐項確認，必要時在本地服務界面執行刪除或改爲卸載軟件。
官方頁面未單獨列出可複製的一行 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
