DeepSeek Harness (DSH) 支持在多臺主機上部署。當遠程服務器運行着 DSH Web 實例時,查看或控制遠程會話通常需要打開新窗口或切換瀏覽器標籤頁,打斷本地工作流。dsh-remote-dsh 插件通過在本地側邊欄增加一個“遠程”標籤頁,將遠程主機的 DSH 界面接管至當前頁面,並提供會話狀態指示。
這是一個由 hutao562 維護的 DSH 插件。它爲 Web 端添加一個側邊欄標籤頁,點擊後會將當前頁面重定向爲遠程主機的 DSH Web GUI,並在側邊欄頂部顯示遠程會話的狀態點。
安裝與啓用¶
通過官方插件命令安裝:
dsh plugin --profile web add dsh-remote-dsh
安裝後需要重啓一次 DSH。
典型用法¶
- 在遠程主機上運行
dsh web,獲取包含?token=的 URL。 - 使用 SSH 將遠程端口映射到本地迴環端口:
ssh -L 3081:127.0.0.1:3080 user@remote-host
- 在本地側邊欄點擊“遠程”行,點擊“+ 添加”。
- 填寫地址爲
http://127.0.0.1:3081。 - 在設置行中粘貼遠程
dsh web打印的 token,點擊配對。
核心特性與限制¶
必須使用本地迴環端口¶
遠程 DSH 的會話 Cookie 設置爲 HttpOnly; SameSite=Strict,因此只能通過本地迴環端口(如 ssh -L 或 frp stcp/xtcp)訪問。直接訪問公網域名或非迴環 IP 會導致 401 或 403 錯誤。
會話狀態徽章¶
側邊欄頂部的“遠程”行包含一個狀態點,顏色含義如下:
- 藍色:遠程主機上有正在運行的會話(含子代理)。
- 綠色:自上次查看遠程視圖後,有會話完成了一輪。
- 琥珀色:遠程主機上有會話處於“等待批准/提問/計劃評審”狀態。此狀態需要被控端安裝 v4 以上版本的 peer 插件。
- 紅色:無法讀取遠程狀態(通常是被控端未安裝 peer 插件)。
開發與熱加載¶
該插件無構建步驟。修改 lib/index.js 需要重啓 DSH;修改 lib/client.js 刷新頁面即可生效。首次安裝支持熱加載,無需重啓。
已知限制¶
- 接管頁面時會覆蓋本地側邊欄,返回需依賴頂欄按鈕。
- 在 iframe 中 Esc 鍵可能失效。
- Token 是每個進程生成的,重啓遠程
dsh web後需重新配對。 - 暫不支持將遠程主機集成爲本地的模型工具。
生態背景¶
DSH 理念是“一切皆插件”,該插件爲本地側邊欄增加了遠程控制能力,但並未提供 Agent 集成功能。更多實現細節與文件結構請參考 GitHub 倉庫。