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のフリーズを防ぐために、非ブロッキングワーカースレッドで実行できます。 |
はじめに(クイックステップ)
- コンピュータにプラグインをインストールします
- 公式のDSHデスクトップアプリで、プラグイン →
dsh-mobileを追加して有効にします。または - DSH Webインストールでは、次を実行します:
dsh plugin --profile web add dsh-mobile@latest dsh plugin --profile web exec dsh-mobile setup - 公式のDSHデスクトップアプリで、プラグイン →
- 接続を設定します
- DSHで モバイルアクセス を開き、LANアクセス をオンにします(または選択したリモートトンネルを有効にします)。プラグインはプライベート証明書とQRコードを生成します。
- Androidアプリをインストールします
- リリースページからAPKをダウンロードします(例:
dsh-mobile-android-v0.6.3.apk)。
- リリースページからAPKをダウンロードします(例:
- スマホをペアリングします
- アプリで LAN または リモート を選択し、QRコードをスキャン(または43文字のキーを貼り付け)します。デバイスは信頼され、自動的に再接続します。
- スマホで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から直接取得しています。追加の機能は推測していません。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト