ds-harness-remote-fast/README.ja.md

27 KiB
Raw Blame History

DeepSeek Harness Remote

English  ·  中文  ·  日本語

ドキュメント Web Android iOS

npm License: MIT セルフホスティング dshfind ダウンロード数

liguobao%2Fds-harness-remote | Trendshift

一度つなげば、いつでも使える

スマートフォン、パソコン、ブラウザーから、お使いの DeepSeek Harness をそのまま利用できます。どのデバイスからでも、同じ Harness セッションの続きを始められます。

Harness は作業用パソコン上で動作し続け、ワークスペース、ツール、プロジェクト設定もそのままです。DS Harness Remote は、その環境にアクセスするためのもう一つの窓です。

DeepSeek Harness デスクトップ版に対応しています。最新リリースをインストールしてください。

ds-harness-remote@0.6.5

主な機能

  • Web、パソコン、モバイル端末からローカルの Harness にアクセスできます。DSH を中心に、Codex、Cursor、Antigravity にも対応しています。
  • DeepSeek Harness Desktop に対応し、インストール後すぐにネイティブ UI を利用できます。独自のデスクトップ会話 UI は追加しません。
  • ワークスペースの作成、モデルの設定、会話モデルの切り替えを、ローカルと同じ流れで行えます。
  • Harness Host に公開待ち受けポートやパブリック IP は不要です。インターネット接続があれば、双方向のエンドツーエンド暗号化チャネルでどこからでも接続できます。
  • P2P 接続を優先し、世界各地の TURN 中継ノードを利用できます。必要に応じて複数の Server Relay にフォールバックします。
  • ネイティブの Harness サイドバーから、ワークスペースのファイル、読み取り専用プレビュー、リモートターミナル、許可されたローカル開発サービスのプレビューにアクセスできます。
  • Remote Tool のコンテキスト注入により、Host とワークスペースの検出、Harness セッションの作成・管理、履歴の読み取り、実行待機、中断要求、許可されたファイルの転送が可能です。詳細。
  • DeepSeek Harness に加え、ACP 連携を通じて Codex、Cursor、Google Antigravity、Pi、OpenCode、Claude Code、Harness Agent などのネイティブワークスペースを利用でき、リモートファイル閲覧やターミナルにも対応します。
  • Android、iOS、Web、ネイティブ DSH 向けのクライアントを提供しています。
  • 複数のクライアントから同じ Harness Host に同時接続でき、RPC 呼び出しとストリームは接続ごとに分離されます。

対応クライアント

クライアント 形式 状態 備考
DSH プラグイン Remote サイドバー 対応 他のデバイスを操作する側にも、操作される Host 側にも自由に使えます!
Web ブラウザーページ 対応 https://dsh.r2049.cn を開きます。ネイティブの Harness UI を再利用します
Android ネイティブアプリ 対応 Releases から APK をダウンロードできます。Android ガイドを参照してください
DSH Go ccch1mneyyy 氏の力作 対応済み 詳細:ccch1mneyyy/dsh-go: スマートフォンで直接実行したり、パソコン上の DSH をリモート操作したりできます。
iOS TestFlight ベータ ベータ 一般公開はまだ行っていません。Issue #20 を参照してください
dsh-TUI 独立 Host バンドル + CLI 主要な実機検証済み 同じバージョンの ds-harness-remote-tui を導入。検証範囲を参照。Web サービスは自動作成されません
Linux クラウドサーバー 対応 公式サイトにログインすると、ワンコマンドでインストールできます。

複数のクライアントから同じ Host に同時接続できます。RPC 呼び出しとストリームは接続ごとに分離されます。

インストール

DeepSeek Harness Desktop

DeepSeek Harness Desktop の Extensions / Plugin management を開き、npm からのインストールを選択して、次のパッケージを入力します。

ds-harness-remote@0.6.5

インストール後に Desktop を再起動してください。公式の dsh ランチャーでも、dsh plugin --profile desktop add -w ds-harness-remote@0.6.5 を実行して指定バージョンをインストールできます。

DSH 0.2.2 以降では、npm からインストールしたプラグインのバージョン確認とワンクリック更新をプラグイン管理画面から行えます。ホットアップデートに失敗した場合、DSH は旧バージョンへの復元を試みます。GitHub/ローカル link からのインストールは、先に npm に切り替える必要があります。オンライン更新の説明を参照してください。

Linux ワンコマンドインストール

公式サイトにログインし、ワンコマンドインストール用の認可コードを取得してインストールしてください。

ネイティブ Android クライアント

複数のワークスペースで同時に接続して会話を続けられます。Fei2411/DS-Bot を利用した Bot モードも搭載しています。

