# dsh-subagent-inspector

[English](README.en.md)

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

![dsh-subagent-inspector 测试界面](docs/screenshot.png)

> [!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 前请等待本插件发布相应兼容版本。

## 安装

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

重新启动 Web profile：

```bash
dsh web
```

卸载：

```bash
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 都会先验证；未知事件会被安全忽略。协议与数据流详见 [架构说明](docs/architecture.md)。

## 开发

要求 Node.js 22+ 和 pnpm 11：

```bash
pnpm install
pnpm verify
```

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

本项目使用 [MIT License](LICENSE)。实现依据 DeepSeek Harness 的[官方项目](https://github.com/deepseek-ai/deepseek-harness)、[架构说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/architecture.md)、[子 agent UI](https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/client/ui-subagent/README.md)与[插件发布规范](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/develop/basic/publish.md)，不复制第三方插件实现。