ディレクトリに戻る

deepseek-harness-relay

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

sorsama/deepseek-harness-relay

DSH Webプロファイルへの認証付きリモートアクセス。TLS、QR/パスコードでのデバイスペアリング、パスワードログイン、デバイス単位の失効を、loopbackハーネスの前面で提供。

GitHub で見るホームページ
$ dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay

17

スター

6

フォーク

TypeScript

言語

MIT

ライセンス

2026-08-21

作成日

2026-11-09

最終プッシュ

MIT の TypeScript プラグイン。手を加えていないループバックの DeepSeek Harness の手前に HTTPS・パスワードサインイン・QR / 8 桁コードのデバイスペアリングを置き、mDNS 広告、デバイス単位の失効、2 台の PC のワンクリックリンクを加えます。

DSH 統合

ネイティブ実行

作者による申告

安全性監査

未監査

最終検証日

2026-11-16

ライセンス

MIT

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

  • Harness を Wi-Fi 全体に開かずに、スマホや別の PC から使う

    リレーのポートで TLS・パスワード検証・デバイスペアリングを行い、Harness は 127.0.0.1 のまま。リレーが落ちても Harness は「届かない」だけで、露出はしません

    ノート PC やデスクトップで Harness の web プロファイルを動かし、0.0.0.0 にバインドせずにスマホやタブレット(またはポート転送経由の外部)から使いたい人

  • デバイスを 1 台ずつペアリングし、あとから個別に切り離す

    `/relay/devices` に名前と専用トークンで並ぶデバイス、デバイス単位の失効、署名鍵をローテーションする「全デバイスからサインアウト」ボタン

    1 つのリレーをスマホ・タブレット・2 台目の PC で共有し、それぞれを個別に失効させたい人

  • 2 台の PC をリンクし、どちらからでも相手の Harness をワンクリックで開く

    両方の Computers ページに並ぶペアと、**Open** でこのブラウザに発行されるワンタイムのサインイン(パスワードの再入力は不要)

    デスクトップとノートの両方で dsh-relay を動かし、デスクトップアプリではなくブラウザで使う人

02DeepSeek Harness への導入方法

前提条件

  • web プロファイルの DeepSeek Harness — リレーはそのプロファイル向けのプラグインで、デスクトップアプリも同じプロファイルで動きます
  • Harness はループバックのまま: `~/.dsh/profiles/web/cordis.patch.yml` で `0.0.0.0` にバインドしている行を削除してください。ネットワークに開いた Harness の前ではリレーは起動しません
  • `dsh` が PATH にあること(なければすべてのコマンドを `npx @deepseek-ai/dsh ...` で実行)
  • Harness に合うリレーのビルド — Harness 0.1.7-rc.2〜0.2.x には 0.3

インストール手順

  1. 01

    Harness 内で: サイドバーの **Plugins** → **Add plugin** → `https://github.com/sorsama/deepseek-harness-relay` を貼り付け → **Install**

  2. 02

    pnpm が git パッケージのビルドスクリプトを確認したら **Allow these scripts and retry** を選び、ビルドが終わったら **Enable now** を選びます

  3. 03

    ターミナルから: `dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay`(デスクトップアプリは `dsh plugin --profile desktop add https://github.com/sorsama/deepseek-harness-relay`)

    $ dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay

  4. 04

    ビルド済みパッケージを使う場合: `dsh plugin --profile web add dsh-relay` — 同じコードで `lib/` を含み、ビルドスクリプトは実行されません

    $ dsh plugin --profile web add dsh-relay

  5. 05

    Harness を動かしているマシンで `https://127.0.0.1:3443/relay/password` を開いて最初のパスワードを設定し、`https://127.0.0.1:3443/relay/pair` で QR コードか 8 桁コードを使ってスマホをペアリングします

導入成功の確認

  • `https://127.0.0.1:3443/relay/health` がリレー起動後に応答します
  • Harness は起動時にリレーのアドレスを表示します。デスクトップアプリではプラグインを有効化したあと終了して開き直します
  • ペアリングしたスマホは付けた名前で `/relay/devices` に現れます