GitHub Releases から最新の APK をダウンロードし、同じアカウントでログインすると Host が表示されます。

DSH Go — DeepSeek Harness をポケットに。スマートフォンで実行し、パソコンもリモート操作。

ccch1mneyyy/dsh-go は ds-harness-remote プロトコルを内蔵しており、スマートフォン上で DeepSeek Harness を実行したり、パソコンにリモート接続したりできます。

スマートフォンの DSH Go に ds-harness-remote プラグインをインストールすると、パソコンや Web からスマートフォン上の DSH にもリモート接続でき、Mobile Use をスムーズに利用できます。

iOS クライアント

クイックスタート

  1. DeepSeek Harness のサイドバーから Remote を開きます。
  2. 知乎、GitHub、Google の認可ログイン、またはアカウントとパスワードでログインします。アカウント登録には招待コードが必要です。リポジトリの作者にメールで申請できます。
  3. 別のデバイスの DeepSeek Harness に同じプラグインをインストールし、手順 1〜2 と同じ方法でログインします。Remote Web、iOS、Android、DSH Go のクライアントなら、プラグインのインストールなしですぐに利用できます。
  4. オンラインの Host を選び、既存のワークスペースを選択するか、リモートのディレクトリを参照して開きます。

デフォルトでは、本プロジェクトが運営する Server https://dsh.r2049.cn を使用します。

セルフホスティングには、このリポジトリの最小構成 Server を利用できます。現在のバージョンには WebRTC の LAN/P2P/TURN 接続調整(TURN は別途 coturn のデプロイが必要)と暗号化 Relay Server が含まれますが、ホスト型 Remote Web の全機能は提供しません。

スクリーンショット

Desktop

別のパソコンでオンラインの Host を選び、そのワークスペースを開きます。ネイティブの Harness UI で開かれ、ヘッダーに接続先の Host と暗号化接続の状態が表示されます。

オンラインの Host を表示する Remote ワークスペース選択画面 暗号化されたリモート接続で利用する Harness の会話画面

このパソコンから他の Host を操作できないようにするには、https://dsh.r2049.cn/ のホスト一覧で「被操作専用(仅被控)」を有効にしてください。このデバイスからは同じアカウントの他のデバイスが見えなくなりますが、Web や他のクライアントからこのデバイスへのリモート接続は引き続き利用できます。

Android

テキストや画像のプロンプト送信、モデルの切り替え、対応するワークスペースのファイルやターミナルへのアクセスが可能です。

オンラインとオフラインのパソコンを表示する Android クライアント Android クライアントから画像プロンプトを送信 Android クライアントで画像への応答を表示

モバイルの設定には、全体に適用される Compact conversations(会話のコンパクト表示)スイッチがあります。デフォルトは無効で、次に会話を開くときに反映されます。

対応する Host は、メッセージとツールの状態を保持したまま、履歴のツール詳細を短縮します。設定を無効にして会話を開き直すと、完全な履歴を読み込めます。

仕組み

DSH Desktop / Remote Web / Android
  ↔ 認証済みのエンドツーエンド暗号化チャネル
Host 上の Remote プラグイン
  ↔ 対応する Harness またはオプションの Codex ワークスペース連携
Harness のセッション/ワークスペース、または Codex のプロジェクト

Harness Host に公開待ち受けポートは不要です。インターネット接続があれば、ds-harness-remote の双方向エンドツーエンド暗号化チャネルでどこからでも接続できます。

クライアントの接続先を選択した Host のネイティブ Harness API に切り替えるため、元のワークスペース、ツール、権限確認の流れはそのパソコン上に残ります。

Host 上の Harness やプラグインの設定もリモートで変更できます。編集できる項目は、Harness と各プラグインが公式設定 API で公開している内容によって異なります。

実験的な ACP ワークスペース

Host はローカルの ACP 対応 Agent を起動し、ds-harness-remote を通じてプロンプト、ストリーミング応答、承認要求を転送します。各 Agent は自身のワークスペースとセッションを使用し、DSH 向けのセッション変換のみを行います。Harness のストレージには書き込みません。

対応バックエンド:

  • Codex — App Server 経由で接続し、共通のワークスペース入口から利用できます。
  • Cursor — CLI の ACP インターフェース経由で接続します。
  • Antigravity(AGY) — CLI の stream-json インターフェースをアダプター経由で接続します。
  • Pi Agent(実験的) — Pi と pi-acp のインストール・設定後に自動検出され、設定で無効化できます。ツールは Host ユーザーの権限で実行され、デフォルトではツールごとの確認はありません。
  • OpenCode — opencode acp 経由でワークスペースと履歴を利用できます。会話のアーカイブには認証 API を提供するバージョンが必要で、アーカイブ解除は未対応です。
  • Claude — ローカル認証済みの claude-agent-acp 経由で接続し、設定で有効化します。テキストと承認に対応し、画像は未対応です。
  • Hermes — hermes acp 経由で接続し、設定で有効化します。テキスト、画像、ストリーミング出力、承認、モデル選択に対応します。

