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 個值得優先安裝的外掛,涵蓋各個分類。
