DeepSeek Harness (DSH) 在運行過程中會不斷積累數據，但由於 DSH 的設計原則是不主動刪除文件，磁盤佔用只會增長。面對日益膨脹的存儲空間，開發者需要一種能夠看清佔用構成、且不會誤刪重要數據的解決方案。
dsh-disk-doctor 是爲此設計的 DSH 插件。它提供只讀的磁盤佔用統計，將數據、程序和系統緩存分開計算，並提供一種“只移不改”的清理機制。
插件介紹¶
dsh-disk-doctor 是由 Yeqij 維護的 DSH 空間體檢插件。它通過讀取文件系統狀態，分析 DeepSeek Harness 的磁盤佔用情況，並提供可視化的右側欄面板與安全清理功能。
核心功能¶
三區並排統計
插件將磁盤佔用劃分爲三個區域：DSH 數據文件夾、DSH 程序安裝、系統緩存（包括桌面用戶數據和 pnpm 內容倉庫）。這三者在物理字節上存在重疊（例如 pnpm 倉庫通過硬鏈接指向插件文件），直接相加會造成重複計數。該插件會分開計數，並說明重疊原因。
路徑自動探測
插件支持多種路徑探測方式：
* 數據目錄跟隨 $DSH_HOME（回落至 ~/.dsh）；
* 程序安裝目錄從運行中的可執行文件探測，且必須真的存在 resources/app.asar 纔會被識別；
* 系統緩存從 %APPDATA% / %LOCALAPPDATA% 探測，並有 .config 與 Library/Application Support 回落；
* 同時支持 npm 全局安裝的 DSH 實例。
右側欄常駐面板
安裝後，插件會在 DSH 右側欄顯示常駐面板，支持按分類、Top N 排序，以及按插件或聊天記錄切換視圖。每行提供“在文件管理器中打開”的功能。
安全清理機制
插件從不執行刪除操作。所有清理功能默認關閉，需二次確認。清理時僅執行 renameSync，將文件移動到插件隔離目錄 <dshHome>/disk-doctor/quarantine/<時間戳>/。每次移動都會重寫清單，確保即使中途斷電也能與磁盤狀態一致，且支持一鍵撤銷。
安全與隱私
* 無網絡訪問：插件在清單中聲明 network: []，並經過測試確保無出站調用。
* 報告脫敏：離開機器的輸出（如 Markdown 或 JSON 報告）會將主目錄替換爲 ~，僅本地面板顯示真實路徑。
安裝與使用¶
前置要求
* DeepSeek Harness 版本：>=0.1.0-rc.2（實測 0.2.0-rc.2）。
* Node.js 版本：^22.19.0 或 >=24.0.0。
安裝方式
由於該插件未發佈到 npm，需通過以下方式安裝：
- 直接使用倉庫地址：
dsh plugin --profile <profile> add https://github.com/Yeqij/dsh-disk-doctor
- 使用打包好的 tgz 文件：
dsh plugin --profile <profile> add https://github.com/Yeqij/dsh-disk-doctor/releases/download/v0.1.0/dsh-disk-doctor-0.1.0.tgz
- 或下載源碼，在 DSH 插件管理中添加本地文件夾路徑，然後重啓 DSH。
測試
安裝後可運行測試驗證功能：
npm test
測試覆蓋 177 項，包含 locate、scan、plugin 和 client 四個模塊。
注意事項¶
- 統計只會增長：DSH 本身不刪除文件，因此插件的統計數字是累積的。
- 程序目錄探測：程序安裝目錄的探測依賴
resources/app.asar真實存在，無頭環境部署會如實報錯。 - 無構建依賴：插件零運行時依賴、零構建步驟。
- 清理默認關閉：爲防止誤操作，清理功能默認關閉，需手動開啓並二次確認。清理僅針對“可安全清理”的四類文件。
結語¶
dsh-disk-doctor 解決了 DSH 磁盤佔用不透明與清理風險並存的問題。通過隔離區重命名實現的安全清理機制，適合需要在本地長期運行 DSH 的開發者使用。
