前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在智能體開發流程中，開發者經常需要持續監測本地工作區的文件變化，以觸發構建、部署或代碼審查等後續邏輯。dsh-workspace-monitor 旨在爲 DSH 提供一種輕量級的、基於命令行的文件狀態監測方案，替代手動輪詢或複雜的腳本邏輯。
這是什麼¶
這是一個由 Rainier-Z 維護的命令驅動型監測插件。它允許用戶通過自然語言指令在當前會話中創建和管理多個獨立的監測任務，每個任務都擁有獨立的 taskId、工作區路徑、掃描基線和運行狀態。
核心功能¶
- 自然語言操作：無需編寫複雜指令，通過對話即可管理監測任務。
- 多任務併發：同一個會話可以同時創建多個監測任務，互不干擾。
- 狀態獨立：每個任務擁有獨立的
taskId、工作區、掃描基線和運行狀態。 - 可配置掃描：默認每 60 秒掃描一次，支持在運行時動態修改掃描間隔（如改爲每分鐘）。
- 摘要報告：創建任務時會靜默建立基線，不發送首輪通知。後續每輪掃描都會輸出摘要，明確列出新增、修改和刪除的文件；未發現變化時也會明確報告“無變化”。
- 元數據掃描：掃描僅讀取文件元數據（如修改時間、大小），不讀取文件內容，也不寫入被監測工作區。
- 默認忽略：默認忽略
.git、node_modules和.dsh-workspace-monitor目錄，減少噪音。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile desktop add dsh-workspace-monitor
典型用法¶
安裝完成後，在當前會話中直接使用自然語言指令即可操作：
- 開始監測當前工作區
- 列出監測（僅列出當前會話擁有的任務）
- 把
<taskId>改爲每分鐘 - 停止監測
<taskId> - 繼續監測
<taskId>
適用場景與注意¶
該插件適合需要持續跟蹤工作區文件變更的 DSH 開發者。
- 持久化與容錯：任務歸屬於當前會話的
sessionId，不依賴某一個暫時存活的 Agent 實例。Agent 忙碌或暫時不可用時，報告會保留並在後續重試。舊版本遺留的restart_requires_confirmation或agent_disposed系統暫停原因會在啓動時自動遷移爲ACTIVE。 - 權限與安全：插件以當前進程權限運行，請確保安裝來源可信。側邊任務欄集成功能尚未實現。
- 本地驗證：如需在本地驗證插件代碼，可執行：
npm test
npm run check
npm run pack:check
總結¶
dsh-workspace-monitor 爲 DSH 提供了高效的工作區狀態感知能力，適合需要精細控制文件監測邏輯的場景。相關源碼與文檔可在以下地址查閱：GitHub | 社區目錄。
