ディレクトリに戻る

dsh-a2a

キュレーションリスト掲載メンテナンス: 活発

ryubyte/dsh-a2a

A2A サービスと接続ダッシュボードを提供する DSH プラグイン

GitHub で見る
$ dsh plugin --profile web add @ryubyte/dsh-a2a

16

スター

1

フォーク

TypeScript

言語

MIT

ライセンス

2026-08-17

作成日

2026-11-03

最終プッシュ

MIT ライセンスの DSH プラグイン。A2A v1.0 を双方向に実装し、リモートの skill を `a2a__<name>__<skill>` ツールに、インバウンドは AgentCard と JSON-RPC / SSE エンドポイントを DSH agent セッション実行で提供。双方向 Bearer 認証と UI 完結のダッシュボードを備えます。

DSH 統合

ネイティブ実行

作者による申告

安全性監査

未監査

最終検証日

2026-11-21

ライセンス

MIT

01どんなタスクに使えるのか?

  • リモートの A2A agent を、ローカルツールと同じ感覚で DSH の会話から呼ぶ

    リモートの AgentCard を検出し、各 skill が `a2a__<name>__<skill>` というモデルツールになり、呼び出しは A2A JSON-RPC で実行されます。ローカルセッションごとに 1 つの `contextId` を再利用するため、リモート側はターンをまたいだ記憶を保ちます

    リモートの agent(調査・コーディング・提携先サービス)を自分のセッションに接続したい DSH ユーザー

  • この DSH を、他の agent から検出・呼び出しできる A2A agent として公開する

    DSH webserver 上に `/.well-known/agent-card.json` と JSON-RPC エンドポイント(`SendMessage`、`GetTask`、`ListTasks`、`CancelTask`)、さらに SSE ストリーミングを提供し、既定ではこの DSH 自身の agent セッションが実行します

    複数の agent を連携させたいチームや、DSH ベースの agent を A2A ネットワークに公開したい人

02DeepSeek 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 とリリース工程で各版を検証)
  • サーバーモードでは到達可能なエンドポイントが必要。本番ネットワークに公開する場合は 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 トークン)を入力し、リモートの名前・説明・スキルをプレビューしてから接続します。

  4. 04

    インバウンド: 「对外服务」タブを開くと、新規インストールでは既定値入りのフォームが表示されます。項目を調整して「作成して公開」を押すと `a2a.json` が生成され配信が始まります。

導入成功の確認

作者は未記載

03DSH 統合と能力の範囲

DSH 統合ネイティブ実行

DSH ネイティブプラグイン(npm パッケージ `@ryubyte/dsh-a2a`、Cordis ベース)。1 つの 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 のみ。他の入口はありません→2 つのタブ(接続した Agent / 对外服务)。Agent ごとに再接続・設定・無効化・削除、サービスの識別情報編集と Skills の追加削除更新、公開スイッチとインバウンド接続一覧

    パネルは 3 秒ごとに自動更新。`/a2a/api` は loopback / same-origin 保護下で JSON スナップショットと制御 API を提供し、トークン値は決して返しません
  • 双方向の Bearer トークン認証

    アウトバウンドの Agent ごとのトークン、または「对外服务」の共有インバウンドトークン→アウトバウンドは `Authorization: Bearer …` を送信。インバウンドトークンを設定すると AgentCard が `bearerAuth` を宣言し、欠落・不一致のリクエストは 401 になります

    トークンは `a2a.json` に平文で保存されるため、ファイル権限の管理は利用者の責任です
  • DSH agent executor とコンテキスト対応

    A2A `contextId` を持つインバウンドタスク→`contextId` ごとに 1 つの DSH セッションを作成し、再起動後は必要に応じて resume。同一コンテキスト内は直列、異なるコンテキストは並列で、`CancelTask` は実行中の executor シグナルを abort します

    インバウンドセッションは `<profile>/.a2a-sessions` を cwd とし、セッション一覧に `A2A: <要約>` として現れます

04誰に向いているのか?使うべきでない場面は?

向いている用途

  • リモートの agent(調査・コーディング・提携先サービス)を自分のセッションに接続したい DSH ユーザー
  • 複数の agent を連携させたいチームや、DSH ベースの agent を A2A ネットワークに公開したい人

不向きな用途

  • サーバーモードを信頼できないネットワークに公開しないでください。インバウンドは `authToken` を設定しない限り認証なしで、A2A 仕様は公開インターフェース URL に HTTPS を要求しますが、DSH webServer は既定で loopback にのみバインドします。
  • アウトバウンドの Agent ごとのトークンもインバウンドの `authToken` も `a2a.json` に平文で保存されます。このファイルの保護は運用者の責任です。

05互換性・メンテナンス・セキュリティ上の注意

  • サーバーモードを信頼できないネットワークに公開しないでください。インバウンドは `authToken` を設定しない限り認証なしで、A2A 仕様は公開インターフェース URL に HTTPS を要求しますが、DSH webServer は既定で loopback にのみバインドします。
  • アウトバウンドの Agent ごとのトークンもインバウンドの `authToken` も `a2a.json` に平文で保存されます。このファイルの保護は運用者の責任です。
2026-08-172026-11-03v0.3.2

MIT · 活発にメンテナンス中(最新リリース v0.3.2、2026-11-03)。13 の DSH バージョンを対象に各リリースで検証

06よくある質問

`a2a.json` を手で書く必要はありますか?

いいえ。README によるとすべての設定は「設定 → A2A 接続」で行えます。AgentCard URL で Agent を追加し、タイムアウト・スキル分割・トークンを個別に編集し、「对外服务」で識別情報・Skills・公開状態・インバウンドトークンを変更できます。スクリプト運用向けに手書きの `a2a.json` も引き続き利用できます。

他の agent から届いたタスクは誰が実行しますか?

既定ではこの DSH 自身の agent セッションです。A2A `contextId` ごとに 1 セッションを `<profile>/.a2a-sessions` を cwd として作成し、再起動後は必要に応じて resume、同一コンテキスト内は直列・異なるコンテキストは並列です。composition で注入した `execute` が優先され、agent ループを持たない最小 profile は「no executor configured」で拒否します。

サーバーモードをそのままインターネットに公開しても大丈夫ですか?

だめです。README は、`authToken` を設定しない限りインバウンドは認証なしであること、A2A は公開インターフェース URL に HTTPS を要求する一方で DSH webServer は既定で loopback にしかバインドしないことを明記しています。先に TLS リバースプロキシの背後に置いてください。

Bearer トークンはどこに保存されますか?

`a2a.json` に平文で保存されます(アウトバウンドの Agent ごとのトークンもインバウンドの `authToken` も同様)。`/a2a/api` のスナップショットは設定済みかどうかだけを返し、値は返しませんが、ファイル権限は自分で管理する必要があります。

対応する 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。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。