前言¶

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 查看详情。