dsh-subagent-monitor

🤖 dsh-subagent-monitor

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

中文 | English ✨ 是什么

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

面板顶部是一块总体监控看板：左侧三枚环形图展示主会话的上下文窗口当前占用、主会话与子代理聚合的缓存命中率；右侧一根状态柱状图展示当前层子代理的运行 / 完成 / 异常计数（按最大值等比缩放）。每张卡片下方另附一行用量明细（该 run 的输入 / 输出、缓存命中、上下文大小）。

面板支持两个方向的收起，互不干扰： 纵向（两段式）：标题栏「收起」第一次只收下方子代理卡片（顶部总览看板保留，按钮变「全部收起」）；再点一次才收到只剩标题栏；「展开」一步恢复。 横向（向左折叠为窄栏）：标题栏 ◂ 把面板折成 120px 窄栏 —— 右边缘钉住不动，所以是朝左折；保留上下文与主会话两枚环（原大小 48px），由左右一排改为从上到下一列，去掉子代理环，下部继续保留子代理运行框（紧凑卡片）。▸ 向右展开回 340px。

横向收起后的窄栏（120px，两枚环原大小竖排）： 标题左侧 ⤢ 四角箭头拖动柄移动面板位置，底部 ═ 拖动柄调整面板高度；两者均记忆，双击复位。 「收起」两段式（纵向）：第一次只收起下方子代理卡片（顶部总览看板保留），按钮变「全部收起」；再点一次收起到只剩标题栏；「展开」一步恢复完整面板。 ◂ / ▸（横向）：向左折成 120px 窄栏 / 向右展开回 340px。窄栏保留上下文与主会话两枚环（原大小）竖排 + 子代理卡片；窄 / 宽选择跨会话记忆，刷新后保持。两个方向可叠加 —— 窄栏里照样能两级纵向收起。

🎯 特性 📦 安装 方式 A · npm 安装（推荐，一行命令） ✅ 已发布 v0.5.0（GitHub Actions 构建并签名，SLSA provenance 可验）。 方式 B · GitHub 直装

重启 dsh web 即生效。本仓库同时是 DSH 客户端插件（dsh.client）与 组合 bundle（dsh.bundle + cordis.patch.yml），并随附预构建 lib/。 方式 C · DSH 源码仓库内联（适合二次开发） 还需在 /tsconfig.client.json 的 references 中加入本包路径，并将本包 tsdown.config.ts 改为引用主仓预设（import { clientBundle } from '../tsdown.client.ts'）。 🧩 兼容性

DSH STORE 的自动复查只认 package.json 中完整 SemVer 的逐版本记录，宽泛范围不算可安装证据。本插件声明： 上表的 compatible 不是推断，是 2026-09-14 在一次性 Profile 上逐版本实测的结果：每个版本建独立 DSH_HOME → dsh plugin --profile web add（bundle 层成功合成）→ dsh web 启动后浏览器内面板正常渲染、GET /api/subagent-monitor/snapshot 返回 200 → dsh plugin --profile web remove 后该路由回到 404、bundle 层归零。未列出的 DSH 版本即 unknown。 🏷️ 状态图例 ❓ FAQ

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

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