前言¶
在本地跑大模型或長時間佔用 GPU 時,開發者往往需要在 Harness 界面旁同時盯着溫度、頻率和顯存佔用。切到 GPU-Z 或任務管理器會打斷工作流;把數值嵌進 Harness 又需要插件能跟 Web UI 主題一致、且不擋主界面操作。下面介紹社區插件 dsh-local-monitor:在 DeepSeek Harness 裏用一塊可拖拽的浮窗,集中展示 GPU-Z 與 Windows 側的 CPU、內存讀數。
這是什麼¶
dsh-local-monitor(倉庫 astelirons-ai/dsh-local-monitor)由維護者 astelirons-ai 發佈,在 SkillHub 目錄中歸類爲 admin-security。它面向帶 web profile 的 DeepSeek Harness:左側六張卡片對應 GPU 溫度、GPU 頻率、專用顯存(帶進度條);右側對應 CPU 溫度、CPU 頻率、系統內存(帶進度條)。窗口可拖動、可摺疊,位置在刷新後仍會記住,並跟隨 Harness 淺色/深色主題;標籤在應用或瀏覽器爲法語時爲法語,否則爲英語。
核心功能¶
資料中寫明的能力如下。
- 默認實時刷新:Host 側約每秒採樣一次,瀏覽器約每 1.5 秒拉取;狀態點區分 live 與 offline。
- GPU 數據來自 GPU-Z 共享內存:讀取 GPU-Z 發佈的
GPUZShMem塊,與 GPU-Z「Sensors」頁一致,不做 OCR 或截屏。 - 浮層不佔主區域點擊:通過
shell.overlay渲染,疊在整框之上,其它區域仍可正常操作。 - Host 側依賴輕:瀏覽器側用模塊表裏的 React;Host 側維持一個長期運行的 PowerShell 子進程採集數據。
- 數據源分工(README 表格):
- GPU 溫度、頻率、專用顯存、顯卡名稱:GPU-Z 共享內存;
- CPU 溫度:優先 GPU-Z 的 CPU 傳感器,否則 ACPI 熱區(界面可能顯示爲 motherboard zone,僅爲近似值);
- CPU 頻率與負載:Win32_PerfFormattedData_Counters_ProcessorInformation;
- 系統內存:GlobalMemoryStatusEx。
環境與要求¶
- Windows 10/11(採集腳本使用 Windows API)。
- GPU-Z 需保持運行(可從 TechPowerUp 安裝)。未運行時 GPU 列顯示 GPU-Z not found,CPU/內存列仍可用。
- DeepSeek Harness 已配置 web profile;
package.json要求 Node >= 20。
安裝與啓用¶
先從 GitHub 安裝到 web profile(命令來自倉庫 README):
dsh plugin --profile web add github:astelirons-ai/dsh-local-monitor
若使用本地目錄,則爲:
dsh plugin --profile web add link:D:\path\to\dsh-local-monitor
安裝後在 Web UI 執行 Ctrl+Shift+R 強制刷新。浮窗默認出現在框架右上角附近,可通過標題欄拖動。
卸載:
dsh plugin --profile web remove dsh-local-monitor
典型用法與數據路徑¶
無需額外配置即可使用:插件加載後瀏覽器輪詢 Host 路由,浮窗自動展示六張卡片。
數據流(README 示意圖)爲:GPU-Z 共享內存與 Windows CPU/內存指標進入 helper.ps1,每秒向 stdout 輸出一行 JSON;index.js 解析並暴露只讀接口;client.js 輪詢並繪製 overlay。
調試時可查看原始 JSON(README 示例,默認端口以你本機 Harness 爲準):
Invoke-RestMethod http://127.0.0.1:3080/dsh-local-monitor/sensors.json | ConvertTo-Json -Depth 5
路由 GET /dsh-local-monitor/sensors.json 僅接受 loopback 與同源請求。
可調參數¶
在 client.js 頂部可改窗口寬度與縱向密度:
var WIDTH = 372 // window width in CSS pixels
var VSCALE = 0.9 // vertical density: 1 = original height, 0.9 = 10% shorter
採樣間隔在 helper.ps1 的 $intervalMs = 1000;輪詢間隔在 client.js 的 POLL_MS = 1500。
常見問題¶
| 現象 | 處理 |
|---|---|
| 窗口不出現 | Ctrl+Shift+R;在 Settings → Plugins 確認插件已啓用 |
| GPU 列顯示 GPU-Z not found | 啓動 GPU-Z(可能在托盤最小化) |
| CPU 溫度標註 motherboard zone | 本機 GPU-Z 未提供 CPU 傳感器,改讀 ACPI 區 |
| 數值停住、狀態爲 offline | 確認 powershell.exe 可啓動且 GPU-Z 仍在運行 |
| 路由 404 | Host 半未加載,查 Host 日誌中的 dsh-local-monitor |
適用場景與注意¶
適合在 Windows 本機 使用 DeepSeek Harness Web UI、並已在後臺開着 GPU-Z 的開發者:本地推理、長時間 GPU 負載時,用同屏浮窗觀察溫度與顯存,減少切窗口次數。
安裝前建議自行閱讀倉庫源碼與 MIT 許可證(package.json 版本 1.0.0)。DSH 生態理念是「一切皆插件」;SkillHub 目錄頁 爲社區站點,與 DeepSeek / 幻方無官方從屬關係。插件在 當前 dsh 進程權限 下運行,會拉起 PowerShell 子進程並讀取本機傳感器與 GPU-Z 共享內存,安裝前應確認你可接受該行爲。
結尾¶
dsh-local-monitor 把 GPU-Z 與 Windows 性能/內存數據接到 Harness 浮層裏,用固定採樣與輪詢間隔保持讀數更新,並在 GPU-Z 缺席時仍保留 CPU/內存側信息。進一步說明與 issue 見 GitHub:https://github.com/astelirons-ai/dsh-local-monitor;目錄入口:https://www.skillhub.cn/plugins/astelirons-ai/dsh-local-monitor。