前言¶
DeepSeek Harness (DSH) 是智能體開發與運行的基礎設施。當宿主機出現內存溢出、CPU 佔用過高或進程異常時，直接排查往往效率較低。dsh-status-plugin 插件提供了宿主機層面的運行時健康監控能力，通過 HTTP 接口和 Web UI 雙向反饋，幫助開發者快速定位故障。
插件簡介¶
該插件由開發者 woshi-Tom 維護，採用 MIT 許可證。它是一個獨立的客戶端插件，同時提供了 Host Plane（服務端監控）和 Client Plane（前端展示）兩個層面，旨在通過標準化的數據接口和可視化的界面，降低 DSH 運行時的排查成本。
核心功能¶
插件的核心能力分爲監控採集、數據展示和實時反饋三個部分：
-
Host Plane（監控採集層）
通過 HTTP 端點將宿主機的運行時狀態暴露爲 JSON 格式。監控指標包括進程狀態、監聽器狀態、API Key 配置情況、內存使用、運行時間以及當前加載的插件清單。 -
Client Plane（數據展示層）
在 Web UI 中提供 Header 徽章，點擊可展開詳情面板。面板內會顯示運行時間，並在宿主機報告過載或內存壓力時觸發 Toast 警報。此外，插件提供了一個設置頁面，允許在運行時動態調整警報閾值。 -
實時反饋（Server-Sent Events）
支持 Server-Sent Events (SSE) 協議，向打開的瀏覽器流推送實時警報和狀態快照，確保監控數據的實時性。
安裝與啓用¶
安裝過程由 CLI 自動處理，無需手動配置 bundle 或 overlay。
1、執行安裝命令：
dsh plugin --profile web add dsh-status-plugin
2、停止當前運行的進程，並重新啓動 Harness 以加載插件：
dsh web
3、驗證插件是否正確加載：
dsh --profile web --dump-config
典型用法¶
安裝並啓動後，可以通過瀏覽器訪問 Web UI，或直接調用宿主機的 API 接口。
1、訪問狀態快照
通過 GET /api/status 獲取當前的宿主機狀態 JSON 快照。
2、查看監控指標
響應數據包含 host（主機信息）、webServer（服務端監聽配置）、apiKey（密鑰配置狀態）和 plugins（插件清單）等字段。
3、配置網絡暴露
默認情況下，lanAddresses 字段爲空數組。若需要在快照中包含局域網 IPv4 地址，需在配置中設置 exposeLanAddresses: true。
4、動態設置
插件在 0.4.0 及以上版本註冊了 dsh-status 設置命名空間。在 Web UI 的設置面板中，可以直接對 dsh-status 命名空間下的字段進行編輯，無需重啓 Harness 即可生效。
注意事項¶
- API Key 安全性：插件僅檢查 API Key 是否配置及其來源，絕不會在響應中泄露 Key 的具體值。
- 自動協調：CLI 會自動協調 bundles，無需用戶手動編寫 bundle 或 overlay 配置文件。
- 隱私保護：出於安全考慮，
lanAddresses默認關閉，請按需開啓。 - 適用場景：適用於需要對 DSH 宿主機進行實時健康檢查、故障告警或資源監控的場景。
結語¶
dsh-status-plugin 通過解耦監控採集與展示，爲 DSH 提供了輕量級的運維視角。開發者可以在遇到性能瓶頸或故障時，通過標準化的 JSON 接口快速獲取系統全貌。更多配置項與源碼，可參考插件目錄或GitHub 倉庫。
