前言¶
在 DeepSeek Harness（DSH）里长时间跑 Composer 或多会话并行时，机器负载是否偏高、显存是否顶满，往往要切到系统监视器或另开终端才能确认。上下文用量已有内置指示，但 CPU、内存、GPU 并不在同一视线内。dsh-dock-vitals 是 MM998LI 维护的客户端类插件：在 Composer 状态栏内置上下文计量器旁增加一块可点击徽标，周期性展示本机 CPU、内存与 GPU 占用，点击可展开详情；不向模型注册工具，采样数据也不进入对话上下文。
这是什么¶
dsh-dock-vitals（仓库 MM998LI/dsh-dock-vitals）定位为纯展示插件：只读系统指标并渲染 UI，不向模型暴露工具，样本不会写入会话上下文，也不会被发往外部服务。维护者为 MM998LI，社区目录页见 skillhub.cn/plugins/MM998LI/dsh-dock-vitals。DSH 生态强调「一切皆插件」；SkillHub 等目录为社区站点，与 DeepSeek / 幻方无官方从属关系。
状态栏示意（README 原文）：
2 turns 30 steps · 98 tok/s │ 1.8M tok · cache 84% │ 6%
CPU 13% MEM 87% GPU 15%
↑ this plugin's badge, right of the context meter
核心功能¶
三项指标与可选扩展¶
开箱展示 CPU、内存、GPU 三项。设置中可单独开关 CPU、内存、GPU；在 GPU 开启的前提下，可再打开显存与 GPU 温度（默认关闭）。
GPU 多平台后端¶
GPU 通过各平台只读 CLI 或注册表类接口探测，无需管理员权限。按平台依次尝试，先应答者生效，并会记住成功后端以便后续跳过无效路径。无法上报的字段在快照中为 null，界面留空而非显示 0。
| 平台 | 后端 | 说明 |
|---|---|---|
| Windows / Linux（NVIDIA） | nvidia-smi |
支持利用率、显存、温度等 |
| Windows（任意厂商） | PDH / typeperf |
AMD/Intel 在 Windows 上常用；单次约 2.7 s，无显存与温度 |
| Linux（AMD） | rocm-smi |
支持利用率、显存、温度等 |
| macOS | ioreg（IOKit） |
仅有占用相关读数，无总量 |
Windows 上 typeperf 较慢，因此 GPU 采样与徽标刷新解耦：CPU、内存按设定间隔更新，GPU 显示最近一次完成的读数。nvidia-smi 单次约 50 ms。
刷新与多会话共享¶
三种预设对应间隔：fast 1.5 s / medium 3 s / slow 10 s；设置里默认 3000 ms，可调范围 1500–60000 ms。打开多个会话时，所有徽标共享同一份快照与同一计时器，仍只采样一次。最后一个读者离开后约 15 秒自动停止采样。
详情面板与语言¶
点击徽标打开详情：各指标数值、GPU 型号、核心数、内存容量等；无法提供的行不展示。界面与提示跟随宿主语言（中文 / 英文）。
只读 HTTP 快照¶
宿主侧提供只读端点（非 loopback 返回 403）：
GET /dsh-dock-vitals/snapshot
响应 JSON 含 cpu、memory、gpu、gpuBackend、gpuError、host、intervalMs、updatedAt 等字段；gpuBackend 标明当前 GPU 读数来源，便于排查「GPU 为空或缺少温度」等问题。
安装与启用¶
安装前请自行查看仓库源码与 MIT 许可证；插件以当前 dsh 进程权限运行，会调用本机 nvidia-smi、typeperf、rocm-smi、ioreg 等，安装前应确认环境可接受。
要求（README / package.json）：dsh >=0.2.0-rc.1（在 0.2.0-rc.2 上开发验证），Node >=22；支持 Windows、macOS、Linux，桌面端与浏览器 GUI 均可（客户端 platform 为 web）。
在指定 profile 下添加插件：
dsh plugin --profile <profile> add dsh-dock-vitals
或安装本地打包文件（README 示例文件名）：
dsh plugin --profile <profile> add ./dsh-dock-vitals-0.1.0.tgz
安装后重启 DSH。
典型用法¶
- 安装并重启后，在 Composer 状态栏上下文计量器右侧应出现
CPU … MEM … GPU …徽标（可在设置中关闭「Enable badge」）。 - 打开 Settings → System Status（配置命名空间
dock-vitals）：按需开关 CPU / Memory / GPU、显存、GPU 温度，调整 Refresh interval；各项为volatile，改完即生效，无需重启。 - 负载异常时点击徽标查看详情；需要脚本或外部监控时，对本机发起
GET /dsh-dock-vitals/snapshot（仅 loopback）。
数据来源说明¶
| 指标 | 来源 | 说明 |
|---|---|---|
| CPU | Node os.cpus() 两次采样 |
整机 busy 比例（1 - Δidle/Δtotal），非单核；第一次采样无基线，读数为空 |
| 内存 | os.totalmem() / os.freemem() |
|
| GPU | 上表所列后端 | 全部不可用时 GPU 显示 —，CPU 与内存仍可用 |
适用场景与注意¶
适合在 DSH 内开发、调试智能体或长时间 Composer 对话时，不离开 IDE 观察本机资源是否成为瓶颈。不适合需要进程级剖析、历史曲线或远程机器监控的场景——本插件只做当前宿主上的轻量快照。
注意：纯展示、无模型工具；多会话共享采样以降低开销；Windows 非 NVIDIA GPU 可能走 typeperf，GPU 数字更新会明显慢于 CPU/内存。安装与启用前请阅读 GitHub 仓库 与许可证，并确认本机已安装对应厂商 CLI（若需 GPU）。
结尾¶
dsh-dock-vitals 把 CPU、内存与 GPU 读数放进 Composer 状态栏，点击可看详情，设置里可细粒度开关指标与刷新间隔，且 deliberately 不向模型注入任何工具或上下文。目录页：https://www.skillhub.cn/plugins/MM998LI/dsh-dock-vitals；源码与完整说明：https://github.com/MM998LI/dsh-dock-vitals。
