前言¶
DeepSeek Harness（DSH）的插件生態強調「一切皆插件」。如果你希望從 iPhone / iPad 上操作本機運行的 DeepSeek Harness Web GUI，但又不想繞過本機迴環服務，dsh-mobile 提供了一個可落地的方案：通過局域網反向代理、iOS PWA 外殼和移動端 CSS，讓同一局域網內的手機或平板訪問 Harness Web GUI。
下面介紹它是什麼、能做什麼、怎麼安裝啓用，以及需要注意的安全邊界。
這是什麼¶
dsh-mobile 是一個 DSH 客戶端插件，倉庫爲 cindyguyuehu123/dsh-mobile，許可證爲 MIT。
它解決的核心問題是：在 iPhone / iPad 上使用 DeepSeek Harness Web GUI。具體包括三類能力：
- 通過局域網反向代理訪問本機 Harness Web GUI；
- 注入 iOS PWA 元信息，支持 Safari「添加到主屏幕」；
- 注入移動端 CSS，處理觸屏、安全區、輸入縮放和軟鍵盤相關體驗。
核心能力¶
局域網反向代理¶
插件會啓動一個 0.0.0.0 反向代理，把來自 iPhone / iPad 的請求轉發給本機 Harness 迴環服務。
它會轉發 HTTP 與 WebSocket 請求，並改寫 Host / Origin，使手機端流量能進入 Harness Web GUI 的可信訪問路徑。
iOS PWA 外殼¶
插件會注入 iOS PWA 相關元信息，並生成 PNG 圖標。
在 Safari 中打開後，可以通過：
分享 → 添加到主屏幕
把 Harness Web GUI 添加到 iPhone / iPad 主屏幕，之後從主屏幕圖標進入。
移動端 CSS 適配¶
插件會注入移動端 CSS，主要處理：
- iOS 輸入框聚焦縮放；
touch-action相關觸屏行爲；- iPhone / iPad 安全區；
- 軟鍵盤彈出時的輸入區域表現。
/mobile 掃碼頁¶
桌面瀏覽器可以打開：
http://127.0.0.1:3080/mobile
頁面會顯示大二維碼，用於從桌面端獲取手機端訪問入口。
可選 IP 限制¶
插件支持可選 allow 配置，用於限制可訪問的客戶端 IP。
安全上下文 UUID 補丁¶
插件提供 harness 安全上下文 UUID 補丁，用於修復手機端 randomUUID 不可用問題。
如果後續升級 harness，需要重新應用已備份的補丁。
安裝與啓用¶
先使用官方插件命令安裝：
dsh plugin --profile web add https://github.com/cindyguyuehu123/dsh-mobile.git
該命令會安裝到 web profile。
如果需要在 cordis.patch.yml 中啓用移動端能力，可以使用 mobile 行配置 lanPort 或 allow。例如：
- insert:
- id: mobile
name: 'dsh-mobile'
config:
lanPort: 3080
allow: []
這裏的 config 用於配置代理端口和允許訪問的客戶端 IP。具體 IP 應填寫你信任網絡內的設備地址。
修改插件加載相關配置後，需要重啓 dsh web。
典型用法¶
先在桌面端和手機端完成連接：
1、讓手機或 iPad 連接與 Harness 相同的 Wi-Fi。
2、在桌面瀏覽器打開：
http://127.0.0.1:3080/mobile
3、查看頁面上的大二維碼，或在手機端訪問對應的局域網地址。
4、在 Safari 中打開後，通過：
分享 → 添加到主屏幕
把 Harness Web GUI 加入主屏幕。
之後從 iPhone / iPad 主屏幕進入，即可訪問同一局域網內的 Harness Web GUI。
適用場景與注意¶
這個插件適合在自己的受控網絡內使用，例如家庭 Wi-Fi 或自己管理的內網。
啓用後，同一局域網內的設備可以完全驅動 Harness，包括可執行代碼的工具。因此它只建議在自己信任的網絡中開啓。
如果你連接到公共網絡或陌生 Wi-Fi，建議先移除或註釋 cordis.patch.yml 中的 mobile 行，再重啓 dsh web：
# - insert:
# - id: mobile
# name: 'dsh-mobile'
插件會隨當前 dsh 進程運行，安裝前建議先查看倉庫源碼與 MIT 許可證。
它只能在同一局域網內訪問，或者在你自行打通的路由內訪問。如果手機走蜂窩網絡，無法直連運行 Harness 的電腦。
macOS 首次監聽 0.0.0.0 時，系統防火牆可能會詢問是否允許 Node.js 接受傳入連接。如果你確認只在本機可控網絡使用，可以選擇允許。
如果你修改了插件的 host 半，需要重啓 dsh web。如果升級了 harness，需要重新應用已備份的補丁。
鏈接¶
- 目錄頁：
https://www.skillhub.cn/plugins/cindyguyuehu123/dsh-mobile - GitHub：
https://github.com/cindyguyuehu123/dsh-mobile