03DSH 統合と能力の範囲

DSH 統合ネイティブ実行

Harness の web プロファイル向けネイティブ DSH プラグイン — `dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay` で導入すると :3443 に自前のリスナーを立て、**Relay** アクション、`/relay/*` のページ群、**Plugins → dsh-relay → Configure** の設定ページを Harness UI に加えます

  • TLS 終端とパスワードサインイン

    ネットワーク上のスマホやブラウザからの HTTPS リクエスト→パスワード(またはペアリング済みデバイスの資格情報)が通った場合だけセッションを発行。誤入力が多いとそのアドレスは一定時間ロックされます

    Harness はループバックのまま、リレーが隣の 2 つ目のリスナーとして動きます
  • QR コード / 8 桁コードによるデバイスペアリング

    QR スキャン、またはスマホで 8 桁コードを入力し、デバイスに名前を付ける→`/relay/devices` に並ぶ、専用トークンを持つ名前付きデバイス

    ペアリングしたデバイスは `/relay/devices` に記録され、個別に失効できます
  • `_dsh._tcp` の mDNS 広告

    リレーが `_dsh._tcp` で広告され、アプリはサブネットをスキャンせずに見つけられます

  • Harness UI 内の Relay ページ

    そのままの Harness UI に、隅の **Relay** リンクとサイドバー下部の **Relay** アクションが加わります

    **Relay** を押すと、同じウィンドウのままアプリがリレーのペアリング・デバイス・パスワードのページに切り替わります
  • Computers:2 台の PC をワンクリックでリンク

    相手 PC のアドレス、ペアリングコード、証明書ピン→両方の Computers ページにペアが並び、**Open** でこのブラウザがワンタイムサインインで相手の Harness に移動します

    ペアは両方の PC に記録され、どちらかで **Unlink** すると終了します

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

向いている用途

  • ノート PC やデスクトップで Harness の web プロファイルを動かし、0.0.0.0 にバインドせずにスマホやタブレット(またはポート転送経由の外部)から使いたい人
  • 1 つのリレーをスマホ・タブレット・2 台目の PC で共有し、それぞれを個別に失効させたい人
  • デスクトップとノートの両方で dsh-relay を動かし、デスクトップアプリではなくブラウザで使う人

不向きな用途

  • リレーは Harness がループバックにいる前提でのみ意味を持ちます。Harness がすでにネットワークアドレスで待ち受けていると起動を拒否し、ループバックは本人として扱うため、`127.0.0.1:3443` の前段にループバック経由のプロキシ(Tailscale Funnel / Serve、nginx、Caddy)を置くとパスワードを一度も要求しません。
  • デスクトップアプリでは、Harness 自身のポートからリレーのオリジンへのリダイレクトを決して追加しないでください。アプリのウィンドウはリレーの自己署名証明書への遷移を完了できず、その失敗はアプリにとって致命的です。デスクトップアプリは遠隔の Harness を読み込むこともできません。
  • Harness とリレーのバージョンは一致が必要です。README は Harness 0.1.7-rc.2〜0.2.x に dsh-relay 0.3 を対応させており、範囲が合わないプラグインは Harness が読み込みを拒否します。
  • DSH Mobile 0.8.0 より前のクライアントは資格情報を一切送らないため、リレーはスマホのネットワークアドレスを覚えて通すしかなく、README はこれを本物の認証ではないと明記しています。別途立てる平文 HTTP リスナー(`DSH_RELAY_PLAIN_PORT`)にはサインインもペアリングのページもなく、Harness の設定や資格情報には決して届きません。

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

  • リレーは Harness がループバックにいる前提でのみ意味を持ちます。Harness がすでにネットワークアドレスで待ち受けていると起動を拒否し、ループバックは本人として扱うため、`127.0.0.1:3443` の前段にループバック経由のプロキシ(Tailscale Funnel / Serve、nginx、Caddy)を置くとパスワードを一度も要求しません。
  • デスクトップアプリでは、Harness 自身のポートからリレーのオリジンへのリダイレクトを決して追加しないでください。アプリのウィンドウはリレーの自己署名証明書への遷移を完了できず、その失敗はアプリにとって致命的です。デスクトップアプリは遠隔の Harness を読み込むこともできません。
  • Harness とリレーのバージョンは一致が必要です。README は Harness 0.1.7-rc.2〜0.2.x に dsh-relay 0.3 を対応させており、範囲が合わないプラグインは Harness が読み込みを拒否します。
  • DSH Mobile 0.8.0 より前のクライアントは資格情報を一切送らないため、リレーはスマホのネットワークアドレスを覚えて通すしかなく、README はこれを本物の認証ではないと明記しています。別途立てる平文 HTTP リスナー(`DSH_RELAY_PLAIN_PORT`)にはサインインもペアリングのページもなく、Harness の設定や資格情報には決して届きません。
