dsh-pad-kit:在安卓平板上本地運行 DeepSeek Harness

前言

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
羽毛球分组比赛记分
小程序二维码

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

小夜