返回目录

dsh-a2a

精选清单收录维护状态: 活跃

ryubyte/dsh-a2a

DSH 的 A2A v1.0 双端插件:Client 发现远程 Agent 并映射为工具,Server 对外提供 JSON-RPC/SSE 端点与连接面板 | A2A v1.0 dual-mode DSH plugin: A2A client (skills as tools) + A2A server (JSON-RPC/SSE) with dashboard.

前往 GitHub
$ dsh plugin --profile web add @ryubyte/dsh-a2a

16

星标

1

Fork

TypeScript

语言

MIT

许可证

2026-08-17

创建于

2026-11-03

最近推送

MIT 协议的 DSH 插件,双向实现 A2A v1.0:远程 skill 变成 `a2a__<name>__<skill>` 工具,入站提供 AgentCard 与 JSON-RPC / SSE 端点并由 DSH agent 会话执行,支持双向 Bearer Token 与纯 UI 配置面板。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-21

许可证

MIT

01它能帮你完成什么?

  • 在 DSH 对话里像调用本地工具一样调用远程 A2A agent

    自动发现远程 AgentCard,每个 skill 变成一个 `a2a__<name>__<skill>` 模型工具,调用走 A2A JSON-RPC;同一本地会话复用同一个 `contextId`,因此远端保留跨轮记忆

    想把远程 agent(研究、编码或合作方服务)接进自己会话的 DSH 用户

  • 把本 DSH 暴露成一个可被发现、可被调用的 A2A agent

    在 DSH webserver 上提供 `/.well-known/agent-card.json` 与 JSON-RPC 端点(`SendMessage`、`GetTask`、`ListTasks`、`CancelTask`)以及 SSE 流式,默认由本 DSH 的 agent 会话执行

    要把多个 agent 串起来协作的团队,或想把自己基于 DSH 的 agent 发布到 A2A 网络的人

02如何接入 DeepSeek Harness?

前置条件

  • 一个可安装的 DSH profile——README 示例用 `web`,并用 `dsh --profile web` 启动
  • DSH 0.1.7-rc.2、0.2.0-rc.1~2、0.2.1-alpha.1~5 或 0.2.1-rc.1~5(共 13 个版本,CI 与发布流程逐版本验证)
  • 入站(server)模式需要一个可达端点;若对生产网络开放,还要自备 TLS 反向代理(A2A 规范要求 `AgentInterface.url` 使用 HTTPS)

安装步骤

  1. 01

    执行 `dsh plugin --profile web add @ryubyte/dsh-a2a`——`dsh plugin` 会把包装进 profile 并自动加入插件层(包内声明了 `dsh.bundle.patch`),不需要手动改任何配置。

    $ dsh plugin --profile web add @ryubyte/dsh-a2a

  2. 02

    用 `dsh --profile web` 启动 DSH,重启后插件生效。

    $ dsh --profile web

  3. 03

    出站:设置 → A2A 连接 →「连接的 Agent」→ 添加 Agent,填 AgentCard URL(可选 Bearer Token),预览远端名称 / 描述 / 技能后点「连接」。

  4. 04

    入站:打开「对外服务」tab,全新安装会显示预填好的表单,改几个字段后点「创建并上线」,即生成 `a2a.json` 并开始对外服务。

验证接入成功

作者未说明

03DSH 适配与能力边界

DSH 适配原生运行时