2026-08-212026-11-09v0.4.0

MIT · 最新リリース v0.4.0(2026-11-09)· 開発継続中、README は Harness 0.1.7-rc.2〜0.2.x で検証済み

06よくある質問

dsh-relay はどうやって DeepSeek Harness に導入しますか?

サイドバーの **Plugins** を開き、**Add plugin** を選び、`https://github.com/sorsama/deepseek-harness-relay` を貼り付けて **Install** を押します。初回は一時コピー内でビルドが走るため、pnpm の確認には **Allow these scripts and retry** を選び、完了したら **Enable now** を押します。ターミナルでも同じ URL が使え(`dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay`、デスクトップアプリなら `--profile desktop`)、ビルド済みの npm パッケージは `dsh plugin --profile web add dsh-relay` でビルドスクリプトなしに導入できます。

対応する Harness のバージョンは?

README の表では Harness 0.1.7-rc.2〜0.2.x に dsh-relay 0.3 が対応します(0.2.1-rc.3、0.2.0-rc.2、0.1.7-rc.2 でテスト済み)。合わないバージョンを入れると Harness は読み込みを拒否し、必要な範囲を表示します。0.3 は Harness 0.1.7 で追加された設定システムに依存し、0.2 は 0.1.7 以降で web アプリが止まるため、両者は重なりません。

パスワードを設定する前に、同じネットワークの誰かにリレーを取られませんか?

取られません。パスワードが存在しない間、そのページは Harness を動かしているマシンからしか開けません。そのマシン自体もパスワードを要求されません。キーボードの前にいる人はすでにシェルを持っているので、リレーはループバックを本人として扱います。

ペアリングしたデバイスは何ができ、どう切り離しますか?

ペアリングしたデバイスはそれぞれ専用トークンを持ち、`/relay/devices` に並ぶので個別に失効できます。コードは使い捨てで 5 分で失効し、Harness を動かしているマシンでしか作成できません。**全デバイスからサインアウト** ボタンは署名鍵をローテーションし、すべてのブラウザとデバイスを一度にログアウトします。

Tailscale や nginx、Caddy の背後に置けますか?

置かないでください。これらのプロキシはループバックから接続し、リレーはループバックを本人として扱うため、パスワードを誰にも要求しません。インターネットに公開する場合、README はリレーのポートだけを転送し(Harness のポートは転送しない)、本物の証明書を使い、`compat.addressGrants: false` と `privilegedMethods: loopback-only` を設定するよう求めています。Harness 自身のポートからリレーのオリジンへのリダイレクトも追加しないでください。デスクトップアプリのウィンドウはリレーの自己署名証明書への遷移を完了できず、その失敗はアプリにとって致命的です。

08データと出典

  • 作者による申告github.com62d7315bce02…

    dsh-relay is a plugin for the harness's web profile.

  • 作者による申告github.com62d7315bce02…

    dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay

  • 作者による申告github.com62d7315bce02…

    A settings page at **Plugins → dsh-relay → Configure** on the machine running the harness. Changes apply when you press…

このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-16。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

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

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

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