前言¶
DeepSeek Harness (DSH) 是智能体开发与运行的基础设施。当宿主机出现内存溢出、CPU 占用过高或进程异常时，直接排查往往效率较低。dsh-status-plugin 插件提供了宿主机层面的运行时健康监控能力，通过 HTTP 接口和 Web UI 双向反馈，帮助开发者快速定位故障。
插件简介¶
该插件由开发者 woshi-Tom 维护，采用 MIT 许可证。它是一个独立的客户端插件，同时提供了 Host Plane（服务端监控）和 Client Plane（前端展示）两个层面，旨在通过标准化的数据接口和可视化的界面，降低 DSH 运行时的排查成本。
核心功能¶
插件的核心能力分为监控采集、数据展示和实时反馈三个部分：
-
Host Plane（监控采集层）
通过 HTTP 端点将宿主机的运行时状态暴露为 JSON 格式。监控指标包括进程状态、监听器状态、API Key 配置情况、内存使用、运行时间以及当前加载的插件清单。 -
Client Plane（数据展示层）
在 Web UI 中提供 Header 徽章，点击可展开详情面板。面板内会显示运行时间，并在宿主机报告过载或内存压力时触发 Toast 警报。此外，插件提供了一个设置页面，允许在运行时动态调整警报阈值。 -
实时反馈（Server-Sent Events）
支持 Server-Sent Events (SSE) 协议，向打开的浏览器流推送实时警报和状态快照，确保监控数据的实时性。
安装与启用¶
安装过程由 CLI 自动处理，无需手动配置 bundle 或 overlay。
1、执行安装命令：
dsh plugin --profile web add dsh-status-plugin
2、停止当前运行的进程，并重新启动 Harness 以加载插件：
dsh web
3、验证插件是否正确加载：
dsh --profile web --dump-config
典型用法¶
安装并启动后，可以通过浏览器访问 Web UI，或直接调用宿主机的 API 接口。
1、访问状态快照
通过 GET /api/status 获取当前的宿主机状态 JSON 快照。
2、查看监控指标
响应数据包含 host（主机信息）、webServer（服务端监听配置）、apiKey（密钥配置状态）和 plugins（插件清单）等字段。
3、配置网络暴露
默认情况下，lanAddresses 字段为空数组。若需要在快照中包含局域网 IPv4 地址，需在配置中设置 exposeLanAddresses: true。
4、动态设置
插件在 0.4.0 及以上版本注册了 dsh-status 设置命名空间。在 Web UI 的设置面板中，可以直接对 dsh-status 命名空间下的字段进行编辑，无需重启 Harness 即可生效。
注意事项¶
- API Key 安全性：插件仅检查 API Key 是否配置及其来源，绝不会在响应中泄露 Key 的具体值。
- 自动协调：CLI 会自动协调 bundles，无需用户手动编写 bundle 或 overlay 配置文件。
- 隐私保护：出于安全考虑，
lanAddresses默认关闭，请按需开启。 - 适用场景：适用于需要对 DSH 宿主机进行实时健康检查、故障告警或资源监控的场景。
结语¶
dsh-status-plugin 通过解耦监控采集与展示，为 DSH 提供了轻量级的运维视角。开发者可以在遇到性能瓶颈或故障时，通过标准化的 JSON 接口快速获取系统全貌。更多配置项与源码，可参考插件目录或GitHub 仓库。
