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)
安装步骤
- 01
执行 `dsh plugin --profile web add @ryubyte/dsh-a2a`——`dsh plugin` 会把包装进 profile 并自动加入插件层(包内声明了 `dsh.bundle.patch`),不需要手动改任何配置。
$ dsh plugin --profile web add @ryubyte/dsh-a2a
- 02
用 `dsh --profile web` 启动 DSH,重启后插件生效。
$ dsh --profile web
- 03
出站:设置 → A2A 连接 →「连接的 Agent」→ 添加 Agent,填 AgentCard URL(可选 Bearer Token),预览远端名称 / 描述 / 技能后点「连接」。
- 04
入站:打开「对外服务」tab,全新安装会显示预填好的表单,改几个字段后点「创建并上线」,即生成 `a2a.json` 并开始对外服务。
验证接入成功
作者未说明
03DSH 适配与能力边界
原生 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` 里,保护该文件是运维方的责任。
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 与发布流程逐版本验证。
07相关的 DSH 工作流
dsh-agent-teams
作者 nanmicoder
DeepSeek Harness 的 Agent Teams 多智能体协作插件,支持多个 AI Agent 组成团队,协同完成复杂任务,实现任务分配、并行执行、成员通信与团队协作。 AgentTeams plugin for DeepSeek Harness
dsh-blender-plugin
作者 sixtysevenlf
DSH × Blender 直连插件 v3.0.6:15 个模型工具让 AI 驱动 GUI Blender(视口 / 自定义视角 / 无头 worker / 作业层 / 事务回滚 / 配方库),34 family / 228 op 契约层;npm 安装 + addon zip,GUI 优先、无头备用;dsh-TUI 选中 chip / @ 提及 / /blender,随包建模 skill,支持 WSL / Windows / macOS。
dsh-free-search
作者 dddmuc
为DeepSeek Harness提供的免费网络搜索服务商:即使没有API密钥也可使用。Free web search provider for DeepSeek Harness:usable even without an API key.
dsh-bili-scroll
作者 c1overzz
DSH 插件:每天替你刷一轮 B站,读字幕挑出值得的、写一份日报,值得的 @ 你
08数据与来源
一个 **DeepSeek Harness (DSH)** 插件,实现 **Agent2Agent (A2A) 协议 v1.0**(Linux 基金会,`a2aproject/A2A`,Apache-2.0)。
让一个 DSH 实例成为完整的 A2A 双端节点:
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-21。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
