前言¶
DSH 經常在本機運行,Web 界面適合桌面操作。如果手機上也要訪問同一個 DSH,就需要臨時暴露本機端口、拿到公網 URL,再確認手機訪問 /api 不被信任柵欄攔下,最後把鏈接發到手機上。dsh-mobile-link 把這些步驟收斂到一個 DSH 插件裏:啓動本地 DSH Web,創建或複用 Cloudflare quick tunnel,並把手機鏈接推送到你選擇的渠道。
這是什麼¶
dsh-mobile-link 是由 Cheng-xiu 維護的 DSH 插件,許可證爲 MIT。它讓手機通過互聯網連接本機 DeepSeek Harness(DSH),並把手機鏈接自動推送到你的微信,或你選擇的其它渠道。
核心功能¶
- 一鍵啓動本地 DSH Web,並創建或複用 Cloudflare quick tunnel,默認轉發 3080 端口。
- 自動檢測或下載 cloudflared,不要求註冊 Cloudflare 賬號。
- 啓動 DSH Web 時添加
--trusted-host,或動態加入信任柵欄,避免手機訪問/api返回 403。 - 支持 Server醬、PushPlus、Bark、ntfy 和自定義 webhook 推送。
- 配置
autoSend後,dsh web啓動約 8 秒後自動完成隧道和推送。 - 不依賴 PC 微信客戶端,通過 HTTP 推送通知。
- 提供
start、send、setup、tunnel、doctor、status等 CLI 命令。
安裝與啓用¶
前置要求:已安裝 dsh CLI、Node.js >= 18.17,且 pnpm 在 PATH 中。
本插件尚未發佈到 npm,需要從本地路徑或 GitHub 安裝。從 GitHub 安裝:
dsh plugin --profile web add github:Cheng-xiu/dsh-mobile-link
安裝完成後,重啓 dsh web。插件在下次 dsh 啓動時進入啓動樹並生效。
插件以當前 dsh 進程權限運行,安裝前建議先檢查源碼。已覈實資料中許可證爲 MIT。
配置推送渠道¶
先做一次性渠道配置,再做啓動和推送。交互式配置:
node bin/cli.js setup
如果確定使用 Server醬,也可以直接傳參數:
node bin/cli.js setup --channel serverchan --key SCTxxxxxxxxxxxxxxxx --port 3080
Server醬 SendKey、PushPlus token 等憑證僅保存在本機 ~/.dsh/mobile-link/config.json,權限爲 0600,不會寫進倉庫或日誌。
配置 autoSend 後,每次 dsh web 啓動約 8 秒後會自動完成隧道和推送。延遲可在 dsh 配置的 autoSendDelayMs 調整,默認 8000 毫秒。
典型用法¶
下面的命令用於本地調試和正式推送:
node bin/cli.js start
node bin/cli.js start --dry-run
node bin/cli.js start --test
node bin/cli.js send --port 3099
node bin/cli.js tunnel --stop
node bin/cli.js status
node bin/cli.js doctor
start 啓動隧道並推送手機鏈接;start --dry-run 只打印將發送的內容,不真正推送;start --test 發送測試消息而非真實鏈接。send --port 3099 用於指定端口只推送。tunnel --stop 停止本插件管理的隧道,status 查看隧道與配置狀態,doctor 做環境診斷。
幹跑調試也可以設置環境變量:
DSH_MOBILE_LINK_DRY_RUN=1
DSH_MOBILE_LINK_TEST=1
CLI 的 --dry-run 和 --test 優先於這兩個環境變量。
適用場景與注意¶
適合經常在本機運行 DSH、又需要在外網手機上打開 DSH Web 的使用者。也適合希望避免手動複製臨時 URL,並通過微信或自選渠道接收鏈接的場景。
使用 quick tunnel 時,quick tunnel URL 是公開的,任何知道該 URL 的人都能訪問你暴露的 DSH Web。請勿把推送消息中的鏈接公開分享。
Server醬免費額度有限,以其官網當前說明爲準。憑證只保存在本機 ~/.dsh/mobile-link/config.json,不要把 SendKey、token 等外傳。
結尾¶
dsh-mobile-link 的價值在於把本機 DSH Web 暴露、手機訪問和鏈接推送放到同一條流程裏。已覈實資料未提供目錄頁 URL;GitHub 倉庫地址爲:
https://github.com/Cheng-xiu/dsh-mobile-link