前言¶

DSH 的理念是「一切皆插件」。在 DeepSeek Harness（DSH）Web GUI 中開發或調試時，經常需要看到本機 CPU、內存、磁盤、網絡、負載、運行時長和 GPU 狀態。dsh-sysmon 是面向 DSH 的插件，在 Web GUI 右下角提供一個小型懸浮窗，把本機系統性能信息集中展示出來。

這是什麼¶

dsh-sysmon 由 21hbguo 維護，用於爲 DSH Web GUI 提供系統性能看板。它分爲 host 側採集和 client 側展示兩部分：host 側負責採集指標，client 側用原生 DOM 渲染懸浮窗。該插件必須運行在 DSH 進程內，無法獨立使用。

核心功能¶

下面介紹已覈實的插件能力。

即時指標¶

• 即時展示 CPU、內存、磁盤、網絡、負載、運行時長、GPU。
• 網絡下行/上行速率分行顯示，並按近期峯值自動縮放進度條。
• 懸停網絡行時顯示進程網絡 TOP10；沒有字節計數時，按活躍連接數降級顯示。
• 磁盤多掛載點列出，並過濾 proc / sysfs / tmpfs 等虛擬文件系統。
• GPU 支持 AMD sysfs 與 NVIDIA nvidia-smi 採樣；其他環境靜默降級。

懸浮窗行爲¶

• 支持拖動、摺疊、隱藏懸浮窗。
• 窗口位置持久化到 localStorage。
• 頁面不可見時輪詢自動暫停，host 側使用 cacheMs 緩存。

設置¶

• 提供 settings 命名空間 sysmon 的設置卡片。
• 可開關 enabled、調整 cacheMs。

安裝與啓用¶

前提¶

先確認已經有一個運行 DSH 的環境。若從源碼構建，需要準備一份 DSH 源碼檢出（含 node_modules）；也可以使用 Release tgz。

源碼構建後裝配¶

源碼構建後，將插件裝配到 DSH web profile。插件目錄需要是絕對路徑：

dsh plugin --profile web add link:/absolute/path/to/dsh-sysmon

開發期熱注入¶

開發期也可在 DSH 會話中熱注入插件：

dev_inject_plugin /absolute/path/to/dsh-sysmon

典型用法¶

經過上面的裝配，可以按下面的方式驗證：

1、刷新 Web GUI 頁面後，在右下角出現「性能」懸浮窗。

2、懸停 ↓下載 / ↑上傳 行查看進程網絡 TOP10 浮層。

3、點擊標題摺疊，拖動標題欄移動位置，× 隱藏後出現「性能」召喚按鈕。

4、進入設置頁 → 插件 → 系統性能看板，可開關 enabled、調整 cacheMs。

適用場景與注意¶

• 適合需要在 DSH Web GUI 中查看本機性能狀態的使用者。
• 網絡總速率、進程網絡 TOP10、進程數僅 Linux 支持。
• GPU 僅 AMD sysfs 或 NVIDIA nvidia-smi 可用時顯示；其他環境靜默降級。
• 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
• 許可證資料存在衝突：README 標 BSD-3-Clause，package.json 標 MIT。
• 快照端點無鑑權（與 DSH Web 同源），請勿將 DSH 直接暴露到公網。
• 插件只採集系統指標，無遙測、無外聯；localStorage 只存窗口位置與可見性。

鏈接¶

GitHub：https://github.com/21hbguo/dsh-sysmon