返回目錄

dsh-android

編輯精選維護狀態: 活躍

zseven-w/dsh-android

DeepSeek Harness 的 Android 外掛:在對話中通過 adb 驅動模擬器或 USB 真機,構建、執行並即時互動。

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

116

星數

8

Fork

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 手機

    程序內即時裝置串流,外加 20 個 agent 工具:截圖、UI 點按、Gradle 建置執行、OCR、logcat、程序檢查

    希望在 DeepSeek Harness 內一站式建置、執行與檢查 Android 應用的行動開發者與 agent

  • 在裝置上建置、安裝並啟動 Gradle 應用

    透過 ./gradlew assembleDebug 建置的 debug APK,經 adb install -r 安裝並在面板中即時啟動

    希望由 agent 驅動「建置—執行」循環的 Android 工程師

  • 用視覺與除錯工具檢查 UI、文字與日誌

    含元素點擊的 uiautomator UI 樹、針對文字的 OCR 查找 / 點按 / 等待、logcat 快照或即時追蹤、程序回溯與 meminfo

    需要驅動並觀察真機 UI 與狀態的 QA 與自動化工程師

02如何將外掛接入 DeepSeek Harness?

先決條件

  • Node ≥ 24.11.0。
  • adb 來自 Android SDK platform-tools,依 ADB 環境變數、PATH、ANDROID_HOME 順序尋找
  • 一台裝置:任意產品的模擬器,或開啟 USB 偵錯的手機。
  • 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 安裝後,向 Web 對話註冊 20 個由 adb 驅動的 agent 工具與程序內即時裝置串流。

  • 即時裝置串流與側邊欄面板

    在線的 adb 序列號或 AVD 名稱程序內 multipart/x-mixed-replace PNG 串流,渲染在常駐側邊欄面板

    串流期間會常駐一個 `adb exec-out` 截圖子程序
  • Gradle 建置並執行

    Gradle 專案路徑透過 ./gradlew assembleDebug 建置的 debug APK,以 adb install -r 安裝並在裝置上啟動

  • UI 樹、元素與 OCR 點按

    resource-id / 文字 / content-desc 或一次 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 / 中文 / emoji 輸入需要裝置上可選的 ADBKeyboard 輸入法;`adb shell input text` 僅支援 ASCII,因此缺少時外掛會以安裝提示拒絕非 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 介面;也可把 `@zseven-w/dsh-android` 作為現有 profile 套件的依賴,用 pnpm 加入。

有什麼安裝與執行前提?

需要 Node ≥ 24.11.0、Android SDK platform-tools 裡的 adb(依 ADB 環境變數、PATH、ANDROID_HOME 順序尋找),以及一台裝置——模擬器或開啟偵錯的 USB 手機。Web 面板需 DSH ≥ 0.1.0-rc.6 且含 web bundle。

一定要實機嗎,模擬器相容嗎?

兩者都相容。adb 透過同一條程式路徑對待模擬器與手機;傳入在線的 serial 即可串流,或把 AVD 名稱交給 `android_boot`,外掛會在模擬器開機完成後串流它。

哪些工具限定 macOS?

只有 android_find_text、android_tap_text、android_wait_for 使用 Apple 的 Vision OCR 框架,故需 macOS 主機;在 Linux 與 Windows 上這三者會提示 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。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛市集,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。