会话雷达 marksimZ/dsh-session-radar

dsh-session-radar

DeepSeek Harness 插件，用一个小药丸控件在框架右上角显示你的各个会话正在发生什么：

● 1 等审批 · 1 运行中 · 1 失败

点击它展开列表；点击某一行切换到对应会话。没有正在运行、等待或失败的会话时，控件完全不渲染。

┌────────────────────────────────────────────┐
│ 会话雷达 4 个活动 │ │ ⏸ 修复登录 等审批 · bash · +1 │ │ ● 重构余额插件 运行中 · 12m +1 子代理 │ │ ● （未命名） 失败 · 1m │ │ ✓ 调研压缩 完成 · 2m │ └────────────────────────────────────────────┘

显示内容

| 状态 | 含义 | 来源 |
| 等审批 | 会话有等待处理的审批（徽标显示工具名和额外数量） | approval/asked、approval/decided |
| 运行中 | 有回合未结束，或该根会话仍有子代理在运行 | turn/start、turn/end |
| 失败 | 上一个回合以 error 原因结束 | turn/end.reason.kind |
| 完成 | 在 recentMs 内结束（默认 30 分钟） | turn/end |
| 子代理 | +N 子代理 徽标统计运行中的子会话 | session.header.parentSession |

- 标题来自持久化的 session/title 事件，不涉及读取投影。
- 子代理会话聚合到所属根会话行，不会挤乱列表。
- 排序是刻意设计的：等审批优先，然后是运行中、失败、完成——每组内按最新在前。

环境要求

- DSH 客户端需组合客户端 uiWorkspace 服务（用于切换会话）和 webServer（Host 路由）。Desktop 客户端和 dsh web 都满足。
- 只有测试/安装脚本需要 Node 20+；插件没有构建步骤。

安装

git clone https://github.com/marksimZ/dsh-session-radar.git dsh-session-radar
dsh web --patch /absolute/path/to/dsh-session-radar/cordis.patch.yml
or permanently:
node scripts/install.mjs --dry-run
node scripts/install.mjs
node scripts/verify-deployed.mjs --url http://127.0.0.1:<GUI 端口>

配置

| 键 | 默认值 | 含义 |
| widgets.radar | true | 注册药丸控件和面板 |
| recentMs | 1800000 | 已结束会话在列表中保留多久 |
| maxRows | 8 | 最多发布的行数 |
| pollMs | 2000 | 浏览器轮询间隔（Host 提示） |

架构

Host half (src/index.ts)
ctx.on('session/event')
session/title → the row title
turn/start, turn/end → running state and the ending reason
approval/asked|decided → the pending badge
session.header.parentSession → sub-agent aggregation
├─ GET /dsh-session-radar/state → rows + counts, ordered and capped
└─ globalThis.__DSH_SESSION_RADAR_CONFIG__ → widget switch and poll hint

Browser half (src/client.js)
shell.overlay (list seat, replaceRisk: none) → pill + panel
ctx.uiWorkspace.openSession(id) → row click switches session
为什么用 shell.overlay？ 它是一个横跨整个框架的列表位置，replaceRisk: none，所以新的 id 会与已发布的 overlay 条目并列，而不是替换其中一条。胶囊用 var(--dsh-frame-overlay-top, 44px) 定位，这样它就能保持在 Windows 标题栏和 macOS 红绿灯按钮下方。

为什么还要一个 Host 半部？ 客户端插件只能看到自己绑定的会话。跨会话视图需要全局 session/event 流，而只有 Host 会收到这个流。

测试

npm test # view model + bundle smoke + theme/frame tokens + visual tokens
npm run test:host # four root sessions + one sub-agent over the real state route
npm run verify # read-only probe of a running GUI

| 脚本 | 固定住什么 |
| scripts/client-spec.mjs | 胶囊文案与色调、行排序、各状态的 meta 文本、标题回退、子代理徽标、耗时格式化、注入的开关 |
| scripts/client-smoke.mjs | bundle 契约、overlay 注册、雷达开关 |
| scripts/host-smoke.mjs | 状态排序与计数、审批生命周期、子代理聚合、maxRows、最近窗口、路由边界 |
| scripts/theme-tokens.mjs | 每个 --dsw-/--dsh- 引用都由已安装的 bundle 声明 |
| scripts/visual-tokens.mjs | 没有原始颜色，圆角与字号来自主题刻度，没有无限动画 |
| scripts/verify-deployed.mjs | 运行中的 GUI 能提供 bundle 和状态路由 |

限制

- 挂载之前的事看不到。 Host 折叠实时事件流，所以挂载前就已经空闲的会话不会出现——这正是雷达的本意。
- 只有一个 Host 进程。 另一个客户端窗口或进程里的会话不在它的视野内。
- 只读。 行可以切换会话；雷达从不停止、重试或批准任何东西。
- 子代理只计数，不列出。 它们的行归属于父会话。

License

MIT — 见 LICENSE。