前言¶

DeepSeek Harness (DSH) 旨在爲智能體開發提供完整的環境支持。在多 GPU 場景下，開發者需要實時監控硬件狀態以調試性能瓶頸或顯存佔用。現有的監控方案通常需要額外的終端窗口或外部工具。dsh-gpu-pulse 是一個 DSH Web UI 插件，它將 nvidia-smi 的輸出直接渲染爲懸浮在頁面角落的條帶，提供每張 GPU 的實時狀態，無需額外服務。

插件簡介¶

dsh-gpu-pulse 是一個嵌入 DSH Web UI 的 GPU 監控組件。它通過調用宿主機的 nvidia-smi 工具，向客戶端提供每張顯卡的利用率、顯存使用量、溫度、功耗以及顯存佔用最高的進程信息。該組件由 zhubaohi 維護，採用 MIT 許可證。

核心功能¶

1. 實時數據展示：顯示每張 GPU 的利用率、VRAM、溫度和功耗。
2. 位置持久化：條帶可拖動，位置保存在瀏覽器本地存儲中，刷新或重啓後保持不變。
3. 進程監控：列出顯存佔用最高的進程（需驅動支持）。
4. 狀態指示：根據閾值顯示綠色、琥珀色或紅色狀態。
5. 基礎信息：顯示驅動版本和最後採樣時間戳。

安裝與啓用¶

1. 使用 DSH 插件命令安裝：

    dsh plugin --profile web add github:zhubaohi/dsh-gpu-pulse

2. 重啓 dsh web 服務。
3. 安裝完成後，條帶會出現在頁面右下角。你可以拖動它調整位置，雙擊可重置回默認角落。

配置說明¶

插件默認可用。如需調整監控頻率或行爲，可在配置文件中覆蓋參數。例如：

- id: dsh-gpu-pulse
  config:
    pollMs: 3000            # 輪詢間隔，默認 2000ms
    showProcesses: true     # 是否顯示顯存佔用最高的進程
    nvidiaSmiPath: 'nvidia-smi'  # nvidia-smi 路徑

適用場景與限制¶

• 環境要求：宿主機必須安裝 NVIDIA 驅動，且 nvidia-smi 在 PATH 中可用。
• 顯卡支持：僅支持 NVIDIA 獨立顯卡。Intel UHD 或 AMD 集成顯卡不會顯示。
• 依賴版本：需要 Node.js >= 18 以及 dsh web 0.1.0-rc.6+。
• 驅動限制：nvidia-smi 是隻讀工具。若未安裝驅動，界面會顯示 GPU n/a 並每 5 分鐘重試。

結語¶

該插件通過將監控工具集成到 DSH Web UI，減少了開發者切換窗口的負擔。通過 pollMs 和 showProcesses 等配置，可以適應不同的監控頻率和需求。項目源碼與文檔可在 GitHub 查看詳情。