前言¶
在 DeepSeek Harness 里长时间跑智能体或本地任务时，往往要同时盯着任务管理器或第三方监控工具，才能判断是 CPU、GPU 还是内存顶住了。窗口来回切换会打断调试节奏。下面介绍的 dsh-perf-hud 把占用率与可选温度读数直接叠在 Harness Web 界面上，数据只在本机采集与展示，不依赖外置监控窗口。
这是什么¶
dsh-perf-hud（仓库 ChendarCe/dsh-perf-hud）由维护者 ChendarCe 发布，在 SkillHub 插件目录 中归类为客户端插件。它在 Harness 窗口内部渲染一块完全透明的性能 HUD：三行文字显示 CPU、GPU、内存占用，并在安装可选助手后显示 CPU 封装温度；GPU 温度仅在显卡暴露温度传感器时才有读数，否则显示 —。
与独立桌面置顶小工具不同，该卡片浮在 Harness 内容之上，随 Harness 窗口缩放与最大化，松手后吸附到最近的窗口角，便于边用边观察本机负载。
核心功能¶
指标与数据来源¶
插件约每秒刷新一次，各指标来源如下（与 README 一致）：
| 指标 | 来源 |
|---|---|
| CPU 占用 | node:os 的 CPU 时间差分 |
| 内存占用 | os.totalmem() / os.freemem()，与任务管理器「使用中」同类定义 |
| GPU 占用 | Windows GPU Engine 性能计数器中最繁忙引擎（与任务管理器一致） |
| CPU 温度 | 可选助手：LibreHardwareMonitor 的 CPU Package 传感器 |
| GPU 温度 | 仅当 GPU 提供温度传感器；多数核显无独立传感器，显示 — |
界面与交互¶
- 透明叠层：无卡片底色与边框，文字带柔和光晕，便于压在任意界面内容上阅读。
- 拖动与锚点：可拖到任意位置，松手后锚定到最近窗口角；最大化、还原或改窗口大小时保持相对位置。
- 快捷操作：双击回到右上角；方向键微调；悬停右侧箭头可收成单行。
- 负载配色：占用率 ≥70% 琥珀色、≥90% 红色；温度 ≥78 °C / ≥88 °C 同理；读数过期时整卡变暗，避免闪出虚假的 0。
- 主题：仅使用
--dsw-alias-*设计令牌，跟随 Harness 浅色、深色及自定义主题。
本地与安全边界¶
指标由插件提供的本机路由响应；仅接受 loopback、同源请求，其他来源返回 403。README 明确说明不上传监控数据。
安装与启用¶
环境要求：
- Windows 10/11（GPU 计数器、PowerShell 工作逻辑与温度助手均为 Windows 专用）。
- 已安装带 Web UI 的 DeepSeek Harness。
在 Harness 的插件页从 GitHub 或本地文件夹安装，或在终端执行官方命令：
dsh plugin add ChendarCe/dsh-perf-hud
安装后重新加载界面一次即可看到 HUD。package.json 中客户端配置为 platform: "web"、immediately: true，并注入主题与 locale 相关依赖，一般无需额外配置文件。
插件以当前 dsh 进程权限运行；安装前建议在 GitHub 查看源码与 MIT 许可证，确认符合你的安全策略。
典型用法¶
仅看占用率（默认）¶
不装温度助手时，HUD 即可显示 CPU / GPU / 内存三行占用；温度格为 —。适合快速确认 Harness 会话是否把 GPU 或内存打满。
可选：CPU 封装温度¶
需要真实 CPU 封装温度时，在仓库内以管理员身份运行一次：
helper\setup.cmd
该脚本会下载并配置：
- LibreHardwareMonitor 0.9.6（便携、库模式）读取传感器；
- PawnIO 2.2.0 签名内核驱动，在开启 Windows「内存完整性」(HVCI) 时仍可读 MSR，无需关闭该安全选项；
sensor-helper.ps1，约每 0.4 s 写入一小份 JSON；- 计划任务
DSH Perf Sensor（登录时、最高权限、无窗口），之后不再弹窗申请权限。
文件默认落在 D:\DSHTools（若存在 D 盘），否则为 %LOCALAPPDATA%\DSHTools；插件会读取这两个位置之一。
README 在 8 核笔记本上测得助手开销约为单核 0.08% CPU、约 87 MB 内存，主要等待驱动而非持续占满 CPU。
移除助手：
helper\uninstall.ps1 # 停止任务并卸载驱动
helper\uninstall.ps1 -RemoveFiles # 并删除助手文件
适用场景与注意¶
适合：在 Windows 上用 Harness 做本地智能体开发、长任务调试，希望不离开当前窗口就能看到与任务管理器一致的 CPU / GPU / 内存占用，并可选查看 CPU 封装温度。
限制与注意（来自官方文档）：
- 仅 Windows；Linux / macOS 不适用。
- HUD 在 Harness 窗口内部，不是独立的桌面 always-on-top 窗口。
- Intel 核显通常无独立 GPU 温度传感器，GPU 温度格常为
—；可参考同 die 的 CPU 封装温度。 - 温度助手涉及管理员权限、第三方驱动与计划任务；不需要温度时应使用
uninstall脚本清理。 - 社区目录 SkillHub 为独立生态站点，与 DeepSeek / 幻方无官方从属关系；插件星标以目录页为准（当前为 0），功能以仓库 README 为准。
结尾¶
经过上面的步骤，你可以在 Harness 里用一块透明、可拖动的 HUD 盯本机性能，并按需用 helper\setup.cmd 补上 CPU 温度。更多细节与预览图见 GitHub README，安装入口亦可从 SkillHub 目录页 跳转。
