dsh-workspace-hygiene：DeepSeek Harness 工作區衛生與工件價值評估插件

前言¶

在 DeepSeek Harness (DSH) 的使用場景中，長週期的任務會不斷產生日誌、代碼和中間文件。這些文件堆積在磁盤上，雖然不直接消耗 token，但會增加搜索空間，導致更多的工具調用、上下文噪聲和推理成本，最終降低推理性能。如何讓智能體自動管理這些中間產物，保持工作區清晰，是當前需要解決的問題。

dsh-workspace-hygiene 針對這三個問題：保留哪些文件、如何命名、如何組織，提供了初步方案。

插件定位¶

dsh-workspace-hygiene 是一個 DeepSeek Harness 插件，用於代理工作區衛生：工件價值評估、元數據索引和可審覈的清理。

維護者：taoshi1999
分類：工作流
許可證：MIT
核心價值：評估文件價值，提供目錄結構和命名建議，減少冗餘，提升後續檢索效率。

核心功能¶

插件主要解決工作區文件的生命週期管理問題：

工件價值評估：評估文件是核心任務材料、最終交付物、可複用中間結果、臨時調試記錄還是可丟棄的冗餘產物。
分類管理：將文件分類爲 保護 / 有價值 / 中間 / 可丟棄 / 不確定 五類。
兩種整理模式：
- 手動模式（默認）：後臺進程監控文件變更，點擊“整理工作區”生成計劃，用戶確認後執行。
- 自動模式：每次主 Agent 輪次結束後刷新評估。當掃描結果低於 cleanlinessThreshold（默認 80）時，向右側的 hygiene-Agent 提交建議。用戶可以生成詳細計劃或拒絕。未改變的建議會被抑制。
可視化與交互：
- 在 dsh web 中新增“工作區”標籤頁，左側展示目錄樹和分類，右側爲獨立的“hygiene-Agent”對話。
- 提供 CLI 工具 dsh-workspace-hygiene，用於評估文件價值並生成整理計劃。
可審計性：分離評估與行動，保留回滾能力，防止誤刪。

使用示例¶

在 dsh web 中查看與操作¶

進入 DSH Web 界面，在“軌跡”標籤頁後找到新增的“工作區”標籤頁。
左側展示當前會話工作區的目錄結構、文件分類（保護/有價值/中間/可丟棄/不確定）以及清潔度評分。
右側爲專屬的 hygiene-Agent 對話。在此處可以查看整理計劃、審覈文件動作或提出修改要求。
在頁面頂部切換“手動”或“自動”整理模式，選擇會保存在當前會話中。
點擊“整理工作區”，系統會生成整理計劃，確認後執行移動或刪除操作。

使用命令行工具¶

確保環境滿足依賴要求。
運行 dsh-workspace-hygiene 命令。
工具將掃描當前會話的工作區，評估文件價值，並輸出整理計劃。

環境與依賴¶

使用該插件需滿足以下條件：

Node.js 版本：需要 ^22.19.0 或 >=24.0.0。
DSH 依賴：需要 @deepseek-ai/dsh-tools，版本需滿足 >=0.1.1-rc.2 或 >=0.1.2-alpha.3。
傳輸協議：依賴 DSH 的 Connection RPC transport。
會話配置：需要會話 ID 來確定工作區根目錄。配置中可使用 workspaceRoot 錨定部署邊界。

總結¶

dsh-workspace-hygiene 通過系統化的評估與組織流程，幫助開發者保持工作區的整潔與可讀性，減少不必要的上下文噪聲，提升智能體在長任務中的推理效率。