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 需要）
安装步骤
- 01
$ dsh plugin --profile web add @zseven-w/dsh-android@latest
- 02
$ dsh web
- 03
pnpm add @zseven-w/dsh-android
验证接入成功
作者未说明
03DSH 适配与能力边界
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 没有这样的指令——因此工具会如实拒绝并给出原因，而不是假装执行。
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 分钟内过期。
07相关的 DSH 工作流
archify
作者 tt-a1i
为编码智能体生成美观可验证的架构图、时序图与数据流图，输出自包含 HTML，支持动效与清晰导出。
openviking
作者 volcengine
为 AI 智能体打造的自进化上下文数据库，统一智能体记忆、知识 RAG 与技能。
nocobase
作者 nocobase
开源的 AI + 无代码应用搭建平台：AI 在久经生产验证的底层基础设施与所见即所得的无代码界面之上工作，帮你快速构建 CRM、ERP 等业务系统，兼顾速度与可靠性。
learn-harness-engineering
作者 walkinglabs
Harness 工程新手教程，从 0 到 1 系统学习智能体工作流框架。
08数据与来源
DSH Android gives the agent a real Android device inside the conversation — and gives you the pixels.
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 个值得优先安装的插件，覆盖各个分类。