前言¶
在 DeepSeek Harness（DSH）里跑对话时，模型往往由独立的 Strata 模型服务器承载。Strata 自带网页里的 Monitor 标签页能看 GPU、解码速度和请求队列，但切回 Harness 对话界面后，这些指标就不在眼前了。若你习惯在 Harness 里长时间调试或压测，需要一边改提示词一边确认服务器是否排队、显存是否打满，就得在两个窗口之间来回切换。
下面介绍社区插件 dsh-strata-monitor（维护者 Paidaxing-Tiancai，分类为客户端）：把 Strata 服务器 Monitor 页的能力嵌进 Harness UI，提供独立监控页、全局悬浮小窗和输入框下方状态条，并在本机通过 Host 代理拉取 /health 与 /metrics，避免把 API key 暴露到浏览器。
这是什么¶
dsh-strata-monitor 是面向 DeepSeek Harness 的 Strata 模型服务器监控面板插件，在 Harness 侧边栏增加「模型监控」入口，界面与 Strata 服务端 Monitor 标签页对应。桌面版与 Web 版 Harness 均可使用；前提是已有一个正在运行的 Strata 服务器，且能提供 GET /health 与 GET /metrics（后者需 Bearer API key）。
插件当前版本为 1.0.1，采用 MIT 许可证。社区目录页：SkillHub 插件条目；源码与说明：GitHub 仓库。
核心功能¶
监控页¶
侧边栏新增图标，打开后可查看：
- 模型状态：空闲、读取提示词、生成中、排队；
- 解码与预填充速度；
- GPU 负载、显存、温度、功耗、PCIe，以及 CPU、磁盘读取（均带历史曲线）；
- 会话缓存（KV cache 驻留/复用统计）；
- 最近请求表与累计统计。
监控页不依赖当前对话选用的模型，始终可用。
悬浮小窗与输入框状态条¶
- 悬浮小窗：叠在所有页面之上的迷你状态窗，可拖动，右下角可缩放；可在设置中开关。
- 输入框状态条（Composer status line）：对话输入框下方的单行迷你状态；可在设置中开关。
二者受 会话门控（Session gate） 约束：仅当当前对话使用的模型与 Strata 报告的模型一致时显示；切换到其他模型时自动隐藏。
面板内配置¶
服务器地址与 API key 可在监控页右上角「设置」中修改，保存后立即生效，无需重启 Harness。也可写在 profile 的 cordis.patch.yml（strata-monitor 行的 config.baseUrl / config.apiKey）；面板内保存的值写入 ~/.dsh/profiles/<profile>/strata-monitor.json，优先级高于 yml。
前置条件¶
- 已安装 DeepSeek Harness（桌面版或 Web 版）。
- Strata 服务器在运行，且暴露
GET /health与GET /metrics（metrics 需 Bearer API key）。
Strata 的监听地址与 API key 通常在其启动配置文件中，路径形如 ~/Strata/<配置名>.json（例如 /home/<用户名>/Strata/strata-iq3_s.json）。Strata 网页界面不展示密钥，需从该文件复制。
安装与启用¶
方式一：插件市场（推荐）¶
在 Harness 插件市场里添加自定义目录来源（catalog source），manifest URL 填：
https://raw.githubusercontent.com/Paidaxing-Tiancai/dsh-strata-monitor/main/catalog-source.json
添加后在市场中搜索 dsh-strata-monitor，点击安装即可。
方式二：手动安装 bundle¶
在 Harness 插件管理中安装本仓库 clone 后的 bundle 目录，或在对话里让代理执行：
plugin_manager install_bundle → 本仓库 clone 后的绝对路径
安装后刷新页面（Ctrl+R），侧边栏会出现「模型监控」图标。
典型用法¶
- 按上文任选一种方式安装插件并刷新页面。
- 打开「模型监控」，在右上角「设置」填写 服务器地址（例如
http://192.168.10.117:8080）和 API key，保存。 - 在监控页查看 GPU、速度与请求统计；若需要在对话时瞥一眼状态，在设置中开启悬浮小窗或 Composer 状态条（需当前会话模型与 Strata 报告模型一致）。
若更习惯用配置文件，可在 profile 的 cordis.patch.yml 中配置 strata-monitor 的 config.baseUrl 与 config.apiKey；面板保存会覆盖为 strata-monitor.json 中的值。
安全与代理路径¶
- API key 只保存在 Host 端本机状态文件中，不会回传到浏览器。
- 浏览器只访问 Harness 同源代理路由
/strata-monitor/health与/strata-monitor/metrics，由 Host 转发到 Strata，避免 CORS，且 key 不经过前端。
故障排查¶
| 现象 | 建议 |
|---|---|
| 显示「未配置」或提示需要 API key | 在「设置」中填入 API key |
| 显示「无法连接 Strata 服务器」 | 检查服务器地址、Strata 是否运行、防火墙 |
| 更新插件后界面无变化 | Ctrl+R 刷新（客户端模块在页面启动时加载） |
适用场景与注意¶
适合在 Harness 内长期调试、压测或运维 Strata 后端、又不想反复打开 Strata 网页 Monitor 的开发者。插件以当前 DSH 进程权限运行，安装前请自行审阅 仓库源码 与 MIT 许可证；DSH 社区插件目录（如 SkillHub）为独立生态站点，与 DeepSeek / 幻方无官方从属关系。
经过上面的步骤，你可以在 Harness 内直接对照模型状态与对话行为。更多细节见 GitHub README 与 SkillHub 目录页。
