前言¶

DSH 的理念是「一切皆插件」。在 DeepSeek Harness（DSH）Web GUI 中开发或调试时，经常需要看到本机 CPU、内存、磁盘、网络、负载、运行时长和 GPU 状态。dsh-sysmon 是面向 DSH 的插件，在 Web GUI 右下角提供一个小型悬浮窗，把本机系统性能信息集中展示出来。

这是什么¶

dsh-sysmon 由 21hbguo 维护，用于为 DSH Web GUI 提供系统性能看板。它分为 host 侧采集和 client 侧展示两部分：host 侧负责采集指标，client 侧用原生 DOM 渲染悬浮窗。该插件必须运行在 DSH 进程内，无法独立使用。

核心功能¶

下面介绍已核实的插件能力。

实时指标¶

• 实时展示 CPU、内存、磁盘、网络、负载、运行时长、GPU。
• 网络下行/上行速率分行显示，并按近期峰值自动缩放进度条。
• 悬停网络行时显示进程网络 TOP10；没有字节计数时，按活跃连接数降级显示。
• 磁盘多挂载点列出，并过滤 proc / sysfs / tmpfs 等虚拟文件系统。
• GPU 支持 AMD sysfs 与 NVIDIA nvidia-smi 采样；其他环境静默降级。

悬浮窗行为¶

• 支持拖动、折叠、隐藏悬浮窗。
• 窗口位置持久化到 localStorage。
• 页面不可见时轮询自动暂停，host 侧使用 cacheMs 缓存。

设置¶

• 提供 settings 命名空间 sysmon 的设置卡片。
• 可开关 enabled、调整 cacheMs。

安装与启用¶

前提¶

先确认已经有一个运行 DSH 的环境。若从源码构建，需要准备一份 DSH 源码检出（含 node_modules）；也可以使用 Release tgz。

源码构建后装配¶

源码构建后，将插件装配到 DSH web profile。插件目录需要是绝对路径：

dsh plugin --profile web add link:/absolute/path/to/dsh-sysmon

开发期热注入¶

开发期也可在 DSH 会话中热注入插件：

dev_inject_plugin /absolute/path/to/dsh-sysmon

典型用法¶

经过上面的装配，可以按下面的方式验证：

1、刷新 Web GUI 页面后，在右下角出现「性能」悬浮窗。

2、悬停 ↓下载 / ↑上传 行查看进程网络 TOP10 浮层。

3、点击标题折叠，拖动标题栏移动位置，× 隐藏后出现「性能」召唤按钮。

4、进入设置页 → 插件 → 系统性能看板，可开关 enabled、调整 cacheMs。

适用场景与注意¶

• 适合需要在 DSH Web GUI 中查看本机性能状态的使用者。
• 网络总速率、进程网络 TOP10、进程数仅 Linux 支持。
• GPU 仅 AMD sysfs 或 NVIDIA nvidia-smi 可用时显示；其他环境静默降级。
• 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
• 许可证资料存在冲突：README 标 BSD-3-Clause，package.json 标 MIT。
• 快照端点无鉴权（与 DSH Web 同源），请勿将 DSH 直接暴露到公网。
• 插件只采集系统指标，无遥测、无外联；localStorage 只存窗口位置与可见性。

链接¶

GitHub：https://github.com/21hbguo/dsh-sysmon