BiKing567/dsh-subagent-panel

dsh-subagent-panel

将每个子代理渲染为 DSH Web 对话中的可点击卡片，点击后以普通会话的形式打开该子代理——实现 OpenCode 风格的子代理可见性，而无需重新渲染 shell 的会话视图。

你将获得

1. 内联卡片——通用的 subagent / subagent_fork 工具行会变成一张卡片，显示委派的任务、实时状态徽章（运行中 / 空闲）、子代理 id、已用时间，以及该子代理是否派生了嵌套子代理。点击它即可导航到该子代理的会话。

2. 侧边栏触发器——一个浮动胶囊按钮（右下角），统计当前会话的子代理数量，当有子代理正在运行时显示一个圆点。点击可列出全部子代理；点击某一行即可导航到该会话。

打开子代理会调用 sessions.openSubagent(address)——与会话头部的子代理目录所使用的导航相同——因此子代理会在 shell 自身的对话视图中渲染。本插件不绘制自己的转录内容：shell 渲染会话的效果比插件所能做到的更好。

安装

dsh plugin --profile web add link:/path/to/dsh-subagent-panel
dsh web

link: 会让安装指向源码树，因此编辑后重新构建并刷新页面即可生效。

你也可以直接从 git 安装：

dsh plugin --profile web add github:BiKing567/dsh-subagent-panel

要求

- 带有 Web 客户端的 DSH（基于 dsh 0.1.0-rc.6 开发）。
- 客户端包是可选的 peer 依赖——它们由 harness 在运行时注入，而非安装到本包中。本插件需要：
- @deepseek-ai/dsh-client-runtime——用于 ctx.sessions 和子代理目录
- @deepseek-ai/dsh-client-locale——用于双语词典
- @deepseek-ai/dsh-client-ui-tool——用于 tool.call.toolview 插槽
- 所使用的 API（sessions.openSubagent、subagentsByParent、SubagentAddress）从 @deepseek-ai/dsh-client-runtime 0.0.1-rc.1 起就已存在。peer 范围是 ^0.1.0-0 || ^0.0.1-0 || >=0.2.0-0，而不是简单的 ^0.1.0-rc.6，因为 node-semver 只有在范围中某个比较符与该版本共享完全相同的 major.minor.patch 元组并且自身带有预发布标签时，才允许预发布版本满足该范围。因此 ^0.1.0-rc.6 和看似宽泛的 * 都会静默排除 0.1.0-rc.6——而这正是本插件所基于开发的版本。

构建

npm run build     # src/client -> lib/client.js

宿主部分（lib/index.js）是纯 ESM，无需构建。

配置

在 cordis 行中：

- id: dsh-subagent-panel
name: 'dsh-subagent-panel'
config:
maxMessages: 500      # max rows rendered by the /subagents command

工作原理

- 内联卡片注册到以 wire 工具名为键的 tool.call.toolview 中。该插槽是按名称键控的，且 subagent / subagent_fork 未被占用，因此本插件拥有这些行，而不会遮蔽任何内容。
- 触发器注册到 shell.overlay 中，这是可叠加的、覆盖整个框架的浮动
层。
- 数据来自目录 ctx.sessions 已经投射的内容
（subagentsByParent）。该插件不定义自定义 RPC，也不解析会话
日志——subagents 服务始终是父/子
关联的唯一权威。
- 卡片 → 子项身份：一旦调用完成，渲染的文本会携带
id（started subagent ），该 id 会与目录进行匹配以找到
条目（及其 mode，openSubagent 会对此进行验证）。当调用仍在
运行时，还没有目录条目，因此卡片会显示任务描述
并保持惰性，而不是猜测此调用启动了哪个子项。

宿主命令

/subagents 列出当前会话的直接子项，并显示状态、模式和
标签。