Claude と Hermes はファイルとターミナルへの直接アクセスにも対応し、Host のワークスペース境界とターミナル設定に従います。

セットアップとアダプター開発については、Agent ワークスペース連携ガイドを参照してください。

Desktop/Android での Cursor、Claude、Hermes、Pi、OpenCode、AGY のモデル選択には Host の実際のモデル一覧を使用し、Agent の ACP インターフェースに従います。

推論の強度(Effort)の選択肢は、バックエンドが実際に提供するものに従います。Cursor はセッションごとに別のプロセスを使用するため、モデルの変更が他の会話に影響することはありません。

エンドツーエンド暗号化

Harness の業務データはクライアントで暗号化され、選択した Host でのみ復号されます。暗号スイートは Noise_IK_25519_ChaChaPoly_SHA256 に固定されています。

接続には、同一アカウントへの所属関係と、ローカルに固定されたデバイス識別鍵の両方の検証が必要です。

サービスは接続の調整と必要なネットワークメタデータの確認を行えますが、セッションメッセージ、プロンプト、ツール出力、ワークスペースのパス、リモートファイルの内容は読み取れません。

ハンドシェイク、鍵のライフサイクル、可視メタデータ、リプレイ対策、セキュリティ上の制限は、エンドツーエンド暗号化を参照してください。

ネットワークと通信方式

Host は外向きの接続のみを開始し、公開ポートで待ち受けません。ルーターのポート転送も不要です。

Remote は LAN -> P2P -> TURN -> Relay の順で通信経路を選びます。

WebRTC が利用できない場合や接続できない場合は、暗号化された WebSocket Relay にフォールバックします。

すべての経路で同じ Noise 暗号文を転送し、Host/Client の識別・認可の境界を維持します。

構成、制御・データプレーン、NAT の動作、フォールバック、再接続の仕様、現在の検証状況は、ネットワークと通信方式を参照してください。

セキュリティ

  • LAN・P2P 接続では、接続調整の指示を除き、データは Server を経由しません。TURN はオープンソースの coturn サーバーを使用し、Relay モードは WebSocket で転送します。
  • セッションの通信はエンドツーエンドで暗号化されます。サービスは暗号文を中継し、セッションの平文やデバイスの秘密鍵を保存しません。
  • 同一アカウントのデバイスは追加確認なしで接続できます。詳細はデバイスの信頼と権限を参照してください。
  • Remote Tools の注入:オプションの remote_* セッションツールです。デフォルトで有効で、Remote の詳細設定から変更できます。
  • 対話型ターミナルは Host ローカルの terminal.enabled 設定を使用します(デフォルトは有効)。Agent の承認とは独立して、Host ユーザーの権限で動作します。
  • 汎用ツール RPC とリモートデスクトップは公開していません。
  • ワークスペース選択画面はフォルダーのみを一覧表示し、上限付きの読み取り専用ディレクトリメタデータを返します。
  • リモートファイルプレビューから、書き込み、削除、アップロード、実行、外部アプリでパスを開く操作はできません。
  • Codex Remote / Agent ACP はオプションで、無効化できます。Remote の他の機能と同じ暗号化・Host 権限の境界に従います。
  • デバイスを削除すると、その認証情報、所属関係、有効な Remote 接続が失効します。

よくある質問

パブリック IP やポート転送は必要ですか?

いいえ。Host は外向きの接続のみを開始し、公開ポートでは待ち受けません。

サービス運営者は会話を読めますか?

いいえ。サービスは暗号文のみを中継します。ルーティング、認可、オンライン状態の管理、レート制限には、アカウントとデバイスの所有関係、オンライン状態、接続時刻、connectionId などの制御メタデータが必要です。一方、プロンプト、会話内容、ツールの入出力、ワークスペースのパス、ファイルプレビューの内容は読み取れません。

どのマシンを Host にできますか?

Remote プラグインをインストールしてログインした Harness インスタンスなら、Windows、macOS、Linux、さらには DSH Go でも Harness Remote Host として利用できます。

複数のデバイスから同じ Host に同時接続できますか?

現在、同時接続台数に制限はありません。複数のクライアントが同時接続でき、RPC 呼び出しとストリームは接続ごとに分離されます。

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

