前言¶
在本地跑大模型或长时间占用 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。