dsh-strata-monitor
在 DeepSeek Harness 里嵌入 Strata 模型服务器的状态监控面板。
A model-server monitor panel for DeepSeek Harness, mirroring the Strata server's Monitor tab.
功能 / Features
- 监控页 / Monitor page：侧边栏新增图标，展示模型状态（空闲 / 读取提示词 / 生成中 / 排队）、解码与预填充速度、GPU 负载、显存、温度、功耗、PCIe、CPU、磁盘读取（均带历史曲线）、会话缓存（KV cache 驻留/复用统计）、最近请求表与累计统计。
- 悬浮小窗 / Floating window：悬浮于所有页面之上的迷你状态窗，可拖动、右下角缩放，可在设置中开关。
- 输入框状态条 / Composer status line：对话输入框下方的单行迷你状态，可在设置中开关。
- 会话门控 / Session gate：小窗与状态条只在当前对话使用的模型与 Strata 报告的模型一致时出现；切换到其他模型时自动隐藏。监控页始终可用。
- 面板内配置 / In-panel settings：服务器地址与 API key 都可在面板右上角「设置」里修改，保存后立即生效，无需重启。
前置条件 / Requirements
- DeepSeek Harness（桌面版或 Web 版均可）。
- 一个正在运行的 Strata 服务器（提供
GET /health 与 GET /metrics，后者需要 Bearer API key）。
安装 / Install
方式一：插件市场（推荐）/ Via the plugin market (recommended)
在 Harness 的插件市场里添加自定义目录来源（catalog source），manifest URL 填：
https://raw.githubusercontent.com/Paidaxing-Tiancai/dsh-strata-monitor/main/catalog-source.json
添加后在市场中搜索 dsh-strata-monitor，点击安装即可。
Add this custom catalog source in the Harness plugin market, then search for dsh-strata-monitor and install:
https://raw.githubusercontent.com/Paidaxing-Tiancai/dsh-strata-monitor/main/catalog-source.json
方式二：手动 / Manually
在 Harness 的插件管理中安装本 bundle（clone 本仓库后选择该目录），或在对话里让代理执行：
plugin_manager install_bundle → 本仓库 clone 后的绝对路径
安装后刷新页面（Ctrl+R），侧边栏会出现「模型监控」图标。
配置 / Configuration
推荐直接在监控页右上角「设置」中填写：
- 服务器地址：例如
http://192.168.10.117:8080（保存后立即生效）。
- API key：Strata 的访问密钥。
也可以写在 profile 的 cordis.patch.yml 里（strata-monitor 行的 config.baseUrl / config.apiKey）。面板内保存的值写入
~/.dsh/profiles/<profile>/strata-monitor.json，优先级高于 yml 配置。
服务器地址与密钥在哪里 / Where to find the server URL and key
Strata 的地址与密钥写在它自己的启动配置文件里，通用路径为 ~/Strata/<配置名>.json
（例如 /home/<用户名>/Strata/strata-iq3_s.json）。文件里能看到监听地址/端口与 API key；
Strata 的网页本身不显示密钥，请从该文件复制。
The Strata server keeps its bind address and API key in its own launch config file, typically at
~/Strata/<profile>.json (e.g. /home/<user>/Strata/strata-iq3_s.json). The Strata web UI never
shows the key — copy it from that file.
安全 / Security
- API key 只保存在 Host 端本机的状态文件里，永远不会回传到浏览器。
- 浏览器只访问 Harness 自身的同源代理路由
/strata-monitor/health|metrics，由 Host 侧转发到 Strata，因此没有 CORS 问题，key 也不经过前端。
故障排查 / Troubleshooting
- 显示「未配置」/提示需要 API key：在「设置」里填入 key。
- 显示「无法连接 Strata 服务器」：检查服务器地址、Strata 是否在运行、防火墙。
- 更新插件后界面没变化：按 Ctrl+R 刷新页面（客户端模块在页面启动时加载）。
许可 / License
MIT，见 LICENSE。