現在の基準バージョンは dsh-v0.2.2-rc.1 です。dsh-v0.2.1-rc.5 と 0.2.0 rc.2 / rc.1 は同じ公式 carrier 上で引き続き互換です。互換性ガイドを参照してください。

Host プラグイン、同梱の Remote クライアント、Android では、Harness 0.1.1-rc.2 の ApiProxy 対応を削除しました。公式の Typert Remote carrier を提供する Host を使用してください。ApiProxy のみを提供する Host や機能検出に対応しない旧 Host への接続は拒否され、フォールバックは行いません。

CodeX/ACP は独立したデータプレーンを維持し、Desktop のメモリ内表示には Typert を使用します。

Linux インストーラーに root 権限が必要なのはなぜですか?

systemd のシステムサービスを設定するためです。そのため Host、Agent のツール、リモートターミナルは root 権限で動作します。信頼できるアカウントにのみアクセスを許可してください。

iOS アプリを直接インストールできますか?

現在は TestFlight ベータで、一般公開はまだ行っていません。Issue #20 を参照してください。

frp、トンネル、リモートデスクトップとの違いは?

一般的な Server 経由の TCP ポート転送では、通信が Server を経由するため、その帯域幅がボトルネックになり得ます。

本プロジェクトは 4 つの接続方式を順番に試し、複雑なネットワーク環境でも P2P 直接接続を確立できるようにします。

リモートデスクトップでは、パソコンの画面全体を取得してクライアント側で再現するため、上り・下りの帯域幅とパソコンの処理性能が必要です。

本プロジェクトは、ネイティブの Harness 会話 UI に必要なメッセージのみを暗号化してリモートに送信します。汎用ツール RPC やデスクトップ操作は公開せず、権限と承認は Host 側に残ります。

Tailscale、CF Turn、UU Remote も優れたソリューションです。用途に合わせてお選びください。

おすすめのプラグイン

Intelligent UI

Intelligent UI を使うと、モデルがカード・表・グラフ・フォームで回答できます。Android クライアントはこれらをネイティブ表示し、プラグイン → Remote 対応 に表示されたプラグインのオン・オフやライブ設定を変更できます。

Fei2411/DS-Bot

DS Bot は DeepSeek Harness(dsh)を bot として利用できるようにするプラグインです。自分で作成した bot と会話したり、作業したりできます。

ドキュメント

関連リンク

  • 関連プロジェクト: DSH Go — DeepSeek Harness をポケットに。スマートフォン上で直接実行でき、パソコンのリモート操作も可能です。Remote 連携に対応しています。
  • 関連プロジェクト: dsh-TUI — ターミナル優先の Harness クライアントです。Remote Host 連携には独立した ds-harness-remote-tui バンドルを使用します。
  • 相互リンク: LINUX DO
  • 相互リンク: Cyber Liu Kanshan

Star History

GitHub スター数の推移

コントリビューター

ds-harness-remote は、オープンソースコミュニティの力によって育まれているプロジェクトです。優れたツールはコードだけで作られるのではなく、実際に試し、フィードバックを送り、アイデアを共有してくれるすべての人々と共に形作られると信じています。

開発経験の有無にかかわらず、あらゆる形での参加を歓迎しています:

  • Issue の起票:不具合の報告、新機能の提案、操作性に関するアイデアなど、どんな気づきでも歓迎します。
  • ドキュメントと多言語対応:利用ガイドの改善、表現のブラッシュアップ、英語・中国語・日本語ドキュメントの同期支援。
  • 実機テストとフィードバック:お使いの環境(Desktop / Web / Android)で動作を試し、実際の使用感を教えてください。
  • コードの作成とレビュー:バグ修正、新機能の実装、またはコミュニティから寄せられた Pull Request のレビュー。

コントリビューター一覧

このプロジェクトを支えてくださるすべての素晴らしいコントリビューターに、心から感謝申し上げます!

接続のトラブルシューティング

Android:問題を再現した後、設定 → 診断 → 接続ログをエクスポート を開き、保存先のフォルダーを選んで .txt ファイルを保存します。ログには現在のアプリプロセスの起動以降、直近 500 件の接続診断が保持されます。アプリを再起動すると消去され、認証情報や会話内容は含まれません。

Host:プラグイン → Remote 設定 で Debug ログ を有効にします。設定は即座に反映され、保存されます。調査後は無効にしてください(info レベルに戻ります)。ログには [ds-harness-remote] の接頭辞が付き、Desktop では desktop.log で確認できます。手動設定では logLevel: debug を指定できます。

プロジェクトの位置づけと商標

本プロジェクトは独立したコミュニティプロジェクトであり、DeepSeek の公式製品ではありません。 DeepSeek および関連する名称・商標は、それぞれの権利者に帰属します。

ライセンス

MIT