前言¶
DeepSeek Harness（DSH）習慣在固定工作機上跑：工作區、工具鏈和會話都留在本機。人離開工位時，常見做法是 SSH、內網穿透或自建網關，往往要公網 IP、開端口，或把控制面放到第三方，延遲和運維成本都不低。
下面介紹社區客戶端插件 ds-harness-remote（維護者 liguobao）。它在 DSH 插件機制上提供遠程訪問：主機側 Harness 繼續運行，Web、PC 或移動端通過低延遲、端到端加密的 P2P 通道連入同一套界面與工作區，也可經 ACP 觸及 Codex、Cursor、Claude Code 等原生工作區。
這是什麼¶
ds-harness-remote 是發佈在 npm 上的 DSH 插件包，當前文檔固定版本爲 0.6.4，許可證 MIT。項目描述爲：基於 WebRTC/P2P、端到端加密的遠程訪問方案，讓 Web 與移動客戶端訪問本機上的 DeepSeek Harness、CodeX、Claude Code、Pi 等工作區。
默認協調與 Web 入口使用項目託管服務 https://dsh.r2049.cn；也可按倉庫說明自建 minimal Server（含 WebRTC 協調與加密 Relay，完整 Remote Web 體驗以託管站爲準）。
社區目錄頁：https://www.skillhub.cn/plugins/liguobao/ds-harness-remote。源碼與說明：https://github.com/liguobao/ds-harness-remote。
核心功能¶
以下能力均來自項目 README 與 package.json 說明。
- 多客戶端連同一 Host：Harness 留在工作電腦上；可從 Web、另一臺 PC 的 DSH、Android/iOS（iOS 爲 TestFlight Beta）等連接。多客戶端可同時在線，RPC 與流按連接隔離。
- 網絡與隱私：Host 側無需公網監聽端口或公網 IP；優先 P2P，配合全球 TURN 與中繼 Server Relay 回退，雙向通道端到端加密。
- 與本地 DSH 一致的操作面：遠程側使用原生 Harness 界面（非單獨桌面會話 UI），可創建工作區、配置模型、切換對話模型；側欄支持工作區文件、只讀預覽、遠程終端、經授權的本地開發服務預覽。
- Remote Tool 上下文注入：支持 Host/工作區發現、Harness 會話創建與管理、歷史讀取、等待執行、中斷請求、經授權的文件傳輸等（詳見倉庫
packages/plugin/README.md中 Remote Agent Tools）。 - 多工具工作區：除 DSH 外，經 ACP 集成可訪問 Codex、Cursor、Google Antigravity、Pi、OpenCode、Claude Code、Harness Agent 等，含遠程文件瀏覽與終端。
- Android 擴展：原生 Android 客戶端支持多工作區並行會話；Bot mode 由 Fei2411/DS-Bot 提供。另可配合 ccch1mneyyy/dsh-go 在手機上本地跑 DSH 或反向遙控電腦。
支持的客戶端形態（摘錄）：
| 客戶端 | 形態 | 狀態 |
|---|---|---|
| DSH Desktop 插件 | Remote 側欄 | 已支持 |
| Web | 瀏覽器 | 已支持，打開 https://dsh.r2049.cn |
| Android | 原生應用 | 已支持，從 GitHub Releases 安裝 APK |
| DSH Go | 第三方 Android 客戶端 | 已支持，內置本協議 |
| iOS | 原生應用 | Beta（見倉庫 issue #20） |
| Chrome 擴展 | 入口 | 僅做 Web 授權換取設備憑證、列 Host、打開同源 Remote Web，不提供對話 UI |
| Linux 雲主機 | 一鍵裝 Host | 已支持，在官網登錄後獲取安裝授權碼 |
安裝與啓用¶
DeepSeek Harness Desktop¶
在 DSH Desktop 中打開 Extensions / Plugin management，選擇從 npm 安裝，填寫：
ds-harness-remote@0.6.4
安裝後重啓 Desktop。若使用官方 dsh 啓動器，也可在桌面 profile 下執行：
dsh plugin --profile desktop add -w ds-harness-remote@0.6.4
DSH 0.2.2+ 在插件管理中支持 npm 包的版本校驗與更新；熱更新失敗時會嘗試回退上一版本。若此前從 GitHub 或本地 link 安裝，需先改爲 npm 安裝路徑，詳見倉庫 docs/installation.md 中 online updates 一節。
Linux 一鍵安裝 Host¶
訪問 https://dsh.r2049.cn 登錄賬號，獲取安裝授權碼後按站點指引一條命令完成 Host 側安裝。
Android 原生客戶端¶
從 GitHub Releases（latest） 下載 APK，使用與插件相同的賬號體系登錄後即可看到在線 Host。
自建協調服務（可選）¶
需要完全自管控制面時，參考倉庫 apps/server/README.md 的 minimal Server（Docker 自託管）。當前版本包含 WebRTC LAN/P2P/TURN 協調（TURN 需自行部署 coturn）與加密 Relay Server，但不等同託管站上的完整 Remote Web 產品形態。
典型用法¶
按 README Quick start，首次打通遠程的大致順序如下。
- 在本機 DSH 側欄打開 Remote。
- 選擇知乎、GitHub、Google 授權，或使用賬號密碼登錄。註冊賬號需要邀請碼，可向倉庫作者郵件申請。
- 在另一臺設備上：同樣在 DSH 中安裝
ds-harness-remote@0.6.4並按步驟 1–2 登錄；或直接使用 Remote Web、iOS/Android/DSH Go，無需在該設備裝桌面插件。 - 在客戶端列表中選擇在線 Host，再選已有工作區或瀏覽遠程目錄打開。
默認情況下，Remote 使用項目託管 Server https://dsh.r2049.cn。在另一臺電腦上選中 Host 打開工作區後，界面爲原生 Harness，頁頭會顯示當前 Host 與加密連接狀態。
適用場景與注意¶
適合誰：需要在通勤、出差或第二臺設備上延續同一 Harness 會話與工具配置的開發者；Host 留在內網、又不想在工位機上長期暴露公網端口的場景；希望在手機/Web 上查看遠程終端、文件與授權預覽的用戶。
權限與安全：插件作爲 DSH 進程的一部分運行，具備與當前 DSH 用戶相當的本地能力（文件、終端、經授權的服務預覽與傳輸）。安裝前應閱讀源碼、MIT 許可證及 packages/plugin 中 Remote Tools 的授權邊界，再決定是否在生產工作區啓用。
賬號與邀請：託管 Web 註冊依賴邀請碼；自建 Server 可減輕對默認託管的依賴，但需自行維護 TURN/Relay 與證書等組件。
客戶端差異：Chrome 擴展僅協助設備憑證與跳轉，不能獨立承載對話；iOS 仍爲 TestFlight Beta；文檔標明 dsh-TUI 集成計劃在後續版本，當前安裝器不會爲其自動創建 Web 服務。
結尾¶
ds-harness-remote 把「Harness 只在本機」和「人在哪都能連上」放在同一套原生 UI 裏：插件裝在 Host 的 DSH Desktop，客戶端用 Web、移動應用或另一臺 DSH 即可選 Host、進工作區。版本以 ds-harness-remote@0.6.4 爲準，安裝與更新請走 npm 或 dsh plugin --profile desktop add -w 官方寫法。
