dsh-agentmonitor

Readme

# dsh-agentmonitor

把 AgentMonitor 多智能体监控台作为面板嵌入 DeepSeek Harness Desktop / DSH Web，
在侧边栏提供「监控台」入口。

## 特性

- **Host 半**（`lib/index.js`，node 进程）：
  - `inject: ['webServer']`，仅依赖 DSH 自带 webserver；
  - 注册 `/agentmonitor`（精确）+ `/agentmonitor/`（前缀）路由；
  - 默认自托管**随包发布的静态面板**（`dashboard/`），开箱即用。
- **Client 半**（`lib/client.js`，浏览器）：侧边栏「监控台」入口 + 主区 iframe
  加载 `/agentmonitor/` 面板。
- **零外部依赖、无机器绝对路径**，可被任何 DSH 用户 `dsh plugin add` 安装。

## 安装

```sh
dsh plugin --profile <name> add dsh-agentmonitor
# 重启后，侧边栏出现「监控台」
```

> npm 安装无需构建授权（预构建产物已随包发布）。

## 接入你自己的实时数据

面板默认展示随包提供的静态示例数据。要接入你自己的监控数据：

1. 让数据生产者每 N 秒输出一个 `dashboard-data.js`（定义全局 `window.AM_DATA`）。
2. 把插件配置项 `dataDir` 指向该目录：
   ```yaml
   # 这里是你在 profile 的 cordis.patch.yml 中的写法示意
   - id: agentmonitor
     config:
       dataDir: C:\path\to\your\dashboard-output
   ```

面板会每 3 秒重新拉取 `dashboard-data.js`。数据字段契约（`cards` / `events` /
`project_nav` 为预渲染 HTML 片段）参见 `dashboard/dashboard-data.js` 里的示例。

## 开发

```sh
npm run verify   # 语法校验 lib/index.js 与 lib/client.js
```

## 目录

```
dsh-agentmonitor/
├── package.json          # name / exports / dsh.client.inject
├── cordis.patch.yml      # bundle patch：插入 agentmonitor 插件行
├── lib/
│   ├── index.js          # host 半：/agentmonitor 静态路由
│   └── client.js         # client 半：侧边栏入口 + 主区 iframe 面板
├── dashboard/            # 随包发布的静态面板（自包含）
│   ├── dashboard.html
│   └── dashboard-data.js # 示例数据
├── LICENSE               # MIT
└── README.md
```