前言¶
在 DeepSeek Harness（DSH）裏做智能體或項目開發，工作區通常綁在本機磁盤上。若代碼和運行時其實在 Linux 服務器或 Windows 下的 WSL 裏，常見做法是本機開終端 SSH 進去，再單獨在遠端裝一套工具鏈；模型與服務商配置還要在兩邊各維護一份。DSH 社區插件 dsh-remote-dock（維護者 Lee-Eee-Eee，MIT 許可）在本地 DSH 側欄增加「遠程」入口：連上 SSH 主機或 WSL 發行版後，目標上的完整 DSH 界面嵌入本地主區，文件讀寫與命令執行都在目標環境中完成。
這是什麼¶
dsh-remote-dock 爲 DeepSeek Harness 添加遠程工作區能力。一句話定位：把任意可通過 SSH 訪問的 Linux 主機或本機 WSL 發行版，變成可在本地 DSH 面板裏管理、探測、安裝並使用的遠程 DSH 實例。
- 倉庫：Lee-Eee-Eee/dsh-remote-dock
- 社區目錄：skillhub.cn 插件頁
- 分類：客戶端（Web 側注入，安裝後側欄出現「遠程」）
DSH 生態採用「一切皆插件」思路；社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。安裝第三方插件前，應自行查看源碼與許可證，並理解插件隨當前 DSH 進程權限運行。
核心功能¶
以下能力均來自項目 README 與 package.json 說明。
SSH 與 WSL 目標管理¶
插件會發現 SSH 配置中的主機和本機 WSL 發行版，也支持手動添加目標。SSH 連接沿用本機密鑰、agent 與跳板機配置，不要求在插件裏重新錄入一套賬號體系。
遠程環境準備（無需 sudo）¶
選擇目標後可「探測環境」，檢查 Node、DSH、tmux 以及磁盤與 CPU 等信息。若缺少 Node 或 DSH，可先打開「查看安裝計劃」，確認步驟後再安裝到用戶目錄，無需 sudo。自動安裝依賴目標側具備 bash、tar，以及 curl 或 wget。
模型配置移植¶
遠程尚未配置可用模型時，可用「移植本地配置」：選擇服務商、默認模型和 API 密鑰組，寫入前會備份遠程原文件；預覽僅顯示名稱和數量，並排除本機瀏覽器會話憑據。密鑰組會複製實際密鑰值，只應寫入你信任的目標。
連接與會話管理¶
點擊「連接」後，主區打開目標上的 DSH，項目與會話由嵌入界面管理。面板內支持重載、全屏、重啓或停止遠程 DSH；重新連接時優先恢復已有實例，SSH 隧道斷開後會自動重試。多個目標可同時保持連接，切換目標即切換對應機器上的 DSH。關閉面板或退出本地 DSH 時，遠程進程可保留，之後可再連回。
安裝與啓用¶
宿主 DSH 需要 0.2.1-rc.2 或更新版本；運行環境需 Node 22.x（≥ 22.19.0） 或 24 及以上。
在插件管理器中添加以下來源（當前 README 指定版本 v0.1.5）：
github:Lee-Eee-Eee/dsh-remote-dock#v0.1.5
安裝後重啓 DSH 並刷新頁面，側欄會出現 遠程。
若終端已能運行 dsh，也可用命令行安裝（將 desktop 換成當前宿主實際使用的 profile；網頁版通常用 web）：
dsh plugin --profile desktop add "github:Lee-Eee-Eee/dsh-remote-dock#v0.1.5"
裝到其他 profile 的插件不會出現在當前宿主中。若曾使用舊名 dsh-remote，需先在當前 profile 移除舊版，再添加上述 GitHub 來源；新舊兩份只應啓用一份。dsh-remote-workspace@0.1.0-alpha.* 屬於其他 npm 項目，與本倉庫無關。
典型用法：首次連接¶
下面步驟與 README「首次連接」一致，可按順序復現。
- 添加目標：打開「遠程」，在 SSH 主機或 WSL 發行版旁點
+，或用「添加目標」填寫 SSH 別名或主機信息。 - 探測環境：選中目標，點「探測環境」。缺少 Node 或 DSH 時，打開「查看安裝計劃」，確認後再安裝。
- 準備模型：遠程尚無可用模型時，打開「移植本地配置」，選擇服務商、默認模型和 API 密鑰組，點「寫入並重啓」。遠程已配置好則可跳過。
- 連接：點「連接」，在主區使用遠程 DSH 並選擇遠程項目。連接後右側即目標機器上的 DSH；若已移植配置，模型與服務商與本機選擇一致。
連接後常用操作：
| 操作 | 作用 |
|---|---|
| 重載 | 刷新遠程界面 |
| 重啓 | 重新啓動目標上的 DSH |
| 停止遠程 | 結束目標實例並斷開本地連接 |
| 關閉面板 / 退出本地 DSH | 保留遠程進程，之後可重新連接 |
環境要求與注意¶
| 環境 | 要求 |
|---|---|
| DSH 宿主 | 0.2.1-rc.2 或更新 |
| 宿主 Node | 22.x（≥ 22.19.0），或 24 及以上 |
| SSH 目標 | Linux x86_64 / arm64；密鑰或 agent 免交互登錄 |
| WSL | Windows 與發行版迴環可達；支持 mirrored 網絡或啓用 localhost forwarding 的 NAT 網絡 |
適用場景：需要在遠程 Linux 或 WSL 裏跑與本地一致的 DSH 工作流，又希望在本機一個界面裏切換多臺目標；希望免 sudo 在用戶目錄補齊 Node/DSH，並一次性把本機模型配置拷到遠端。
常見問題（摘自 README）：
- 安裝後沒有「遠程」：確認裝到了當前 profile，重啓 DSH 並刷新。
- SSH 失敗：在本機終端確認
ssh <別名>可免交互登錄，且服務器允許端口轉發；不支持密碼交互提示。 - 界面能開但模型不可用：檢查遠程模型配置，或用「移植本地配置」寫入後重啓遠程 DSH。
更細的連接架構、認證與排錯見倉庫內 技術參考。
結尾¶
dsh-remote-dock 把 SSH 主機與 WSL 發行版納入本地 DSH 的「遠程」面板：發現目標、探測與無 sudo 安裝、模型配置移植，以及嵌入式的遠程 DSH UI，適合在多機開發時減少重複配置。進一步瞭解可訪問 社區目錄頁 與 GitHub 倉庫；問題反饋請走 Issues，並附上 DSH 版本、目標類型與脫敏後的錯誤信息。
