前言¶
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