前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在 Windows 環境下進行磁盤管理，通常面臨操作風險高、誤刪系統文件後果嚴重的問題。dsh-disk-cleaner 旨在解決這一痛點，爲開發者與用戶提供一套安全的磁盤空間分析與清理方案。
插件定位¶
名稱：dsh-disk-cleaner
維護者：L3n3L
分類：客戶端
許可證：MIT
插件圍繞“先看清，再決定”的原則設計，通過掃描、解釋、確認、清理和結果複覈建立完整流程。它默認保護系統目錄、應用目錄和用戶重要文件。
核心功能¶
插件提供以下能力：
- 空間總覽與分析：對 C 盤進行空間總覽，按分類（如臨時文件、緩存、日誌等）展示佔用情況。
- 智能識別：識別臨時文件、緩存、日誌和大文件。
- 建議說明：提供清理建議的原因、大小和風險說明。
- 安全預覽：清理前提供預覽功能，用戶需確認後方可執行。
- 白名單校驗：通過白名單路徑校驗，優先使用回收站或隔離區。
- 結果反饋：展示清理進度、跳過原因及最終結果報告。
- 歷史記錄：提供可撤銷的清理歷史，防止誤操作。
當前狀態與安全原則¶
目前該插件倉庫已創建，正在搭建掃描器、規則引擎和 Web 工作臺。刪除能力將在安全邊界和測試完善後開放。
安全設計遵循以下原則：
- 確定性規則：AI 負責解釋和推薦，但確定哪些文件可以處理的必須是確定性的規則和白名單。
- 默認保護：不默認刪除任意路徑。
- 隱私安全：不會把用戶文件上傳到外部服務。
安裝與啓用¶
該插件作爲 DSH 的一個模塊存在，依賴於 @deepseek-ai/cordis。安裝時需確保滿足 peer dependencies 要求（Node.js >= 22, @deepseek-ai/cordis ^4.0.1）。
DSH 通過配置文件引入插件。根據 package.json 中的配置，插件通過 dsh.bundle.patch 字段進行集成。具體啓用方式需參考 DSH 的標準插件加載機制。
典型用法¶
使用流程主要包含以下步驟：
- 啓動掃描：插件啓動掃描器，分析 C 盤空間佔用。
- 查看分類：通過 Web 工作臺查看各分類的佔用詳情。
- 預覽與確認：查看具體的文件列表、大小及風險說明，確認清理項。
- 執行清理：在確認後，插件利用確定性規則執行清理，並優先移至回收站或隔離區。
- 查看報告：清理完成後，查看進度、結果及可撤銷的歷史記錄。
適用場景與注意¶
- 適用場景：C 盤空間不足，需要安全地清理臨時文件、緩存或日誌；需要了解磁盤佔用結構的開發者或用戶。
- 注意事項：
- 插件以 DSH 進程權限運行，請確保信任源碼。
- 目前刪除能力尚未完全開放，部分清理操作可能處於測試階段。
- 安裝前請檢查源碼與許可證（MIT）。
總結¶
dsh-disk-cleaner 提供了一套安全、可控的 Windows 磁盤管理方案。它通過白名單機制和可撤銷歷史，降低了誤刪風險，適合需要在 DSH 環境中集成磁盤清理功能的開發者使用。
