dsh-pad-kit: Running DeepSeek Harness Locally on Android Tablets

前言

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 上会遇到三类问题,本套件用锚点匹配、幂等的补丁处理(对不上锚点则退出不写文件;已打过会跳过):

  1. 无 android-arm64 预编译原生绑定 → 在平板用 node-gyp 编译 require_builtin.node 并装入 node_modules。
  2. Android 无 flock → 对 @deepseek-ai/node-addon-system 的 flock.js 放行 android,单实例跳过加锁。
  3. 禁硬链接 → 会话持久化里 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>:8022
  • tablet_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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye