ディレクトリに戻る

dsh-android

キュレーション掲載メンテナンス: 活発

zseven-w/dsh-android

DeepSeek Harness を Android で動かすプラグイン。adb 経由でエミュレータや USB 接続デバイスの画面ストリームを、会話の中で直接ビルド・実行・操作できます。

GitHub で見る
$ dsh plugin --profile web add @zseven-w/dsh-android@latest

116

スター

8

フォーク

TypeScript

言語

MIT

ライセンス

2026-08-21

作成日

2026-08-21

最終プッシュ

DeepSeek Harness のネイティブプラグイン。実機 Android(エミュレータまたは USB)を会話にライブストリームし、署名付きプロセス内ルートで 20 個の adb 駆動 agent ツール——スクリーンショット・UI タップ・Gradle ビルド実行・OCR・logcat・診断——を提供します。

DSH 統合

ネイティブ実行

作者による申告

安全性監査

未監査

最終検証日

2026-08-25

ライセンス

MIT

01どんなタスクに使えるのか?

  • DSH の会話の中から実機 Android エミュレータや USB 接続のスマホを直接操作する

    プロセス内のライブデバイスストリームに加え、スクリーンショット・UI タップ・Gradle ビルド実行・OCR・logcat・プロセス調査の 20 個の agent ツール

    DeepSeek Harness を離れずに Android アプリを構築・実行・検査したいモバイル開発者と agent

  • 端末上で Gradle アプリをビルド・インストール・起動する

    ./gradlew assembleDebug で構築した debug APK を adb install -r でインストールし、パネル上でライブに起動

    ビルド&実行のループを agent に任せたい Android エンジニア

  • ビジョンとデバッグツールで UI・テキスト・ログを検査する

    要素タップ付きの uiautomator UI ツリー、テキスト向け OCR 検索 / タップ / 待機、logcat スナップショットまたはフォロー、プロセスバックトレース、meminfo

    実機の UI と状態を駆動・観察したい QA ・自動化エンジニア

02DeepSeek Harness への導入方法

前提条件

  • Node ≥ 24.11.0。
  • adb(Android SDK platform-tools 由来。ADB 環境変数・PATH・ANDROID_HOME の順で解決)
  • 端末:任意のエミュレータ、または USB デバッグ有効なスマホ。
  • Web パネル用の DSH ≥ 0.1.0-rc.6(web bundle 付き)。
  • OCR は macOS ホスト限定(android_find_text / android_tap_text / android_wait_for のみ必要)

インストール手順

  1. 01

    $ dsh plugin --profile web add @zseven-w/dsh-android@latest

  2. 02

    $ dsh web

  3. 03

    pnpm add @zseven-w/dsh-android

導入成功の確認

作者は未記載

03DSH 統合と能力の範囲

DSH 統合ネイティブ実行

DeepSeek Harness のネイティブプラグイン:dsh CLI で導入すると、adb ベースの 20 個の agent ツールとプロセス内のライブデバイスストリームを Web 会話に登録する。

  • ライブデバイスストリームとサイドバーパネル

    オンラインの adb シリアルまたは AVD 名プロセス内の multipart/x-mixed-replace PNG ストリームを常駐サイドバーパネルに描画

    ストリーム中は `adb exec-out` によるスクリーンキャプチャ子プロセスを常駐させる
  • Gradle ビルド&実行

    Gradle プロジェクトのパス./gradlew assembleDebug で構築した debug APK を adb install -r でインストールし、端末上で起動

  • UI ツリー・要素・OCR タップ

    resource-id / テキスト / content-description または OCR 画面クエリuiautomator の UI ツリー節点、要素中心のタップ、OCR 検索 / タップ / 待機の結果

  • ログ・プロセス・診断

    デバイスシリアルと任意の bundle_id / フィルタlogcat スナップショット / フォロー、実行中プロセス一覧、ANR / クラッシュバックトレース、meminfo、アプリ情報

04誰に向いているのか?使うべきでない場面は?

向いている用途

  • DeepSeek Harness を離れずに Android アプリを構築・実行・検査したいモバイル開発者と agent
  • ビルド&実行のループを agent に任せたい Android エンジニア
  • 実機の UI と状態を駆動・観察したい QA ・自動化エンジニア

不向きな用途

  • OCR ツール(android_find_text / android_tap_text / android_wait_for)は Apple の Vision フレームワークを搭載した macOS ホストが必要。Linux / Windows では「OCR は macOS Vision フレームワークが必要」と報告され、他の 17 ツールは影響を受けない。

05互換性・メンテナンス・セキュリティ上の注意

  • OCR ツール(android_find_text / android_tap_text / android_wait_for)は Apple の Vision フレームワークを搭載した macOS ホストが必要。Linux / Windows では「OCR は macOS Vision フレームワークが必要」と報告され、他の 17 ツールは影響を受けない。
  • 非 ASCII / CJK / 絵文字の入力には端末側で任意の ADBKeyboard IME が必要。`adb shell input text` は ASCII のみ対応のため、未設定時はプラグインは文字を黙って落とさず、インストールHint付きで非 ASCII 入力を拒否する。
  • `android_shutdown` は実機の電源を切れない——adb にそのようなコマンドはない——ため、ツールは偽らず理由を述べて拒否する。
2026-08-212026-08-21作者は未記載

MIT · freshly published (repo created 2026-08-21, last push 2026-08-21); README cites current plugin release 0.1.0-rc.4, tested with DSH 0.1.1-rc.1

06よくある質問

DSH Android を DeepSeek Harness に導入するには?

`dsh plugin --profile web add @zseven-w/dsh-android@latest` を実行し、続けて `dsh web` でライブデバイスパネル付きの Web UI を開きます。既存の profile パッケージの依存として pnpm で `@zseven-w/dsh-android` を追加しても構いません。

必要な環境は?

Node ≥ 24.11.0、Android SDK platform-tools の adb(ADB 環境変数・PATH・ANDROID_HOME の順で解決)、そしてエミュレータか USB デバッグ有効なスマホのいずれかの端末が必要です。Web パネルには web bundle 付きの DSH ≥ 0.1.0-rc.6 が必要です。

実機でなくてもエミュレータで動きますか?

どちらでも動作します。adb は同一のコードパスでエミュレータと実機を扱い、オンラインのシリアルを渡せばそのままストリーム、AVD 名を `android_boot` に渡せば起動完了後にストリームします。

macOS 限定のツールはありますか?

android_find_text・android_tap_text・android_wait_for の 3 つだけが Apple の Vision OCR フレームワークを使うため macOS ホストが必要です。Linux / Windows ではこの 3 つだけが「OCR は macOS が必要」と報告し、他の 17 ツールはすべて動作します。

デバイスストリームはどう保護されていますか?

ストリームはプロセス内で生成され、署名付きで loopback 限定の `/_dsh/dsh-android/*` ルートのみから提供されます。各能力は loopback ピア・loopback Host ヘッダ・同一オリジンの Fetch-Metadata/Origin 検査を要し、HMAC-SHA256 能力は 10 分で失効します。

08データと出典

  • 作者による申告github.com8c1d19a0019f…

    DSH Android gives the agent a real Android device inside the conversation — and gives you the pixels.

  • 作者による申告github.com8c1d19a0019f…

    All 20 tools are registered on every host and return plain JSON — visual bytes reach the UI only through `presentationMe…

このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-08-25。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。