前言¶
在 DeepSeek Harness (DSH) 的插件化架构下，子代理的执行逻辑通常运行在独立的进程或上下文中。当开发者需要排查子代理的执行状态、工具调用细节或推理过程时，缺乏一个可视化的监控入口。DSH 插件 dsh-subagent-inspector 解决了这一观测断层问题，它通过在 Web profile 中提供只读接口，将子代理的内部状态实时映射到前端界面。
插件定位¶
这是一个由 chongyangdu2008-cyrus 维护的客户端插件，核心价值在于提供只读的实时子代理过程检查器。它不干预子代理的调度或权限，仅通过读取官方 Session 和 subagent 事件，将复杂的执行树和日志结构化展示。
核心功能¶
插件在 conversation.session.header.actions 添加了入口，与官方的 ui-subagent 导航并存。其主要能力包括：
- 子代理树形视图：展示多层可折叠的子代理树，列出执行状态、模式、深度、耗时、token 使用量以及当前正在使用的工具。
- Turn -> Step 详情：按层级展开 Turn 和 Step，展示任务提示、推理过程、回复内容、Todo 列表以及工具调用的请求与结果。
- 实时更新机制：使用 SSE (Server-Sent Events) 实时推送数据，具备断线重连去重和自动跟随新事件的能力。
- 多语言支持：界面提供简体中文与英文两种选项。
- 安全边界：插件仅读取官方 Session、agent 与 subagent 事件，不注册模型工具。
安装与启用¶
通过命令行安装插件：
dsh plugin --profile web add github:chongyangdu2008-cyrus/dsh-subagent-inspector#v0.1.0
安装完成后，需要重新启动 Web profile：
dsh web
启动后，在当前会话的标题栏打开右侧抽屉，即可查看实时的子代理树。
注意事项¶
- 兼容性：该插件仅支持 Harness Web，固定兼容 DeepSeek Harness
v0.1.1-rc.2。 - 安全风险：检查器会显示完整的 Session 日志，可能包含源代码、文件内容、命令输出等敏感信息。请仅在可信网络中使用，且插件不开放 CORS，接口与 Harness Web 同源。
- 日志展示逻辑：对于 Fork 的子代理，插件仅展示自身日志的后缀（
seq >= seedLength），不会复制第三方插件的实现。 - 源码审查：插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证。
