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
インストール手順
- 01
Harness 内で: サイドバーの **Plugins** → **Add plugin** → `https://github.com/sorsama/deepseek-harness-relay` を貼り付け → **Install**
- 02
pnpm が git パッケージのビルドスクリプトを確認したら **Allow these scripts and retry** を選び、ビルドが終わったら **Enable now** を選びます
- 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
- 04
ビルド済みパッケージを使う場合: `dsh plugin --profile web add dsh-relay` — 同じコードで `lib/` を含み、ビルドスクリプトは実行されません
$ dsh plugin --profile web add dsh-relay
- 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 統合と能力の範囲
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 の設定や資格情報には決して届きません。
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 自身のポートからリレーのオリジンへのリダイレクトも追加しないでください。デスクトップアプリのウィンドウはリレーの自己署名証明書への遷移を完了できず、その失敗はアプリにとって致命的です。
07関連する DSH ワークフロー
dsh-im
by xmanrui
8 IM 渠道(飞书/微信/钉钉/企微/QQ/Telegram/Discord/WhatsApp)を DSH に統合。QR/凭据、流式返信
dsh-aurabot-qq
by aureth-labs
OneBot v11経由でDSHセッションをQQに接続し、チャット、メディア、記憶、ソーシャル機能を切り替え可能なツールとして公開します。
dsh-qqbot
by tencent-connect
dsh 公式 QQ Bot IM チャネル:WebSocket、QR 绑定、peer 隔离、Markdown 分割返信、slash コマンド
dsh-wechat
by xcisxc29
DeepSeekハーネスのWeChatチャンネル。
08データと出典
dsh-relay is a plugin for the harness's web profile.
dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay
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 のプラグイン。全カタログ・全カテゴリから厳選しました。
