fangweixuan26-hash/dsh-a2a-agent

Plugin插件 Native原生 ⭐ 3 MIT Models & Routing模型与路由

通过Agent2Agent(A2A)协议暴露一个DeepSeek Harness代理:代理卡片、JSON-RPC、LLM回复。

Project Overview项目介绍

This is a native Cordis plugin built exclusively for DeepSeek Harness that adds A2A (Agent-to-Agent) protocol 1.0 compatibility to any DSH agent. It automatically generates an A2A-compliant Agent Card accessible at a standard HTTP endpoint, supports JSON-RPC 2.0 method calls, and generates LLM-powered responses by reusing DSH’s built-in LLM service. The plugin comes in two forms: an npm package that can be added to a host combination, and a dynamic plugin that can be loaded instantly without a build step. It reuses DSH’s existing webServer, so there is no port conflict to worry about.

The A2A protocol is an open standard launched by Google in 2025 that allows agents from different frameworks and vendors to discover each other, collaborate, and exchange messages. DeepSeek Harness natively only supports MCP for agent-tool interaction, and does not have a built-in way to expose an agent endpoint to other agents. This plugin fills that gap, allowing any DSH agent to get a standardized A2A identity with just one install. After installation, any compatible A2A client can connect to your agent via standard HTTP endpoints, send messages, and receive both synchronous and streaming responses.

This plugin requires Node.js version 20 or higher to run, and it is distributed under the open-source MIT license. All task and message data is stored in process memory, and is automatically cleared when the plugin stops running. Right now, the plugin does not support task persistence, subagent scheduling, or authentication, all of which are marked as future work on the development roadmap. If you use the dynamic plugin form, you will need to manually approve the plugin in the DSH UI on the first run before the status card can display correctly.

dsh-a2a-agent 是专为 DeepSeek Harness 开发的原生 Cordis 插件,作用是让任意 DSH 智能体一键兼容 Google 2025 年推出的 A2A(Agent-to-Agent)1.0 开放协议。它自带符合 A2A 规范的 Agent Card 自动发现、JSON-RPC 2.0 端点、大模型驱动的对话回复,以及实时运行状态卡片,复用 DSH 自带的 webServer 和 LLM 服务,不会产生端口冲突。插件同时提供 npm 包和动态插件两种形态,可按需选择安装方式。

A2A 协议允许不同框架、不同厂商的智能体互相发现、协作对话,而 DeepSeek Harness 原生仅支持 MCP(智能体与工具交互),没有对外暴露智能体端点的能力,这个插件正好填补了这个空白。它适合需要让自己的 DSH 智能体和其他符合 A2A 规范的智能体协作的开发者,也方便开发者测试 A2A 协议的对接流程。安装后,其他 A2A 客户端就可以通过标准 HTTP 端点发现你的智能体、发送消息并获取流式或同步回复。

这个插件要求 Node.js 版本不低于 20,采用 MIT 许可协议免费开源,所有任务和消息数据都存储在进程内存中,插件停止运行时会自动清空数据。目前暂不支持任务持久化、子代理调度和认证功能,这些功能都在未来的开发路线图中。动态插件形态首次运行时,需要用户在 DSH UI 中手动批准后才能正常显示状态卡片。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin add dsh-a2a-agent

把 fangweixuan26-hash/dsh-a2a-agent 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

🤝 DSH A2A Agent

让任意 DeepSeek Harness 智能体一键成为 A2A 兼容的 Agent

一个轻量的 Cordis 插件:自带 Agent Card 发现、JSON-RPC 2.0 端点、大模型驱动的对话回复,以及一个实时状态卡片。

license A2A 1.0 node version stars

Agent-to-Agent · 让智能体之间说同一种语言


✨ 为什么你需要它

A2A(Agent2Agent) 是 Google 于 2025 年推出的开放协议,让不同厂商、不同框架的智能体能够互相发现、协作、对话。而 DeepSeek Harness 原生只支持 MCP(Agent ↔ 工具),缺少对外暴露的 Agent 端点。

这个插件填补了空白 —— 一次定义,你的 DSH 智能体就有了标准化的 A2A 身份,并在对话流里实时看到它的运行状态。

🚀 特性

🪪 Agent Card 自动发现
符合 A2A 1.0 规范的 /.well-known/agent.json
🔌 JSON-RPC 2.0
message/send · message/stream · tasks/get · tasks/cancel
🧠 真实大模型回复
复用宿主 llm 服务流式生成
🛡️ 优雅降级
模型不可用时自动回退确定性 echo
📊 实时状态卡片
Run 卡片内展示端点 URL、消息数、任务数
🔀 零端口冲突
复用宿主 webServer,不抢端口
♻️ 可逆生命周期
所有副作用挂载在 Cordis fiber 上
🌐 CORS 开箱即用
浏览器端 A2A 客户端可直接调用

🧭 工作原理

sequenceDiagram
    participant C as A2A Client
    participant W as DSH webServer
    participant H as Host half
    participant L as LLM Service
    participant U as Client half (状态卡片)

    C->>W: GET /.well-known/agent.json
    W->>H: 命中 route handler
    H-->>C: Agent Card (JSON)

    C->>W: POST /a2a · message/send
    W->>H: JSON-RPC dispatch
    H->>L: llm.stream(prompt)
    L-->>H: token 流
    H-->>C: Task (completed, 含回复)

    U->>H: get-status (每 2s)
    H-->>U: { endpointUrl, messageCount, taskCount }

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-better-sidebar-svn 下一个 Next dsh-ximalaya →