前言¶
開發機磁盤被緩存、重複包和大文件慢慢佔滿時，常見做法是裝系統清理工具或直接 rm。前者往往黑盒，後者一旦誤刪很難挽回。若希望 Agent 按固定流程幫你「先看報告、再按風險分批處理」，且默認只進廢紙簍而不硬刪，可以把 SkillHub 上的 電腦磁盤清理（@kunlungrowth/kunlun-pc-cleaner）裝進 Cursor、Claude Code 等支持 SKILL.md 的客戶端，用對話驅動掃描與整理。
這是什麼¶
電腦磁盤清理 是崑崙增長在 SkillHub 發佈的 enterprise 來源 Skill，當前版本 v1.2.1，分類爲 it-ops-security，標籤 requires_api_key=false（無需 API Key）。
一句話定位：先 只讀掃描 生成回收報告，再 按風險分級 分批把文件移入廢紙簍（絕不硬刪除），並覆蓋重複文件、緩存、大文件、舊下載、截圖與視頻等場景；實現上需處理 macOS / Windows / Linux 的路徑差異。
- SkillHub 頁面：https://www.skillhub.cn/skills/kunlungrowth/kunlun-pc-cleaner
- 座標：
@kunlungrowth/kunlun-pc-cleaner
核心功能¶
以下能力均來自 SkillHub 官方簡介，未在頁面寫明的能力不展開。
-
只讀掃描與回收報告
第一步不改動磁盤，只掃描並輸出可讀的回收報告，便於你先判斷要動哪些目錄、能騰出多少空間。 -
風險分級與分批執行
對候選文件做風險分級，確認後再分批移入廢紙簍，避免一次性大批量誤操作。 -
軟刪除策略
明確約定移入廢紙簍，不做硬刪除，降低誤刪不可恢復的風險。 -
多場景覆蓋
重複文件、緩存、大文件、舊下載、截圖與視頻等常見佔盤類型納入同一套流程。 -
跨平臺路徑
同一 Skill 面向 macOS、Windows、Linux，由 Skill 內邏輯區分各系統路徑習慣。
安裝與啓用¶
SkillHub 推薦通過其安裝文檔與 CLI 安裝到 當前 Agent 的 skills 目錄；裝錯目錄會導致客戶端識別不到，必要時需重啓客戶端。
1、檢查或安裝 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安裝，可按官方文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本 Skill¶
將 Skill 安裝到當前環境對應的 skills 目錄（--dir 必填）。常用路徑示例：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝命令形式（包名以 SkillHub 座標爲準）：
skillhub install kunlungrowth/kunlun-pc-cleaner --dir ~/.cursor/skills/
也可把下面提示詞發給 AI，讓其按安裝文檔操作：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@kunlungrowth/kunlun-pc-cleaner`。
Cursor、Codex CLI、Claude Code 的差異主要體現在 skills 目錄路徑；安裝步驟本身均遵循 SkillHub 安裝與優先源配置。公開資料未單獨列出各客戶端的額外配置項時，無需臆造配置文件。
典型用法¶
公開頁面未附帶完整對話腳本，可復現的流程與官方簡介一致：
- 在已啓用該 Skill 的 Agent 中說明目標（例如：掃描用戶目錄下的緩存與大文件，先不要刪除）。
- 等待 Agent 完成 只讀掃描，閱讀生成的 回收報告（路徑、大小、類型、風險檔位）。
- 按報告勾選或指定批次，確認後讓 Agent 分批移入廢紙簍；未確認前不應執行移動。
- 若結果不符合預期，在系統廢紙簍中恢復文件（Skill 側承諾不硬刪，恢復依賴各 OS 廢紙簍機制）。
具體掃描範圍、風險分級規則與命令實現寫在 Skill 包內的 SKILL.md 中，安裝後由 Agent 按該文件執行。
適用場景與注意¶
適合誰
- 需要定期騰磁盤、又希望過程可審計、可分批確認的開發者。
- 在 macOS / Windows / Linux 多環境切換、希望 Agent 統一處理路徑差異的用戶。
- 不願把清理完全交給閉源一鍵工具、更希望「先報告再動手」的團隊。
限制與注意
- 能力邊界以 SkillHub 簡介爲準；未聲明的能力（例如未寫明的聊天附件場景）不要默認存在。
- 「絕不硬刪除」指 Skill 設計爲移入廢紙簍；仍應在每批執行前核對報告，重要數據先備份。
- 分類爲 it-ops-security，適合當作運維向輔助能力，生產機或共享服務器上使用前宜單獨評估權限與掃描範圍。
- 安裝、搜索、升級依賴
skillhubCLI 與網絡；沙箱或限網環境需放開相應權限。
結尾¶
電腦磁盤清理 把磁盤整理收成「只讀報告 → 風險分級 → 確認後入廢紙簍」的 Agent 工作流，面向重複文件、緩存、大文件、舊下載與截圖視頻等常見佔盤場景，並考慮三端路徑差異。需要安裝或更新時，以 SkillHub 頁面與安裝文檔爲準：
https://www.skillhub.cn/skills/kunlungrowth/kunlun-pc-cleaner
