前言¶
用 DeepSeek Harness（DSH）跑智能体或长对话时，宿主进程和本机资源往往在同一台机器上：模型推理、工具调用、上下文缓存都会占用 CPU 和内存。若只能切到系统监视器或另开终端看 top，和 Web 对话界面是割裂的。dsh-system-hud 是 DSH 的 Web 客户端插件，把本机硬件状态嵌进对话顶栏、输入框底部和侧边栏，并在右侧提供「系统」详情，方便在同一窗口里对照负载与对话行为。
这是什么¶
dsh-system-hud（npm 包名 @ponydev/dsh-system-hud）由 PonyDevAI 维护，分类为客户端插件。它不改变 DSH 的模型或工具链，只在 Web UI 的三个原生位置展示真实采样的本机指标，并通过 Host 侧白名单命令采集数据；配置与快照不含凭据，远端访问时界面会显示「本机」而非具体主机名。
界面上的三个入口与右侧详情¶
下面按 README 中的区域说明插件在界面上的落点。
- 对话顶栏：两个小环加温度，与「会话日志 / 更多 / 账号」同一行；点击打开右侧「系统」详情。
- 输入框底部：与「轮次 · tok/s」「token · 缓存命中」、上下文环同一行，追加原生风格的 pill。
- 侧边栏底部：约 240px 卡片（CPU / 内存 / 磁盘 三个环，以及网络、I/O、温度），位于「每月限额」和「更多」之间；侧栏 footer 横向空间有限时，展开态可能用浮层锚在 footer 上方。
- 右侧「系统」详情：原生 tab，包含每核占用、内存与磁盘明细、约 60 秒网络、温度、Top 进程等。
指标在 macOS 与 Linux 上的支持与数据来源见仓库 README 中的特性表：CPU 走进程内 os.cpus() 差分；内存、磁盘、网络、I/O 走 vm_stat、df -k、netstat 或 /proc 等系统命令；Linux 温度可读 /sys/class/thermal；macOS 上若无免特权温度源则按设置策略处理（默认隐藏，不填 0）。采样分快层（约 1s）、慢层（5s）、Top 进程（30s）；页面不可见或未启用任何展示位置时会停止采样。
安装与启用¶
插件要求 DSH 版本 >=0.2.0-rc.2 且 <0.3.0，Node >=22.5。安装命令以 README 为准：
# CLI
dsh plugin --profile web add @ponydev/dsh-system-hud
也可在 Web「插件」页搜索安装。安装后需重启宿主并刷新页面，README 给出的 macOS 示例如下：
launchctl kickstart -k gui/$(id -u)/local.deepseek-harness.web
本地开发时可使用 link 安装（路径替换为实际目录）：
dsh plugin --profile web add link:/path/to/dsh-system-hud
设置与默认配置¶
安装后在 设置 → 系统 HUD 中可逐项开关三处展示位置、指标开关与排序、拿不到数据时的显示方式、采样周期与阈值。设置页顶部与其他 DSH 插件一致，提供 GitHub 链接、Issues、以及「检查更新」（查 npm 最新版；link: 安装时可能显示「尚未发布到 npm」）。
cordis.patch.yml 中的默认 Host 配置示例：
- insert:
- id: system-hud
name: "@ponydev/dsh-system-hud"
config:
fastMs: 1000
slowMs: 5000
topProcMs: 30000
regions: { header: true, dock: true, sidebar: true, rightPane: true, bottomBar: false }
运行时偏好持久化在 $DSH_HOME/system-hud/config.json（目录 0700、文件 0600），由设置页写回，Host 为唯一真相源。
典型用法¶
- 按上文命令安装并重启宿主、刷新 Web 页面。
- 打开 设置 → 系统 HUD，按需开启顶栏、输入框底部、侧栏底部与右侧面板相关区域。
- 在对话顶栏点击环或温度，或在有可见会话时打开右侧「系统」tab，查看每核 CPU、内存与磁盘、网络、Top 进程等；无会话时顶栏点击可能退化为浮层大卡（README 已知限制）。
- 若需验证 UI 而不依赖真机截图，维护者提供离线预览命令
npm run test-ui（需本机 Chrome），截图使用假数据，详见仓库docs/screenshots/MANIFEST.md。
适用场景与注意¶
适合经常在 DSH Web 里长时间调试智能体、希望对照本机负载而不离开对话窗口的开发者。插件 Host 端只执行写死白名单的系统命令（如 vm_stat、df -k、ps 等），带超时与输出上限；/system-hud/* 路由经 connection.admit 认证，未认证返回 401。插件以当前 DSH 进程权限运行，安装前建议阅读 GitHub 仓库 源码与 MIT 许可证，并知悉 macOS 26 温度、侧栏 footer 布局、Top 进程依赖 ps 等 README 列出的限制。
结尾¶
dsh-system-hud 把本机 CPU、内存、磁盘、网络、I/O 与温度（在平台支持时）收进 DSH Web 的原生 HUD 位置，数据来自 Host 侧受控采样而非前端臆造。社区目录页：PonyDevAI/dsh-system-hud；源码与完整说明：github.com/PonyDevAI/dsh-system-hud。
