dsh-subagent-max

English | 中文

DeepSeek Harness (DSH) 的多面板实时子代理查看器，附带一个支持按调用指定模型/供应商的 subagent_with_model 工具。

截图

子代理 Tab —— 按「活跃中 / 不活跃」分组、按最后活动时间排序的卡片网格。

浮动查看器弹窗 —— 可拖拽的实时面板，展示子代理的任务、推理（Think）、工具调用与文本输出。

双面插件：

• 宿主侧（lib/index.js）——Cordis 插件，注册 subagent_with_model 工具；它是 ctx.subagents 之上的薄壳，把 model / provider 转发进子代理的 agentOptions。
• 客户端侧（lib/client.js）——Web UI，把每个子代理渲染成可拖拽、可缩放的浮动弹窗，实时（逐 token）展示输出，并提供一个带卡片网格的 子代理 标签页。

特性

• 按调用覆盖模型/供应商 —— 委派子代理时显式指定其模型。
• 自动选择供应商 —— 不传 provider 时，优先用父级 provider（若能服务目标模型），否则自动找携带该模型的 provider。
• 多面板实时查看器 —— 同时打开多个子代理弹窗，每个都实时流式输出。
• 丰富的块渲染 —— 任务块、推理（Think）块、带输入/输出的工具卡、流式流光、Markdown。
• 子代理标签页 —— 卡片网格按「活跃中 / 不活跃」分组、按最后活动时间排序；展示模型、token、steps、上下文占比和相对更新时间。
• 拖拽弹出 —— 把卡片拖到画布上，弹窗正好落在松手处（带幽灵框预览）。
• 通知 —— 子代理开始或收到消息时，右上角弹出提示条。
• 多语言 —— 中 / 英，可在 DSH 设置中切换。

安装

dsh plugin --profile web add @aaravarr/dsh-subagent-max

或手动：把包放到 <profile>/node_modules/@aaravarr/dsh-subagent-max/，并在 cordis.patch.yml 里加上对应 entry（见 配置）。

配置

- insert:
    - id: dsh-subagent-max
      name: '@aaravarr/dsh-subagent-max'
      config:
        subagentProvider: spawn        # spawn | fork | acp
        toolName: subagent_with_model
        backgroundMode: continuable    # one-shot | continuable
        maxDepth: 3

| 字段 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | subagentProvider | string | spawn | 子代理传输 provider。 | | toolName | string | subagent_with_model | 面向模型的工具名；必须在已加载工具中唯一。 | | backgroundMode | string | one-shot | continuable 返回持久化子代理 id；one-shot 前台运行。 | | maxDepth | number | 3 | 子代理的绝对委派深度上限（0 禁止继续委派）。 |

使用

让模型带显式模型去委派：

用 deepseek-v4-flash 起一个子代理，帮我看看这个仓库的测试覆盖情况。

工具参数：

| 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | model | string | 是 | 子代理模型 id（如 deepseek-v4-pro、deepseek-v4-flash、k3-256k）。 | | provider | string | 否 | LLM provider 路由。省略则自动选择：优先使用父级自身的 provider（若能服务目标模型）；否则自动找一个携带该模型的 provider；若所有 provider 都不含该模型，则按原样继承父级 provider（子代理可能报 UNKNOWN_MODEL）。 | | description | string | 是 | 简短（3-5 词）任务标签。 | | prompt | string | 是 | 完整、自包含的任务。 | | run_in_background | bool | 否 | 后台路由；默认跟随 backgroundMode。 |

已知限制

• 模型展示取自会话的 request/header；部分子代理可能拿不到模型。
• 最后活动时间是客户端跟踪并缓存在 localStorage 里的；全新加载后首次打开可能回退到会话的 updatedAt。
• 客户端 UI 仅面向 Web 平台。

开发

pnpm install
node --check lib/index.js lib/client.js

许可证

MIT