前言¶
DeepSeek Harness(DSH)的 Web 界面默認只監聽本機迴環地址,手機在局域網或外網上無法直接打開同一套會話。常見做法是遠程桌面或自建反向代理,步驟多,且容易把暴露面做大。下面介紹社區插件 dsh-phone-bridge(維護者 tihuzushi):在電腦 DSH 內提供橋接服務,並注入移動端外殼 UI,配合安卓客戶端,用手機作屏幕和輸入,算力與數據仍留在電腦上。
這是什麼¶
DSH Phone Bridge 是 DeepSeek Harness 的客戶端類插件,倉庫 tihuzushi/dsh-phone-bridge。一句話定位:把跑在你自己電腦上的 DSH 橋接到手機——手機當屏幕和鍵盤,模型調用、讀寫文件、終端命令都在電腦側執行。
需要區分:這是橋接,不是手機版 DSH。電腦關機或斷網,手機端不可用;會話、工作區、插件與密鑰都在電腦上。項目本身沒有自建業務服務器;兩端優先點對點直連,必要時經 Tailscale 加密中繼轉發密文。
安卓端爲獨立倉庫 tihuzushi/dsh-phone-bridge-app(內置 tsnet,不佔用系統 VPN)。插件側當前版本見倉庫 package.json(資料抓取時爲 0.4.14),許可證 MIT;本倉庫僅使用 Node 內置模塊,無運行時 npm 依賴。
核心功能¶
宿主側橋接¶
插件入口 lib/index.js 在 0.0.0.0:8765 監聽,提供配對入口,將 HTTP 與 WebSocket 轉發到 DSH 自有迴環端口,並附上本地簽發的會話 cookie。DSH GUI 若只綁 127.0.0.1,外網設備本無法直連;該插件即這條通道。
移動端界面¶
lib/client.js 在手機打開時套用移動端外殼:抽屜側邊欄、頂欄菜單、面板頁標題內聯按鈕、文件下載與預覽等。
遠程與 Tailscale¶
支持不在同一 WiFi 的場景:手機用蜂窩網、電腦在家,只要兩端登錄同一 Tailscale 賬號且在線即可。電腦需安裝並連接 Tailscale;手機 APK 在 App 內登錄 Tailscale 即可,不必再裝系統 Tailscale App。插件監聽包含 Tailscale 虛擬網卡,設置頁會顯示設備名;日誌中可出現形如 Tailscale: http://100.x.x.x:8765 的地址。
設置與更新¶
設置 → DSH Phone Assistant 提供:配對碼與配對頁、服務監聽地址與上游 DSH 端口、端口修改或「被佔用時自動換端口」、Tailscale 狀態、APK 下載入口、版本與「檢查更新」。配對輸錯會拉長重試間隔(自 0.4.5 起不會因錯誤碼鎖死);可「重新生成配對碼」或關閉「配對重試節流」。
狀態持久化文件:
~/.dsh/phone-bridge.json
示例字段(以 README 爲準):
{
"port": 8765,
"autoPort": true,
"throttle": true,
"pairingCode": "123456"
}
安裝與啓用¶
環境準備¶
| 項目 | 要求 |
|---|---|
| 電腦 | Windows,已安裝並能正常使用 DSH |
| 手機 | Android 8.0(API 26)及以上 |
| 賬號 | Tailscale 免費賬號,註冊入口 |
先在電腦上安裝 Tailscale:從 Windows 下載頁 安裝,托盤登錄並 Connect,狀態爲 Connected。手機端雖自帶 Tailscale,電腦也必須在同一 tailnet,手機才能發現電腦。
安裝插件¶
DSH 內:設置 → 插件 → 添加插件,填寫完整 GitHub 地址(輸入框不認 github:user/repo 簡寫):
https://github.com/tihuzushi/dsh-phone-bridge
裝完後重啓 DSH。
確認服務¶
打開 設置 → DSH Phone Assistant,應看到:狀態運行中、6 位配對碼、Tailscale 已連接及設備名、服務監聽 0.0.0.0:8765。若未運行,可重啓 DSH 或檢查 8765 是否被佔用。首次運行 Windows 防火牆可能詢問入站,建議允許專用網絡。
手機端¶
從 dsh-phone-bridge-app Releases 下載 DSH-Phone-Bridge-<版本>.apk 安裝(README 亦提供作者託管的 APK 短鏈與直鏈,以 README 當前說明爲準)。App 內 連接設置 登錄與電腦相同的 Tailscale 賬號,在「連接設備」中選擇電腦、填入配對碼,保存並連接。
卸載:DSH → 插件 → 已安裝 → dsh-phone-bridge → 卸載,再重啓 DSH。
典型用法¶
按 README「從零開始配置」順序即可復現:
- 電腦裝 Tailscale 並 Connected。
- 添加上述插件 URL,重啓 DSH,在 DSH Phone Assistant 記下配對碼與 Tailscale 狀態。
- 手機安裝 APK,App 內完成 Tailscale 登錄。
- 選中 tailnet 中的電腦,輸入 6 位配對碼,連接成功後即看到由插件注入的手機版 DSH 佈局。
常見問題對照:設備列表爲空 → 檢查手機 Tailscale 與電腦 tailnet;閃屏進不去 → 覈對電腦設置頁當前配對碼;換電腦或重裝插件 → 配對碼會變,需重新填寫。
適用場景與注意¶
適合需要在移動場景查看或操作同一臺電腦上的 DSH 會話、又不想在手機上再跑一套 Harness 的開發者。老手機也可作顯示端,不佔本地算力。
插件隨當前 DSH 進程權限運行,可轉發本地 GUI 與終端能力;安裝前應自行審閱 源碼與 LICENSE,並理解 Tailscale 與防火牆暴露面。社區目錄 SkillHub 插件頁 與 GitHub 爲獨立社區生態,與 DeepSeek / 幻方無官方從屬關係。