Mombrane/dsh-subagent-monitor

Name: Mombrane/dsh-subagent-monitor
Author: Mombrane

插件Plugin 原生Native ⭐ 20 MIT cat_label.deepseek-harnesscat_label.deepseek-harness

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-subagent-monitor 是 DeepSeek Harness 的 Web 端插件，于界面右上角悬浮面板实时展示当前会话派生的全部子代理状态，支持运行中、完成、失败、已打断、令牌上限、已拒绝等多状态可视化与孙代树形缩进，并提供位置跨会话、高度按会话分别记忆的可拖动布局。适用于需要同时观察多个子代理进度的多代理编排场景。注意：其轮询路由仅面向回环地址、无鉴权，建议仅在本地或内网环境下使用。

dsh-subagent-monitor is a DeepSeek Harness web plugin that adds a floating top-right panel to track every sub-agent spawned in the current session in real time, covering running, completed, failed, interrupted, token-limit, and denied states with tree-indented grand-children cards and a draggable, memory-backed layout (position shared across sessions, height per session). Use it when orchestrating multiple sub-agents and needing live status visibility. Caveat: its polling endpoint is unauthenticated and loopback-only, so restrict deployment to local or trusted networks.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-subagent-monitor】【https://github.com/Mombrane/dsh-subagent-monitor】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add @leetoners/dsh-ui-subagent-monitor

把 Mombrane/dsh-subagent-monitor 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

8.7 KB · 缓存于 2026-08-25 04:54:34 · 8.7 KB

🤖 dsh-subagent-monitor

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

中文 | English

✨ 是什么

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

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

标题栏的「收起」为两段式：第一次只收起下方子代理卡片（顶部总览看板保留，按钮变「全部收起」）；再点一次才收起到只剩标题栏；「展开」一步恢复完整面板。

┌─ ⤢ 子代理看板 ───────────────── [收起 ▴] [✕] ┐
│  ◔ 上下文 ◔ 主会话 ◔ 子代理    █ 运行 1 · █ 完成 1 · █ 异常 0 │
│ ┌─────────────────────────────────────┐ │
│ │ 🔵 统计 ui 目录 TS 文件数   [打开对话] │ │
│ │    one-shot · 1a2b3c4d   运行中 · 00:42 │ │
│ │    ↑12.3k ↓4.5k · 缓存 78% · 上下文 45.6k │ │
│ └─────────────────────────────────────┘ │
│ ┌─────────────────────────────────────┐ │
│ │ 🟢 演示子代理：统计文件类型  [打开对话] │ │
│ │    spawn · 2b3c4d5e    完成 · 03:12  │ │
│ └─────────────────────────────────────┘ │
│  运行 1 · 完成 1 · 异常 0    [清空已完成] │
│ ════════════════════════════════════════ │ ← 拖动调整高度
└─────────────────────────────────────────┘

标题左侧 ⤢ 四角箭头拖动柄移动面板位置，底部 ═ 拖动柄调整面板高度；两者均记忆，双击复位。

「收起」两段式：第一次只收起下方子代理卡片（顶部总览看板保留），按钮变「全部收起」；再点一次收起到只剩标题栏；「展开」一步恢复完整面板。

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

🎯 特性

特性	说明
🟢 实时状态	运行中（🔵 蓝色像素追逐动画，与 DSH 侧栏状态点同款 + 秒表）、完成（绿点 + 光晕）、失败、已打断、令牌上限、已拒绝
🃏 卡片化列表	每个子代理一张圆角卡片；「打开对话」在右侧，状态与耗时在第二行
🔽 逐层查看	只显示当前会话直接派生的子代理；打开其中一项后可继续查看下一层
🔙 一键返回	进入子代理会话后，面板出现「← 上一层」按钮，跳回直接父会话
🖐 自由摆放	标题左侧四角箭头拖动柄移动面板，位置自动记忆（跨会话保留）；双击复位
📏 高度可调	底部拖动柄调整面板高度，高度按会话记忆；双击复位
🪗 两段式收起	标题栏「收起」第一段只隐藏子代理卡片、顶部总览看板保留；再点「全部收起」才收起到只剩标题栏；「展开」一步恢复
🔄 刷新自恢复	常驻组合，页面刷新 / 服务重启后自动恢复
📊 总体看板	面板顶部汇总条：三枚环形图（主会话上下文窗口当前占用、主会话 / 子代理缓存命中率）+ 状态柱状图（运行 / 完成 / 异常计数，按最大值等比缩放）
⚡ 用量明细	每张卡片显示该 run 的输入 / 输出 token、缓存命中率、累计上下文与上下文窗口利用率（provider 上报时）
🎯 当前占用	主会话「上下文」环显示当前窗口占用（`projectedTokens`：最新 prompt 样本 + 表层启发式增减），随内容新增而上升、压缩后立即回落——而非随会话只增不减的累计量
📱 移动端友好	≤768px 视口默认不弹出，侧栏按钮仍可手动打开

📦 安装

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

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

✅ 已发布 v0.3.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'）。

🏷️ 状态图例

状态	含义
🔵 运行中	正在执行，蓝色像素追逐动画（与 DSH 侧栏 tab 进行态同款）+ 实时秒表
🟢 完成	面板实时见证其成功结束，显示耗时（绿点 + 光晕）
⚪ 已结束	历史回填行：服务重启前创建，结局未观测（成功/失败未知）
🔴 失败	错误结束（红点 + 光晕）
🟠 已打断 / 令牌上限 / 已拒绝	被中止 / 达到 token 上限 / 请求被拒绝（琥珀点 + 光晕）

❓ FAQ

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

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

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

面板位置和高度会记住吗？ 会，且两者记忆策略不同：位置跨会话保留（所有会话共用同一位置）；高度按会话分别记忆（localStorage 键带会话 ID，切换会话互不影响）；刷新页面 / 重启浏览器后恢复；双击拖动柄恢复默认。

用量 / 缓存数据从哪来？ 从每个子代理自己的会话日志折叠 provider 上报的 TokenUsage（assistant/message 事件）；活会话读内存，冷会话读持久化日志并缓存。只有适配器上报用量时才有数据，否则显示「—」。

安全吗？ 轮询路由 /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.3.0（与 package.json 对齐）。

📖 架构文档

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

📄 License

MIT © Mombrane

渲染基于仓库 Mombrane/dsh-subagent-monitor 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install