原生 DSH 插件(npm 包 `@ryubyte/dsh-a2a`,基于 Cordis),让一个 DSH 实例成为完整的 A2A v1.0 节点:出站客户端把远程 skill 映射成 `a2a__<name>__<skill>` 工具,入站服务对外提供 AgentCard 与 JSON-RPC / SSE 端点

  • A2A v1.0 协议能力

    AgentCard URL(出站),或入站的 JSON-RPC 请求→通过 `/.well-known/agent-card.json` 发现;`SendMessage` / `GetTask` / `ListTasks` / `CancelTask` / `GetExtendedAgentCard`;`SendStreamingMessage`(SSE)与 `SubscribeToTask` 流式

    任务生命周期在 SUBMITTED → WORKING → COMPLETED / FAILED / CANCELED / REJECTED / INPUT_REQUIRED / AUTH_REQUIRED 之间流转
  • 双角色连接面板

    只需在 UI 里操作,没有别的入口→两个 tab(连接的 Agent / 对外服务):每个 Agent 可重连、设置、禁用、删除;服务身份可编辑并完整增删改 Skills;上线开关与入站连接列表

    面板每 3 秒自动刷新;`/a2a/api` 在 loopback / same-origin 保护下提供 JSON 快照与控制接口,且绝不回传 token 值
  • 双向 Bearer Token 鉴权

    出站时每个 Agent 的 Token,或「对外服务」里的共享入站 Token→出站请求带 `Authorization: Bearer …`;设置了入站 Token 后 AgentCard 声明 `bearerAuth` 安全方案,未带或带错 token 的请求返回 401

    token 以明文存于 `a2a.json`,文件权限需自行保证
  • DSH agent executor 与会话映射

    带 A2A `contextId` 的入站任务→每个 `contextId` 一个 DSH 会话,进程重启后按需 resume,同 context 串行、不同 context 并行;`CancelTask` 会 abort 正在运行的 executor 信号

    入站会话以 `<profile>/.a2a-sessions` 为 cwd,并在会话列表里显示为 `A2A: <摘要>`

04适合谁?何时不该用?

适合

  • 想把远程 agent(研究、编码或合作方服务)接进自己会话的 DSH 用户
  • 要把多个 agent 串起来协作的团队,或想把自己基于 DSH 的 agent 发布到 A2A 网络的人

不适合

  • 切勿把 server 模式暴露到不受信网络:入站端点默认无鉴权(除非配置 `authToken`),而 A2A 规范要求对外公布的接口 URL 使用 HTTPS,DSH webServer 默认只绑 loopback。
  • 出站每个 Agent 的 Token 与入站 `authToken` 都以明文写在 `a2a.json` 里,保护该文件是运维方的责任。

05兼容性、维护与安全提示

  • 切勿把 server 模式暴露到不受信网络:入站端点默认无鉴权(除非配置 `authToken`),而 A2A 规范要求对外公布的接口 URL 使用 HTTPS,DSH webServer 默认只绑 loopback。
  • 出站每个 Agent 的 Token 与入站 `authToken` 都以明文写在 `a2a.json` 里,保护该文件是运维方的责任。
2026-08-172026-11-03v0.3.2

MIT · 活跃维护(最新 release v0.3.2,2026-11-03);覆盖 13 个 DSH 版本并逐版本验证

06常见问题

需要手写 `a2a.json` 吗?

不需要。README 说明所有配置都能在「设置 → A2A 连接」里完成:按 AgentCard URL 添加 Agent、逐个编辑超时 / 技能拆分 / Token,在「对外服务」里改身份、Skills、上线状态与入站 Token。手写 `a2a.json` 仍然支持,适合脚本化部署。

别的 agent 发来的任务由谁执行?

默认由本 DSH 自己的 agent 会话执行:每个 A2A `contextId` 一个会话,cwd 为 `<profile>/.a2a-sessions`,重启后按需 resume,同一 context 内串行、不同 context 并行。通过 composition 注入的 `execute` 优先;没有 agent 循环的最小 profile 会返回「no executor configured」拒绝执行。

server 模式能直接暴露到公网吗?

不行。README 明确提醒:除非配置 `authToken`,入站端点没有鉴权;而 A2A 要求对外公布的接口 URL 用 HTTPS,DSH webServer 默认只绑 loopback。对外开放前请先放在 TLS 反向代理之后。

Bearer Token 存在哪里?

明文存在 `a2a.json` 里(出站每个 Agent 的 Token 和入站 `authToken` 都是)。`/a2a/api` 快照只暴露「是否已配置」,不回传 token 值,但文件权限要自己保证。

支持哪些 DSH 版本?

共 13 个:0.1.7-rc.2、0.2.0-rc.1~2、0.2.1-alpha.1~5 与 0.2.1-rc.1~5。README 说明 CI 与发布流程逐版本验证。

08数据与来源

  • 作者声明github.com21718daffa33…

    一个 **DeepSeek Harness (DSH)** 插件,实现 **Agent2Agent (A2A) 协议 v1.0**(Linux 基金会,`a2aproject/A2A`,Apache-2.0)。

  • 作者声明github.com21718daffa33…

    让一个 DSH 实例成为完整的 A2A 双端节点:

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-21。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。