DeepSeek Harness (DSH) 插件：dsh-vitals

前言¶

DeepSeek Harness (DSH) 採用插件化架構，Web 界面通常需要查看底層資源佔用。傳統的命令行監控工具（如 btop）在 Web 側並不直觀。dsh-vitals 是爲 DSH Web GUI 提供的硬件負載監控插件，旨在提供類似 btop 的可視化體驗，讓用戶在不離開聊天界面的情況下實時查看 CPU、內存和 GPU 狀態。

插件概覽¶

名稱：dsh-vitals
維護者：JoblessJoe
許可證：MIT

該插件主要提供以下能力：
* CPU 監控：顯示總體利用率，以及每核心的負載情況（支持任意數量物理核心）。
* 內存監控：顯示已用、可用及總量，並計算使用率。
* GPU 監控：支持 NVIDIA GPU，顯示溫度、利用率、功耗和顯存使用情況。
* 界面集成：在會話標題欄提供迷你小組件，並在聊天視圖旁提供完整的 Hardware 標籤頁。
* 零依賴：無運行時依賴，安裝後直接可用。

安裝與啓用¶

安裝過程通過 DSH 的插件管理工具完成，無需手動編輯配置文件。

1. 確保你的 DSH 環境已安裝並配置好 Web profile（web）。
2. 執行以下命令將插件安裝到 Web profile 中：

    npx @deepseek-ai/dsh plugin --profile web add dsh-vitals

該命令會自動將插件添加到 `dsh.profile.bundles` 配置中。

安裝完成後，Web profile 會自動熱重載。無需重啓，只需刷新瀏覽器頁面即可看到插件效果。

使用方式¶

刷新頁面後，插件會自動在兩個位置顯示數據：

1. 會話標題欄迷你小組件

   • 在聊天界面頂部的會話標題欄（”⋯” 菜單附近）會出現一個小組件。
   • 它以短條形式顯示 CPU 和 GPU 的實時負載。
   • 交互：鼠標懸停可查看溫度和顯存信息；點擊小組件可跳轉到下方的完整 Hardware 標籤頁。

2. Hardware 標籤頁

   • 在對話視圖頂部，點擊 Hardware 標籤。
   • 該頁面展示詳細的硬件數據：
     • CPU：總體負載、60秒動態曲線圖、最高溫度、每核心負載（支持多熱區詳情）。
     • 內存：已用/可用/總量及利用率。
     • GPU：單張卡顯示名稱、溫度、利用率、功耗和顯存使用。

技術細節¶

• 數據獲取：插件通過一個獨立的 GET 接口（/plugins/dsh-vitals/data）讀取主機數據，該接口未受 DSH 服務器 /api 信任護欄的保護，因此啓用了跨站保護，僅接受 GET 請求。
• 平臺支持：
  • Linux：使用 /proc/stat、/proc/meminfo 和 nvidia-smi。
  • macOS：使用 os.cpus()、vm_stat 和 ioreg（注意：macOS CPU 溫度讀取通常需要 root 權限，插件會隱藏無數據的面板）。
  • Windows：使用 os.cpus()、os.freemem() 和 nvidia-smi.exe（需 PATH 或特定目錄）。
• 構建要求：雖然安裝使用的是預編譯包，但若需從源碼構建，需要 Node.js 20+ 環境，且無運行時 npm 依賴。

結語¶

dsh-vitals 是一個無需配置即可上手的系統監控插件，適合在本地模型推理時實時監控資源。更多關於兼容性或源碼構建的信息，請參考 GitHub 倉庫。