DeepSeek Harness (DSH) 的運行界面通常綁定在本地。要在移動端直接操作，現有方案要麼依賴功能受限的 Companion 應用，要麼需要配置 SSH 等複雜工具。omdsh-remctrl 插件提供了一條更直接的路徑：在 DSH 的自有端口上建立一個“第二扇門”。它通過反向代理將 DSH 的完整界面暴露到公網，並前置了一個基於密碼的認證層。手機通過這個入口，可以觀看會話、批准工具請求並分派新工作。
插件定位¶
- 名稱：
omdsh-remctrl - 所有者：
omdsh-plugins - 類別：
system - 一句話介紹：DeepSeek Harness 的遠程控制：在自有端口上充當“第二扇門”，在設備配對和分層方法白名單之後，使得手機可以觀看會話、批准請求並分派新工作。
核心功能¶
該插件通過一層反向代理實現遠程訪問，核心能力包括：
- 反向代理：提供 HTTP 和 WebSocket 反向代理，將流量轉發到 Harness 的
webServer，復刻原生的完整界面。 - 密碼鑑權：在代理層增加 passcode 認證門，未通過鑑權無法訪問界面。
- 自動隧道：默認啓動
cloudflared子進程，自動生成 HTTPS 公網地址。 - 插件中心集成：提供卡片集成，允許通過開關控制插件的啓用與禁用。
- 移動端適配：針對移動端優化鍵盤彈起和側邊欄展開的邏輯。
- 會話管理：管理會話 Cookie，設置
HttpOnly和SameSite=Lax屬性。
安裝與啓用¶
該插件默認未啓用，安裝後需手動激活。
- 通過插件中心或直接訪問倉庫安裝插件。
- 在 DSH 界面中找到插件中心卡片，點擊開關將其啓用。
典型用法¶
配置的核心在於如何確定公網訪問地址：
-
使用默認隧道：
留空publicHost配置項。插件會啓動 cloudflared 快速隧道，並分配一個https://<uuid>.trycloudflare.com地址。這種方式無需配置域名或防火牆。 -
手機登錄：
插件卡片會顯示公網地址、預填了密碼的登錄鏈接以及密碼本身。將鏈接發送到手機並點擊，瀏覽器會自動攜帶密碼完成登錄並重定向，無需在地址欄手動輸入密碼。 -
使用自有域名：
如果機器已有公網地址（如harness.example.com），在配置中設置publicHost。由於此方式使用 HTTP，必須在代理層手動設置allowInsecure以允許連接。 -
控制開關：
通過插件中心卡片的開關，可以隨時開啓或關閉遠程訪問能力。
安全與配置¶
插件的配置項極少，安全性主要依賴 DSH 自身的機制：
- 轉發限制：在未解析到有效會話 Cookie 之前，不轉發任何請求。
- 速率限制：每個地址每分鐘限制 6 次認證嘗試。
- 傳輸加密：通過 cloudflared 隧道強制 HTTPS 傳輸。
- 無其他配置：插件未提供其他可配置項。
環境要求¶
插件依賴 Node.js 運行環境，要求版本滿足以下條件之一：
- Node.js
^22.19.0 - Node.js
>=24.0.0
短結尾¶
omdsh-remctrl 爲 DSH 提供了原生的遠程控制能力。它不是功能子集的 Companion 應用，而是將 DSH 的完整界面通過反向代理和 Cloudflared 隧道復刻到公網。通過插件中心的開關和 passcode，你可以安全地在任何設備上管理 DeepSeek Harness 會話。
