DeepSeek Harness 插件：dsh-agentmonitor 多智能体监控面板

前言¶

DeepSeek Harness (DSH) 支持通过插件机制扩展功能。在开发或调试多智能体应用时，开发者通常需要一个可视化的面板来实时查看 Agent 的运行状态。dsh-agentmonitor 插件旨在解决这一需求，它通过在 DSH 侧边栏嵌入一个自包含的监控台，提供多智能体监控能力。

插件介绍¶

这是一个多智能体监控面板插件，由用户 Qianrushixiaobai 维护，采用 MIT 许可证。它通过 DSH 的 Web 服务器注入路由，并在客户端提供侧边栏入口，用于加载和展示监控仪表盘。

核心功能¶

• 双半结构设计：Host 半负责注入 DSH Web 服务器并注册 /agentmonitor 路由（同时支持精确匹配和前缀匹配）；Client 半负责在侧边栏提供入口，并在主区域通过 iframe 加载面板。
• 自托管静态仪表盘：插件随包发布静态面板（位于 dashboard/ 目录），无需额外构建即可开箱即用。
• 零外部依赖：除 DSH 自带环境及 Peer Dependencies 外，不依赖任何第三方库。
• 无绝对路径：配置项中不包含硬编码的机器绝对路径，便于在不同环境下部署。

安装与启用¶

插件必须安装在特定的 DSH Profile 下，并依赖 DSH Web 服务器运行。

dsh plugin --profile <name> add dsh-agentmonitor

执行上述命令后，重启 DSH，侧边栏将出现「监控台」入口。

典型用法：接入自定义数据¶

面板默认加载随包发布的静态示例数据。若需接入你自己的实时监控数据，需要进行如下配置：

1. 数据生产：让数据生产者定期（每 N 秒）输出一个 dashboard-data.js 文件，该文件需在全局作用域定义变量 window.AM_DATA。
2. 配置目录：在 profile 的 cordis.patch.yml 中配置 dataDir，指向包含 dashboard-data.js 的目录。

示例配置如下：

- id: agentmonitor
  config:
    dataDir: C:\path\to\your\dashboard-output

配置完成后，面板会自动每 3 秒拉取一次 dashboard-data.js 文件进行更新。

适用场景与注意¶

• 环境依赖：必须使用 DSH Web 服务器。
• 安装方式：必须使用 dsh plugin --profile <name> add 命令安装，不支持从 GitHub 直接拉取安装。
• 依赖检查：确保环境中已安装 Peer Dependencies，包括 @deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-connection、@deepseek-ai/dsh-client-ui-settings 以及 react。
• 安全建议：由于插件需注入 Web 服务器并涉及侧边栏渲染，建议在安装前检查源码与许可证。

总结¶

dsh-agentmonitor 为 DSH 用户提供了一个轻量级、无外部依赖的多智能体监控方案。它通过侧边栏集成，允许用户在不离开 DSH 环境的情况下查看 Agent 状态。插件详情请查阅：SkillHub 目录，源码位于：GitHub。