dsh-subagent-a2a

dsh-subagent-a2a

独立的 DeepSeek Harness A2A Client Provider 插件。

让 DSH 的 subagent 工具可以委托给远程 A2A agent。

特性

• 注册 ctx.subagents provider：a2a
• 发现远程 AgentCard
• 阻塞式 SendMessage
• 将 A2A Task artifact 映射为 SubagentResult.output
• 支持取消、超时、错误映射

构建

export DSH_CHECKOUT=/path/to/deepseek-harness
bash scripts/build.sh

Windows 构建

$env:DSH_CHECKOUT = "D:\workspace\dsh\deepseek-harness"
powershell -ExecutionPolicy Bypass -File scripts/build.ps1

或：

npm run build:ps1

下载自动构建产物

每次向 main 推送代码、更新 Pull Request，或手动运行 GitHub Actions 的
Build 工作流时，都会生成可安装的 npm .tgz 包。

从 GitHub 网页下载

1. 打开仓库的 Actions → Build。
2. 进入最近一次状态为绿色的构建。
3. 在页面底部的 Artifacts 区域下载
   dsh-subagent-a2a-<commit SHA>。
4. 解压下载的 ZIP，即可获得 dsh-subagent-a2a-<version>.tgz。

GitHub Actions 构建产物保留 14 天；长期分发请使用 GitHub Release。

安装

使用 DSH 官方插件装配命令：

cd D:\workspace\dsh
dsh plugin --profile desktop add .\dsh-subagent-a2a\

安装完成后重启 DSH Desktop（或对应 profile 的运行时）使插件加载。

说明：dsh plugin add 会将该插件写入 profile 的 dependencies 与 bundles，并按官方装配流程加载 cordis.patch.yml。

配置示例

- id: subagent-a2a
  name: 'dsh-subagent-a2a'
  config:
    providerName: a2a
    url: http://127.0.0.1:4123
    agentCardPath: /.well-known/agent.json
    headers:
      Authorization: Bearer token
    timeoutMs: 120000

说明

• 本插件不是 @deepseek-ai 官方包，使用无 scope 包名 dsh-subagent-a2a。
• 只依赖 DSH 官方 @deepseek-ai/* 包与 @a2a-js/sdk，不依赖其他第三方插件。
• 构建产物 lib/index.js 已自包含打包运行时依赖。