返回目錄

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 外掛,絕不濫發。