前言¶
DeepSeek Harness (DSH) 支持通過插件機制擴展功能。在開發或調試多智能體應用時,開發者通常需要一個可視化的面板來實時查看 Agent 的運行狀態。dsh-agentmonitor 插件旨在解決這一需求,它通過在 DSH 側邊欄嵌入一個自包含的監控臺,提供多智能體監控能力。
插件介紹¶
這是一個多智能體監控面板插件,由用戶 Qianrushixiaobai 維護,採用 MIT 許可證。它通過 DSH 的 Web 服務器注入路由,並在客戶端提供側邊欄入口,用於加載和展示監控儀表盤。
核心功能¶
- 雙半結構設計:Host 半負責注入 DSH Web 服務器並註冊
/agentmonitor路由(同時支持精確匹配和前綴匹配);Client 半負責在側邊欄提供入口,並在主區域通過 iframe 加載面板。 - 自託管靜態儀表盤:插件隨包發佈靜態面板(位於
dashboard/目錄),無需額外構建即可開箱即用。 - 零外部依賴:除 DSH 自帶環境及 Peer Dependencies 外,不依賴任何第三方庫。
- 無絕對路徑:配置項中不包含硬編碼的機器絕對路徑,便於在不同環境下部署。
安裝與啓用¶
插件必須安裝在特定的 DSH Profile 下,並依賴 DSH Web 服務器運行。
dsh plugin --profile <name> add dsh-agentmonitor
執行上述命令後,重啓 DSH,側邊欄將出現「監控臺」入口。
典型用法:接入自定義數據¶
面板默認加載隨包發佈的靜態示例數據。若需接入你自己的實時監控數據,需要進行如下配置:
- 數據生產:讓數據生產者定期(每 N 秒)輸出一個
dashboard-data.js文件,該文件需在全局作用域定義變量window.AM_DATA。 - 配置目錄:在 profile 的
cordis.patch.yml中配置dataDir,指向包含dashboard-data.js的目錄。
示例配置如下:
- id: agentmonitor
config:
dataDir: C:\path\to\your\dashboard-output
配置完成後,面板會自動每 3 秒拉取一次 dashboard-data.js 文件進行更新。
適用場景與注意¶
- 環境依賴:必須使用 DSH Web 服務器。
- 安裝方式:必須使用
dsh plugin --profile <name> add命令安裝,不支持從 GitHub 直接拉取安裝。 - 依賴檢查:確保環境中已安裝 Peer Dependencies,包括
@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-connection、@deepseek-ai/dsh-client-ui-settings以及react。 - 安全建議:由於插件需注入 Web 服務器並涉及側邊欄渲染,建議在安裝前檢查源碼與許可證。
總結¶
dsh-agentmonitor 爲 DSH 用戶提供了一個輕量級、無外部依賴的多智能體監控方案。它通過側邊欄集成,允許用戶在不離開 DSH 環境的情況下查看 Agent 狀態。插件詳情請查閱:SkillHub 目錄,源碼位於:GitHub。