🤖 dsh-subagent-monitor

DeepSeek Harness (DSH) Web 扩展插件 · 子代理实时运行监视面板

✨ 是什么

在 DSH Web 界面侧栏底部加一个「子代理」入口，并在屏幕右上角常驻一块卡片式面板，实时展示当前会话派生的每一个子代理的运行状态。

┌─ 运行中的子代理 ──────────── [收起 ▴] [✕] ┐
│ ┌─────────────────────────────────────┐ │
│ │ 🔵 统计 ui 目录 TS 文件数   [打开对话] │ │
│ │    one-shot · 1a2b3c4d   运行中 · 00:42 │ │
│ └─────────────────────────────────────┘ │
│ ┌─────────────────────────────────────┐ │
│ │ 🟢 演示子代理：统计文件类型  [打开对话] │ │
│ │    spawn · 2b3c4d5e    完成 · 03:12  │ │
│ └─────────────────────────────────────┘ │
│  运行 1 · 完成 1 · 异常 0    [清空已完成] │
└─────────────────────────────────────────┘

运行中的子代理面板（运行中 / 已完成多状态同屏）

🎯 特性

特性	说明
🟢 实时状态	运行中（🔵 蓝色呼吸 + 秒表）、完成、失败、已打断、令牌上限、已拒绝
🃏 卡片化列表	每个子代理一张圆角卡片；「打开对话」在右侧，状态与耗时在第二行
🌲 树形缩进	孙代子代理卡片向右缩进
🔙 一键返回	进入子代理会话后，面板出现「← 主会话」按钮
🔄 刷新自恢复	常驻组合，页面刷新 / 服务重启后自动恢复
📱 移动端友好	≤768px 视口默认不弹出，侧栏按钮仍可手动打开

📦 安装

方式 A · npm 安装（推荐，一行命令）

dsh plugin --profile <your-profile> add @leetoners/dsh-ui-subagent-monitor

✅ 已发布 v0.1.0（GitHub Actions 构建并签名，SLSA provenance 可验）。

方式 B · GitHub 直装

dsh plugin --profile <your-profile> add github:Mombrane/dsh-subagent-monitor
# 首次安装若提示允许构建脚本，按提示在 profile 的 pnpm-workspace.yaml 中确认即可

重启 dsh web 即生效。本仓库同时是 DSH 客户端插件（dsh.client）与 组合 bundle（dsh.bundle + cordis.patch.yml），并随附预构建 lib/。

方式 C · DSH 源码仓库内联（适合二次开发）

# 1. 复制本仓库 src/ 为 <dsh>/packages/client/ui-subagent-monitor/
# 2. <dsh>/packages/bundle/web-app/package.json 加依赖
"@leetoners/dsh-ui-subagent-monitor": "workspace:*"

# 3. <dsh>/packages/bundle/web-app/cordis.patch.yml（ui-subagent 行之后）
- id: ui-subagent-monitor
  name: '@leetoners/dsh-ui-subagent-monitor'

# 4. 构建 + 重启
pnpm install && pnpm --filter @leetoners/dsh-ui-subagent-monitor bundle
# 重启 dsh web

还需在 <dsh>/tsconfig.client.json 的 references 中加入本包路径，并将本包 tsdown.config.ts 改为引用主仓预设（import { clientBundle } from '../tsdown.client.ts'）。

🏷️ 状态图例

状态	含义
🔵 运行中	正在执行，蓝色呼吸 + 实时秒表
🟢 完成	面板实时见证其成功结束，显示耗时
⚪ 已结束	历史回填行：服务重启前创建，结局未观测（成功/失败未知）
🔴 失败	错误结束
🟠 已打断 / 令牌上限 / 已拒绝	被中止 / 达到 token 上限 / 请求被拒绝

❓ FAQ

刷新页面会消失吗？ 不会。面板是组合中的常驻行，页面每次加载自动恢复。

「完成」和「已结束」有什么区别？ 🟢 是面板实时观测到的成功结局；⚪ 是服务重启前的历史记录，结局未观测。

面板有多大的容量？ 每个根会话最多保留 200 条，超出淘汰最旧的已结束行。

安全吗？ 轮询路由 /api/subagent-monitor/snapshot 面向回环地址、无鉴权，仅建议本地/内网使用。

🌐 生态收录

渠道	状态
GitHub topics	`dsh-plugin`、`deepseek-harness`（Oh-My-DSH 每 4 小时自动同步）
Oh-My-DSH 插件目录	PR #8 待维护者合并
awesome-dsh-plugin	✅ 已收录（commit `c7ad36e9`，PR #675 已合并）

📋 变更日志

完整变更历史见 CHANGELOG.md。当前版本 0.1.0（与 package.json 对齐）。

📖 架构文档

设计决策（为什么常驻、为什么自建轮询路由、事件归因模型）与数据流细节见 ARCHITECTURE.md。

dsh-subagent-monitor