DSH（DeepSeek Harness）採用插件化架構，允許開發者根據需求擴展功能。在遠程服務器（如雲主機）上部署 Harness 環境通常涉及手動配置 Node.js、解壓文件、處理憑證等繁瑣步驟，且難以保證環境的一致性與安全性。
DSH Remote Runtime 插件旨在解決這個問題。它通過 OpenSSH 在遠程 Linux 主機上管理一個隔離的、官方版本的 Harness 運行時，並提供原生的 Web 控制界面。所有 SSH 連接、文件操作、進程執行和密鑰憑證均保留在插件宿主機中，瀏覽器僅通過受限制的 JSON 接口獲取摘要信息。
核心功能¶
該插件主要在 DSH Web UI 中增加了以下能力：
- 遠程配置管理：添加遠程主機配置，管理遠程工作區。
- 運行時驗證：自動安裝並驗證遠程運行時環境，包含 Node 22.19 和官方 DSH rc.8。下載包及解壓後的所有文件均通過 SHA-256 校驗。
- 安全隔離：憑證以
0600權限寫入，僅存儲在宿主機，絕不返回給瀏覽器狀態、日誌、快照或進程參數。 - 訪問控制：SSH 是唯一的訪問控制邊界。
- 流量限制：認證的 Client-Proxy 出站流量僅允許訪問公網 HTTP(S)，其他地址（私有、本地、IPv6 等）將拒絕連接。
- 隧道與 UI：通過本地迴環隧道（Loopback tunnel）暴露遠程 Harness UI，無需直接暴露遠程服務器的 Web API。
安裝與啓用¶
安裝此插件需要當前本地 DSH 版本爲 0.1.0-rc.8，並運行 Web profile。
- 執行以下命令安裝插件：
npx.cmd --yes @deepseek-ai/dsh@0.1.0-rc.8 plugin --profile web add @artificialnotimbecile/dsh-remote-runtime@latest
- 安裝完成後，重啓已運行的 Web profile。
典型用法¶
完成安裝後，在 DSH Web UI 中進行配置：
- 打開 Settings -> Remote runtime。
- 添加一個 OpenSSH 主機，並可選填遠程工作區路徑。
- 選擇出站模式：
- Remote-direct：遠程直連模式。
- Client-proxy：客戶端代理模式（需配置認證）。
- 運行只讀的 Doctor 檢查，確認環境滿足要求後，顯式安裝驗證過的運行時。
- 通過“寫僅”表單導入 DeepSeek API 密鑰。
- 啓動運行時，系統將自動打開本地迴環隧道 URL。
- 在瀏覽器中瀏覽工作區、查看會話歷史、發送或取消提示。
斷開連接不會終止遠程 Harness 的運行，停止操作是獨立的。移除本地配置不會刪除遠程運行時或會話數據。
適用場景與注意¶
- 環境要求：
- 本地客戶端：Windows、macOS 或 Linux，Node.js 版本需爲
^22.19.0或>=24，系統需安裝ssh。 - 遠程主機：Linux x64，glibc 2.28+，需安裝 Bash、tar、gzip、sha256sum，且擁有可寫的主目錄。
- 本地客戶端：Windows、macOS 或 Linux，Node.js 版本需爲
- 軟件狀態：DeepSeek Harness 爲預發佈軟件。後續 DSH 版本在特定功能（如 Typert 生成、組裝配置文件 CI）完全對齊前，將不被支持。
- 權限與安全：插件宿主機以 DSH 進程權限運行。在共享遠程主機賬號時，建議使用獨立的遠程 OS 用戶以實現更嚴格的進程隔離。
該插件由社區維護，採用 MIT 許可證，與 DeepSeek 無官方隸屬或背書關係。
