前言¶
DeepSeek Harness (DSH) 採用插件化架構，擴展能力通過插件實現。在 Windows 環境下，C 盤空間管理是常見痛點。傳統磁盤清理工具往往只能執行“刪除緩存”這一種動作，對於早已廢棄的大體積軟件、誤放錯盤的數據（如 Docker WSL）、以及需要通過引導改址遷移的軟件配置，缺乏針對性的處理方案。
dsh-disk-manager 是一個 DSH Web UI 插件，旨在通過掃描整 C 盤，將文件/目錄分門別類，並針對不同類別給出差異化的操作建議（刪除緩存、引導改址、junction 搬家、提示廢棄、僅提醒），且對配置與記憶類數據設置安全紅線。
插件簡介¶
該插件由 wangzhanchao883 維護，屬於“聯網工具”分類。它不依賴複雜的構建流程，直接在 DSH 的 Web 界面中運行。核心邏輯包括掃描整 C 盤（排除 Windows 系統目錄）、基於靜態規則和 LLM 兜底進行分類、以及通過進程快照防止對常用軟件的誤判。
核心功能¶
插件將掃描結果分爲六類模型，每類對應不同的處理策略：
- A 類：無憂緩存（Cache/GPUCache/Temp 等）：可再生資源，可執行刪除或 junction 搬家。
- B 類：官方可改址（Docker/npm/pip/瀏覽器 profile）：支持引導改址到其他盤。
- C 類：可 junction 搬（如剪映、Notion 等純緩存）：支持通過 junction 命令遷移。
- D 類：冷廢棄軟件（大體積且超過 N 天未使用）：僅提示用戶，不執行刪除。
- E 類：配置/記憶紅線（包含 config/storage/indexeddb/memory/database/.openviking/.qclaw）：只展示，絕不自動執行。
- P 類：個人文件（Downloads/Documents/Desktop）：僅提醒大文件，絕不自動刪除或執行。
安全與兜底機制：
* LLM 兜底：未命中的未知目錄會使用 DSH 自帶的 LLM 進行判斷（默認關閉推理，按項目規則路由模型）。
* 進程快照防誤判：冷廢棄檢測邏輯已修正。通過快照當前運行進程並加入 Docker/WSL 等常用白名單，避免常用軟件因安裝目錄 mtime 不更新而被誤判爲廢棄。
* Dry-run 與 Undo：執行前提供預覽，且支持生成 undo 日誌以便回滾。
安裝與啓用¶
通過命令行安裝該插件：
dsh plugin --profile web add dsh-disk-manager
安裝完成後，重啓 DeepSeek Harness。在設置頁面會出現“C盤空間規劃整理大師”標籤頁；在對話窗口中，可以直接運行 /disk_scan 斜槓命令，或調用 disk_scan 工具。
首次使用時，需在設置頁或工具中選擇目標盤，配置會寫入 ~/.dsh-disk-manager/config.json。
典型用法¶
- 掃描：在設置頁點擊“開始掃描C盤”，或在對話中運行
/disk_scan。插件會掃描 AppData、用戶區、Program Files，排除 Windows 目錄。 - 查看結果：掃描完成後，報告會直接渲染在頁面中。你可以看到各個分類（A-P）下的具體文件/目錄列表。
- 預覽與執行：選中需要處理的條目，使用
disk_preview查看將要執行的操作（Dry-run），確認無誤後使用disk_execute真正執行。 - 撤銷：如果誤操作，可使用
disk_undo查看並執行回滾日誌。
注意事項¶
- 環境依賴：需要 Windows 系統（依賴 PowerShell 和系統原生 junction 能力）、Node.js ≥ 22，以及 DeepSeek Harness 0.1.7 ~ 0.2.x 版本。
- 安全紅線：E 類（配置/記憶）和 P 類（個人文件）具有最高優先級，無論 LLM 判定結果如何，系統都會強制將其設爲只讀展示，絕不能自動執行任何刪除或移動操作。
- 權限：插件以當前 DSH 進程的權限運行，執行刪除或 junction 操作前，請務必在預覽階段確認目標路徑。
總結¶
dsh-disk-manager 提供了一套結構化的 C 盤管理方案，通過分類模型替代一刀切的清理邏輯，並輔以 LLM 兜底和進程快照機制，降低了誤操作風險。對於需要精細管理本地存儲空間的 DSH 用戶，這是一個務實的工具選擇。
