前言¶
DeepSeek Harness (DSH) 採用插件化架構，方便擴展能力。在 Windows 環境下，C 盤空間不足通常不是因爲簡單的垃圾文件，而是緩存、索引、模型等本該放在別處的內容堆積。直接刪除 IDE 索引或虛擬磁盤會帶來重建成本甚至數據丟失風險。
dsh-windows-c-cleanup 插件通過「掃描 → 五級分級 → 生成報告 → 用戶確認 → 分層執行/遷移」的流水線，將清理變成一條可審計的操作鏈路。
核心功能¶
插件提供以下核心能力：
- 掃描：按規則庫和熱點目錄進行全盤掃描。
- 五級分級：將清理項分爲可安全刪除、謹慎刪除、建議遷移、保護名單、長期防護五級，並附帶判定理由。
- 可視化報告：生成 Markdown 或 JSON 格式的報告，展示釋放空間與趨勢。
- 分層執行：支持安全層批量執行與謹慎層逐項確認。
- 遷移與回滾：支持將緩存遷移至其他盤，並在原位置保留目錄聯接（junction），支持一鍵回滾。
- 歷史趨勢與 JSON 報告：記錄歷史掃描數據，對比空間變化。
- 定時掃描與告警：支持定時任務，在空間不足時觸發告警。
- Web GUI 面板：通過 Web 界面完成「看懂 → 勾選 → 預演 → 執行」的全流程。
安裝與啓用¶
推薦使用 npm 安裝，因爲自帶構建產物，無需本地編譯。安裝後需重啓 DSH 才能生效。
dsh plugin --profile web add dsh-windows-c-cleanup
若需釘住特定版本：
dsh plugin --profile web add dsh-windows-c-cleanup@0.5.2
典型用法¶
插件註冊了 disk_cleanup 工具，常用參數如下：
action：必填。scan（掃描）、apply（執行）、migrate（遷移）等。scope：hotspots（僅測熱點）或full（全盤 Top-N）。dryRun：默認true。預演模式，不實際刪除文件。grade：按層級選擇範圍（safe、caution、migrate）。
常見操作示例：
// 1. 掃描 C 盤
{ "action": "scan", "scope": "full" }
// 2. 安全層預演（不刪文件）
{ "action": "apply", "grade": "safe" }
// 3. 遷移到 D 盤
{ "action": "migrate", "items": ["C:\\Users\\..."], "targetDrive": "D" }
// 4. 永久刪除（需關閉 dryRun）
{ "action": "apply", "items": ["..."], "mode": "permanent", "dryRun": false }
適用場景與注意¶
適用場景：
* Windows 環境下 DSH 運行空間不足。
* 需要審計清理操作，避免誤刪關鍵文件。
* 希望將緩存遷移至其他盤以長期節省 C 盤空間。
注意事項：
* 插件不是「一鍵刪緩存」腳本，而是把清理拆成可審計的流水線。
* 安裝後必須重啓 DSH 才能加載。
* 遷移時目標盤必須與源盤不同，否則拒絕執行。
* 遷移操作會在原位置保留 junction 聯接，確保應用無感。
* dryRun 默認爲 true，執行前請務必檢查報告。
* GitHub 直裝需要構建審批，推薦直接使用 npm 安裝。
總結¶
該插件爲 DSH 在 Windows 環境下提供了標準化的磁盤管理能力。通過分級機制和遷移策略，用戶可以在保證安全的前提下，有效釋放系統盤空間。
