Soodok/Deepseek-Harness-Local-Android

解決する課題

Android で AI エージェントを実行するには、従来は Termux のセットアップ、依存関係のインストール、または完全な Linux ディストリビューションを備えた proot コンテナの使用が必要でした。このプロジェクトは、公式の DeepSeek Harness エンジン、その Node.js ランタイム、および 19 の環境ツールチェーンを単一の APK にバンドルすることで、その煩わしさを排除します。インストールするだけで即座に動作します。root も Termux も PC も不要です。セッション、認証情報、ワークスペースはすべてアプリのサンドボックスまたはアプリのプライベート外部ディレクトリに保存されるため、リモートモデル API を明示的に設定しない限り、データはスマートフォンに留まります。

仕組み

このアプリは、公式の dsh エンジン（0.2.1-rc.2 に固定）と、bionic（Android ネイティブ）Node.js ランタイムを組み込んでいます。エンジンはループバックアドレス 127.0.0.1:3083 のみをリッスンし、すべての操作はトークンで保護されたケイパビリティブリッジを介して行われます。指数バックオフ監視を備えたフォアグラウンドサービスが、エンジンをバックグラウンドで稼働させ続けます。Python、Go、Rust、Git、FFmpeg などのコマンドラインツールをワンタップでダウンロードおよびアンインストールできる拡張センターが含まれています。依存関係は解決され、SHA-256 で検証され、アトミックにリリースされます。また、@tiphareth/dsh-hardssh プラグインを介した SSH リモートワークスペースも同梱されており、リモートディレクトリをバインドして、サーバー上で読み取り/書き込み/編集/bash コマンドをスマートフォンから直接実行できます。画面自動化は、21 のアクションプリミティブ（タップ、スワイプ、スクロール、ドラッグ、入力など）を提供するアクセシビリティサービスを介して実現され、選択 → 実行 → 検証 → 再試行のローカルクローズドループと、OCR やアイコン認識などの視覚的なフォールバックを使用します。LAN WebUI プロキシを使用すると、ワンタイム 6 桁のコードでコンピューターからネイティブ Web インターフェースにアクセスできます。音声入力はシステム認識を使用し、オプションで OpenAI 互換 API をフォールバックとして使用できます。権限モードは 3 段階です：通常（サンドボックス）、Shizuku（adb レベル）、root（uid 0）。su ゲートや二重確認などの安全対策が施されています。

対象読者

これは、Android スマートフォンで完全にポータブルな AI エージェントワークステーションを望む開発者やテクノロジー愛好家を対象としています。デスクトップから離れているときにリモートサーバーでコードを編集、テストの実行、ログの監視を行う必要がある管理者にも役立ちます。デフォルトの通常モードは、ほとんどの日常的なニーズをカバーします。root または Shizuku は、より深いデバイス制御を必要とするユーザー向けのオプションの上級レベルです。

ハイライト

• ワンクリックインストール：すべて（エンジン、ランタイム、ツールチェーン）が APK にプリビルドされており、初期ダウンロードや環境設定は不要です。
• 公式 dsh エンジンを完全移植し、プラグインシステム、WebUI、ツール呼び出しチェーンを保持。
• 19 の環境拡張（Python、Go、Rust、Clang、OpenJDK、Git など）をオンデマンドでインストールまたはアンインストール可能。
• 内蔵 SSH リモートワークスペース：Web ターミナル、ファイルアップロード/ダウンロード、ローカルポートフォワーディング、リモートコマンド実行に対応。
• 21 のアクションプリミティブとローカル検証ループを備えた画面自動化（測定値：1 ステップあたり約 1.45 秒、コンパクト検証は約 5 ミリ秒）。
• ランダム生成された 6 桁のアクセスコードと永続通知を備えた LAN WebUI プロキシで、リモートデスクトップアクセスが簡単。
• 音声入力：編集可能なトランスクリプト、重複排除、バックグラウンド送信に対応。
• 3 つの権限モード（通常 / Shizuku / root）と厳格な安全対策。通常モードがデフォルトで、特別な設定は不要です。