前言¶
DeepSeek Harness (DSH) 採取插件化生態策略。在桌面端操作之外，有時需要從手機端快速查看狀態或進行簡單控制。dsh-mobile-remote 是一個社區維護的插件，它通過在 Web 設置頁面增加“遠程控制”面板，實現了局域網及外網下的手機遠程操控。
核心功能¶
該插件提供了一套完整的移動端遠程控制解決方案：
- 連接與控制：設置頁內置掃碼連接二維碼，支持一鍵開啓/關閉遠程控制（支持熱重載，無需重啓服務）。
- 設備統計：實時統計當前在線的設備數量。
- 圖片上傳：優化手機端體驗，支持通過系統圖庫或文件選擇器上傳圖片（用於 DeepSeek 的視覺模型）。
- 遠程訪問密碼門禁：提供安全防護。本地訪問和局域網訪問免密，外網訪問需密碼。密碼使用 scrypt 哈希和隨機鹽存儲在本地（
~/.dsh/plugins/dsh-mobile-remote/config.），不依賴後端 relay。 - 遙測數據：豐富的設備數據展示，支持展開查看 OS、瀏覽器、屏幕、CPU、內存等詳情。
- 狀態檢測：真實的外網隧道狀態檢測（通過 frpc 日誌驗證，非假在線狀態）。
- 性能優化：優化遠程加載速度，通過增加 frpc 連接池解決外網訪問卡頓問題。
- 純 CLI 支持：純 CLI 用戶無需安裝桌面應用即可使用遠程控制功能。
安裝與啓用¶
安裝插件¶
使用以下命令安裝插件：
dsh plugin --profile web add @feiyang666/dsh-mobile-remote
啓動與配置¶
安裝後，啓動 DSH（桌面應用或命令行），打開 http://127.0.0.1:3080 進入設置 -> 遠程控制，開啓遠程控制開關。
使用步驟¶
- 啓動服務：確保電腦端已啓動 DSH。
- 開啓控制：在 Web 界面的“遠程控制”頁面開啓開關。
- 連接設備：確保手機和電腦連接同一 Wi-Fi，使用手機瀏覽器掃描生成的二維碼或打開局域網 URL。
- 操作與交互：在手機端即可查看桌面數據併發送消息進行控制。
純 CLI 啓動方式¶
如果僅使用命令行，可以通過 --patch 參數啓用遠程控制，無需安裝桌面應用：
dsh --profile web --patch remote-control.patch.yml
或者在啓動後，通過 Web 界面的設置頁手動開啓。
注意事項¶
- 密碼安全：遠程訪問密碼存儲在本地，僅用於外網訪問驗證，不依賴後端 relay 服務。
- 依賴要求：需要安裝
dsh-update-server並更新相關文件，才能顯示完整的隧道統計信息。 - 通用性：插件支持任意 frp/tunneling 解決方案（包括自建 relay），密碼門禁直接生效。
- 安全限制：官方 CLI 默認限制
--host 0.0.0.0以保證安全，該插件通過修改cordis.patch.yml或--patch參數實現繞過，請確保僅在受信任的網絡環境下使用。
