DeepSeek Harness Hub
← 全部攻略

dsh-android 怎么用?安装、配置与常见问题(DSH 插件教程)

它解决什么问题

DeepSeek Harness plugin for Android — build, run, and interact with a live emulator or USB device stream inside a conversation, driven entirely through adb.

核心功能

  • 紧凑对话卡片。 工具结果渲染为不含内嵌图片的单行卡片:设备名、动作副标签、状态徽标,以及"在侧边栏打开"的提示。点击行即打开面板。
  • 输入框上方的状态胶囊。 面板关闭且流在线时,输入框上方出现一个小胶囊,点击即打开面板。
  • 标准模式与 Code Mode。 标准会话使用宿主投影的 presentationMeta;嵌套的 Code Mode 分发不携带 meta,客户端便从持久化的结果 JSON 重建出完全相同的 meta —— 面板、卡片、胶囊在两种模式下都工作。
  • 截图路由只服务唯一一个目录。 路径用 lstat 逐级走查(任何符号链接一律拒绝),以 realpath 收尾做包含性校验,用 ONOFOLLOW 打开、限制大小,并在读完后再校验一次 —— 因此在签发与取用之间被换成符号链接的文件永远不会被送出。
  • /grant 永不启动任何东西。 它只为已经在线的设备启动帧循环,并且会以 409 devicebusy 拒绝把流从另一台设备手上抢走。切换设备必须走显式的 /switch-device 手势;启动 AVD 则始终属于 androidboot 工具。
  • 保活与空闲停止。 崩掉的帧循环在后台重启(约 5 s 延迟);消费者归零 5 分钟后流自行停止。主动停止绝不会被保活逻辑对抗。
  • Node ≥ 24.11.0。
  • 一台设备:任意产品的模拟器,或开启了 USB 调试的手机。emulator 启动器是可选的,只有"用 AVD 名调 androidboot"需要它 —— 其余功能只要 adb 看得见设备就能工作。

安装


npx @deepseek-ai/dsh plugin add ZSeven-W/dsh-android

插件 README 中出现的其它命令:


DSH Android

DSH Android 把一台真实的 Android 设备交给 agent,同时把画面交给你。agent 可以在模拟器或 USB 手机上开流、构建并安装 Gradle 工程、按 re

DSH webserver 提供的签名短时 URL 抵达界面。

DSH webserver 源上插件自有的 /_dsh/dsh-android/ 路由:/stream/(实时 multipart PNG)、/screenshot/(缓存 PNG),以

现状数据

  • 周下载量:425
  • GitHub Stars:120
  • 中文说明:已汉化

适合谁用

正在用 DeepSeek Harness(dsh)做开发、希望扩展其能力的人。装之前建议先看周下载量与 Star 数判断活跃度。

常见问题

装不上怎么办? 先确认 dsh 版本最新,再重试安装命令;仍失败可到插件页查看「安装兼容性检查」。

装了不生效? 部分插件需重启 dsh 会话或重新加载配置才生效。

> 本文依据插件官方 README 自动整理,具体用法以插件最新版本为准。

查看 dsh-android 插件详情
安装命令 · 中文 README · 兼容性报告
前往插件页 →
订阅周报,不错过新攻略
每周一封 · 插件 + 福利

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群