saya-ch/dsh-mobile

DeepSeek Harness 的 Android App 与安全远程访问插件,支持局域网/远程连接和高度自定义的移动界面与扩展能力。

DSH Mobileとは?

DSH Mobile は、DeepSeek のオープンソースのチャットアシスタントプラットフォーム DeepSeek Harness (DSH) のプラグインです。このプラグインは、メインのDSHサーバーがコンピュータ上で稼働し続ける間、Androidスマートフォン(またはスマホのブラウザ)から同じDSHセッション、ワークスペース、チャットを継続できるようにするモバイルアクセスレイヤーを追加します。

  • プラグインはコンピュータ側で動作し、モバイル最適化されたUIを提供する小さなHTTPSゲートウェイ(デフォルト3443)を作成します。
  • Androidアプリ(薄いKotlin WebViewラッパー)またはスマホのブラウザは、LANまたはリモートトンネル(Tailscale Funnel、cpolar、Cloudflare Tunnel、自己ホストFRP、カスタムリバースプロキシ)を介してそのゲートウェイに接続します。
  • ペアリングはQRコードまたは43文字のキーで一度だけ行います。スマホはAndroid Keystoreに資格情報を保存し、自動的に再接続できます。

主な機能

機能 説明
シームレスなセッション同期 モバイルUIには、デスクトップのDSHインスタンスとまったく同じチャット履歴、ワークスペース、ツールが表示されます。
タッチフレンドリーなレイアウト UIコンポーネント(サイドバー、ツール詳細、入力バーなど)は小さな画面向けに再配置されます。アプリはシステム言語に従います。
複数のトンネルオプション LAN、Tailscale Funnel、cpolar、Cloudflare(クイックまたは名前付きトンネル)、自己ホストFRP、独自のHTTPSリバースプロキシから選択できます。
デバイスペアリングと管理 QRコードをスキャンするか、キーを貼り付けます。アプリはペアリングされたすべてのコンピュータを一覧表示し、到達可能性を表示し、再ペアリングまたは削除ができます。
ワンクリック診断 バージョン、ネットワークインターフェース、ファイアウォール、トンネルステータスをチェックし、編集済みレポートを生成します。ブロックされたサードパーティのWebSocketパスを自動的に許可できます。
システム通知 タスク完了と入力要求のアラートがAndroid通知として表示されます(オプション、ロック画面でマスク可能)。
セキュリティ第一の設計 LANゲートウェイはプライベートCAを使用します。リモートゲートウェイは信頼された公開証明書を使用します。資格情報はAndroid Keystoreに保持され、正確なオリジンのみに送信されます。
拡張システム /mobile <request> コマンドを使用して、DSHエージェントに mobile.css、mobile.js を変更したり、コンピュータ側で実行されるJavaScript拡張機能(host.mjs)を追加したりするよう依頼できます。変更は即座にスマホにプッシュされます。
ワーカーモード(オプション) 拡張機能は、UIのフリーズを防ぐために、非ブロッキングワーカースレッドで実行できます。

はじめに(クイックステップ)

  1. コンピュータにプラグインをインストールします
    • 公式のDSHデスクトップアプリで、プラグイン → dsh-mobile を追加して有効にします。または
    • DSH Webインストールでは、次を実行します:
    dsh plugin --profile web add dsh-mobile@latest
    dsh plugin --profile web exec dsh-mobile setup
    
  2. 接続を設定します
    • DSHで モバイルアクセス を開き、LANアクセス をオンにします(または選択したリモートトンネルを有効にします)。プラグインはプライベート証明書とQRコードを生成します。
  3. Androidアプリをインストールします
    • リリースページからAPKをダウンロードします(例:dsh-mobile-android-v0.6.3.apk)。
  4. スマホをペアリングします
    • アプリで LAN または リモート を選択し、QRコードをスキャン(または43文字のキーを貼り付け)します。デバイスは信頼され、自動的に再接続します。
  5. スマホでDSHの使用を開始します
    • アプリには同じチャットワークスペースが表示されます。任意のモバイルブラウザで同じURLを開くこともできます。

モバイルUIの拡張/カスタマイズ

  • 任意のDSH会話でメッセージを送信します:
    /mobile 把手机端做成老式终端的样子,让消息像终端输出一样逐行滚动
    
  • DSHエージェントは要求された変更を $DSH_HOME/mobile-access/(CSS/JSファイルまたは新しい extensions/ フォルダ)に書き込みます。プラグインはこれらのファイルを監視し、数秒以内にスマホに更新をプッシュします。
  • より複雑なロジックのために、ユーザーと同じ権限でコンピュータ上で実行される host.mjs ファイルを持つJavaScript拡張機能を追加できます。
  • オプションの ワーカー モード(拡張機能ごとに有効)は、コードを別のスレッドで実行してUIの応答性を維持します。

セキュリティに関する考慮事項

  • LANモード は信頼できる自宅/オフィスネットワークでのみ使用してください。ゲートウェイはインターネットに公開されていません。
  • リモートトンネル は、公開CA(cloudflare、Tailscale)またはアプリがピン留めするプライベートCAのいずれかでHTTPSを使用します。トンネルバイナリ(cloudflared、cpolar、frpc)は公式リリースからダウンロードされ、SHA-256で検証されます。
  • ペアリングされたスマホはDSHインスタンスを完全に制御できます。信頼できるデバイスとして扱ってください。スマホを紛失した場合は、コンピュータ側ですぐに失効させてください。
  • すべての書き込み操作(設定、拡張機能)は、ペアリングされたセッショントークンとCSRF保護されたオリジンに対してチェックされます。

誰が恩恵を受けるか?

  • ローカルでDeepSeek Harnessを実行し、机を離れても応答性の高いUIを必要とする開発者またはパワーユーザー。
  • 別のDSHサーバーを実行せずに、同じチャットワークスペースをスマホですばやく表示する必要があるチーム。
  • クラウドベースのAIチャットアプリの安全な自己ホスト代替を望み、モバイルアクセスを必要とするすべての人。

上記のすべての情報はリポジトリのREADMEから直接取得しています。追加の機能は推測していません。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト