子代理实时检查器 chongyangdu2008-cyrus/dsh-subagent-inspector

dsh-subagent-inspector

一个独立原创、只读的 DeepSeek Harness Web 插件。在当前会话标题栏打开右侧抽屉，实时查看完整子 agent 树、Turn/Step、任务提示、Harness 已记录的 reasoning、回复、Todo、工具调用与结果、错误、耗时和 token 使用量。

dsh-subagent-inspector 测试界面

[!WARNING]
检查器会显示完整 Session 日志，包括任务提示、工具参数和工具结果，其中可能含有源代码、文件内容、命令输出或其他敏感信息。插件不开放 CORS，但如果 Harness Web 绑定到 0.0.0.0，这些只读接口会沿用相同的网络暴露边界。请只在可信网络中使用。

兼容性

- 仅支持 Harness Web。
- v0.1.0 固定兼容 DeepSeek Harness 0.1.1-rc.2。
- Harness 仍处于 Developer Preview；升级 Harness 前请等待本插件发布相应兼容版本。

安装

dsh plugin --profile web add github:chongyangdu2008-cyrus/dsh-subagent-inspector#v0.1.0

重新启动 Web profile：

dsh web

卸载：

dsh plugin --profile web remove dsh-subagent-inspector

功能

- 在 conversation.session.header.actions 添加入口，与官方 ui-subagent 导航并存。
- 多层可折叠子 agent 树，显示执行状态、模式、深度、耗时、token 和当前工具。
- 按 Turn → Step 展示提示、实际记录的 reasoning、回复、Todo、请求元数据、工具调用/结果和终止原因。
- 工具载荷默认折叠，可完整展开；不使用原始 HTML 渲染任何日志内容。
- SSE 实时更新、断线重连去重、自动跟随、新事件提示、历史分页和原生子 agent 会话跳转。
- 简体中文与英文界面；Harness 的所有中文 locale 都使用简体中文词典。
- 本地 Session-backed 子 agent 显示完整记录；无本地 Session 的远程 provider 只显示可观测生命周期。

可观测性边界

本插件只读取官方 Session、agent 与 subagent 事件，不注册模型工具，也不会改变子 agent 的调度、模型、权限或上下文。

插件只显示 Harness 实际记录的 reasoning。模型没有提供、provider 没有返回或 Harness 没有持久化的内部推理，不会被推测、补写或生成。fork 子 agent 只展示 seq >= seedLength 的自身日志后缀，继承的父会话前缀不会出现。

只读接口

接口与 Harness Web 同源，只接受 GET：

- /dsh-subagent-inspector/snapshot?rootSessionId=...
- /dsh-subagent-inspector/history?rootSessionId=...&sessionId=...&beforeSeq=...&limit=...
- /dsh-subagent-inspector/stream?rootSessionId=...

历史页默认 200 条，最大 500 条。所有 Session ID 都会先验证；未知事件会被安全忽略。协议与数据流详见 架构说明。

开发

要求 Node.js 22+ 和 pnpm 11：

pnpm install
pnpm verify

仓库提交预构建的 lib/，且没有 prepare 脚本，因此通过 GitHub 安装时不需要授权执行构建脚本。CI 会检查 typecheck、测试、构建产物新鲜度、打包内容以及隔离的 Harness 安装/卸载。

本项目使用 MIT License。实现依据 DeepSeek Harness 的官方项目、架构说明、子 agent UI与插件发布规范，不复制第三方插件实现。