前言¶
DeepSeek Harness(DSH)官方没有 Android 客户端。想在平板上用完整 Web 界面,常见做法是 Termux 里全局安装 @deepseek-ai/dsh,再用平板浏览器打开本地服务。这条路径在 arm64 平板上往往会卡在原生绑定缺失、flock 不可用、硬链接被系统禁止三处平台差异,还要自己解决局域网安装、SSH 通道和开机自启。
下面介绍社区插件 dsh-pad-kit(维护者 longsiqi-123):在电脑侧 DSH 里提供安装页与 7 个 tablet_* 工具,通过同一 Wi-Fi 内的 HTTP 与 SSH 把 DSH 装到 Termux,并在平板上打补丁、起服务、配置 Termux:Boot。装完后,操作的是平板本地的文件与应用,不是远程操控电脑上的工作区。
这是什么¶
dsh-pad-kit 归类为 DSH 客户端 方向插件(npm 包名 dsh-pad-kit,当前版本 1.0.0,MIT 许可证)。它解决的是:在无 adb、无 root、无数据线的前提下,让 arm64 / Android 7+ 平板在 Termux 里稳定跑 DSH Web GUI,并在重启后仍能从固定入口打开。
| 角色 | 得到什么 |
|---|---|
| 平板 | 浏览器里的 DSH Web 界面,会话与插件跑在平板本地 |
| 电脑 | 局域网安装页(形如 http://<电脑IP>:8090/)及 SSH 运维工具 |
| 安装完成后 | 电脑可以关掉;日常使用不依赖电脑在线 |
插件目录页:skillhub.cn/plugins/longsiqi-123/dsh-pad-kit。源码与说明:github.com/longsiqi-123/dsh-pad-kit。
核心功能¶
电脑侧:7 个 tablet_* 套件工具¶
装完插件并重启 DSH 一次后,工具列表会出现下列 7 个(新增插件行不热加载):
| 工具 | 作用 |
|---|---|
tablet_install_page |
起局域网安装页,返回可发给平板的地址 |
tablet_bootstrap |
输出 bootstrap.sh;sshonly: true 时只建 SSH、不装 DSH |
tablet_targets |
列出已「报到」的平板,也可手动登记 |
tablet_kit_status |
查看版本、原生绑定、补丁、Web 入口、token 等健康度 |
tablet_kit_setup |
经 SSH 远程重跑安装脚本(升级或修复) |
tablet_kit_url |
取固定入口与带 token 的直连地址 |
tablet_kit_apk |
Termux APK 的局域网下载地址 |
日常在平板上执行命令、传文件等能力在另需单独安装的 dsh-tablet 插件里(本仓库不含),例如 tablet_sh、tablet_wake 等。pad-kit 侧重安装与状态;两者不要混为一谈。
平板侧:补丁与自启¶
README 说明,直接装 DSH 在 Android 上会遇到三类问题,本套件用锚点匹配、幂等的补丁处理(对不上锚点则退出不写文件;已打过会跳过):
- 无
android-arm64预编译原生绑定 → 在平板用node-gyp编译require_builtin.node并装入node_modules。 - Android 无
flock→ 对@deepseek-ai/node-addon-system的flock.js放行android,单实例跳过加锁。 - 禁硬链接 → 会话持久化里
link()失败时降级为copyFile。
开机自启依赖 Termux:Boot:安装脚本写入 ~/.termux/boot/start-dsh.sh,需安装 Termux:Boot 应用后 Android 才会执行该目录下的脚本。
连接方式(三段局域网访问)¶
平板浏览器 ──① 打开安装页 ──▶ 电脑:8090
平板 Termux ──② 报到 ───────▶ 电脑:8090 /register
电脑 DSH ───③ SSH 运维 ────▶ 平板:8022
全程不要求 adb;电脑在安装阶段起 HTTP 服务,平板主动访问;装好后电脑经 SSH(Termux sshd 默认 8022)运维。
安装与启用¶
DSH 要求 ≥ 0.1.7-rc.2(需支持用户插件);低于门槛时 tablet_* 工具会直接提示不支持。插件以当前 DSH 进程权限运行,安装前建议阅读仓库源码与 MIT 许可证。
在 DSH 里:插件 → 添加插件,任选下表一种来源,安装后点「立即启用」,再重启 DSH:
| 来源 | 填什么 |
|---|---|
| npm 包 | dsh-pad-kit |
| GitHub | github:longsiqi-123/dsh-pad-kit |
| GitHub(完整地址) | https://github.com/longsiqi-123/dsh-pad-kit |
命令行等价:
dsh plugin add dsh-pad-kit
dsh plugin add github:longsiqi-123/dsh-pad-kit
SSH 密钥(若无则自动生成)位于 %USERPROFILE%\.dsh\pad-kit\id_ed25519(Windows)或对应用户目录下的 .dsh/pad-kit/。安装页默认端口 8090;若被占用,可改插件配置中的 httpPort。
典型用法¶
1. 起安装页¶
在电脑 DSH 中调用 tablet_install_page,得到形如 http://<电脑IP>:8090/ 的地址(同一 Wi-Fi 内有效,非公网)。平板浏览器打开该页;页面上有二维码与引导。
2. 平板首次安装¶
安装页会询问是否已有 Termux:
- 没有:点「下载 Termux APK」安装并打开(需允许未知来源应用)。
- 已有:在 Termux 粘贴页面给出的一行(IP 以安装页为准):
curl -fL http://<电脑IP>:8090/bootstrap.sh | bash
脚本会先自检 Termux 环境、arm64、磁盘约 1.5 GB 空闲、能否访问 8090/healthz 等,再安装 openssh、登记 SSH、全局安装 @deepseek-ai/dsh、打补丁并打印 FIXED_URL。
若尚未安装 Termux:Boot,安装页可下载 Termux:Boot APK(README 写明 0.8.1);装完打开一次,重启平板后 DSH 才会按 boot 脚本自启。验证可看 ~/dsh-boot.log。
3. 电脑侧确认¶
报到成功后,插件写入 ~/.dsh/pad-kit/tablets.json。可用:
tablet_targets→ 例如u0_aXXX@<平板IP>:8022tablet_kit_status→ 查看 NODE、DSH、BINDING、补丁与 Web 入口状态
平板侧用浏览器打开固定 Web 地址即可使用完整 DSH 界面。若打不开,README 建议在电脑侧执行一次 tablet_kit_setup 拉起服务。
4. 日常维护¶
- 升级或修复 DSH:
tablet_kit_setup - 查入口与 token:
tablet_kit_url - Termux 被系统冻结导致 SSH 超时:切 Termux 到前台,或使用
dsh-tablet的tablet_wake(需另装该插件)
适用场景与注意¶
适合谁:希望在安卓平板上本地跑 DSH(智能体、插件、工作区都在平板 Termux 内),又愿意用同一局域网里的电脑做一次「安装工」的开发者。
前提摘要(细节见 README「前提条件」表):
- 平板 arm64、Android 7+,Termux 能访问 npm,约 1.5 GB 空闲空间;安装编译的 1~3 分钟内建议不锁屏、Termux 在前台。
- 电脑与平板同一 Wi-Fi、同网段,安装期间电脑防火墙放行 TCP 8090;电脑需 OpenSSH 客户端(
ssh -V)。 - 社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系;插件为社区作品,星标与维护节奏以 GitHub 为准。
明确做不到的事(README「做不到的事」):无 adb/root 时不能远程看屏、模拟触控、静默装 APK、后台自动拉起浏览器;电脑侧工具是命令行级远程控制与文件通道,不是远程桌面。
结尾¶
dsh-pad-kit 把「Termux + 补丁 + 局域网安装页 + SSH 运维 + Termux:Boot」收成一条可复现路径,补上了 DSH 在 Android arm64 上的三块硬坑。若你已经在用 DSH 做智能体开发,又有一块常放在手边的平板,可以按官方 README 从 tablet_install_page 走通一遍时间线,再在平板浏览器里Bookmark 固定入口。
- 目录页:https://www.skillhub.cn/plugins/longsiqi-123/dsh-pad-kit
- GitHub:https://github.com/longsiqi-123/dsh-pad-kit