前言¶
在 DeepSeek Harness (DSH) 的插件化架構中，智能體通常在本地運行，使用本地的文件系統和 Shell 工具。當需要在遠程服務器（如開發環境、生產沙箱）上進行開發時，現有的工具棧無法直接生效。dsh-remote-development 插件通過路由機制，將本地的工具調用轉換爲遠程 SSH 執行，無需爲模型添加額外的工具或第三方 UI 組件。
插件簡介¶
名稱：cjylzs/dsh-remote-development
維護者：CJYLZS
定位：一款輕量級遠程開發插件。它允許用戶通過 SSH 連接遠程機器，將遠程目錄指定爲工作區，使智能體使用與本地完全相同的工具集在遠程環境中工作。
核心功能¶
- 一致的工具集：插件不增加新的模型工具。智能體使用的文件、Shell 和 Bash 工具保持不變，插件在底層將其轉換爲遠程執行。
- 零遠程依賴：遠程機器無需安裝額外的服務器端組件，僅通過 SSH 連接即可工作。
- Web GUI 集成：在 Web 界面管理 SSH 連接（支持密碼、私鑰、SSH Agent、跳板機），並提供自定義機器標記顏色。
- 路由提供者：通過
RoutingFileSystem、RoutingSubprocessRuntime和RoutingBashExecutor替換底層提供者，實現文件系統、子進程和 Bash 的遠程路由。 - SFTP 會話多路複用：所有文件操作共享一個 SFTP 會話，避免連接耗盡。
- 遠程工作區目錄流：在 Web 界面選擇遠程目錄作爲會話工作區。
安裝與啓用¶
安裝前請檢查當前 dsh 版本，並確保插件版本與宿主版本匹配，否則會導致啓動錯誤或命令失敗。
dsh -V
根據你的 dsh 版本選擇對應的安裝命令：
- dsh ≥ 0.1.7-alpha.1 (推薦 v0.2.x)：
dsh plugin add --profile web github:CJYLZS/dsh-remote-development#v0.2.0
- dsh 0.1.2-rc.1 – 0.1.5-rc.x (v0.1.x)：
dsh plugin add --profile web github:CJYLZS/dsh-remote-development#v0.1.0
安裝完成後，必須重啓 Harness 才能生效。
典型用法¶
使用流程非常簡單，僅需三步：
- 添加機器：在 Web GUI 的
dsh-remote-development設置頁面中配置目標機器的地址、端口、用戶名，選擇認證方式（密碼/私鑰/Agent），並測試連接。 - 選擇遠程目錄：在工作區目錄流（主對話框或側邊欄）中，切換到 Remote 標籤頁，瀏覽並選擇一個遠程機器的目錄作爲會話工作區。
- 正常工作：此時即可像在本地一樣使用文件工具和 Shell。智能體會自動使用遠程路徑作爲工作目錄，無需特殊指令。
注意事項¶
- 版本兼容性：插件必須與宿主
dsh版本匹配。版本不匹配會導致啓動時報錯（如Cannot read properties of undefined）或命令執行失敗（如shell.run is not a function）。 - 機器刪除影響：如果遠程工作區對應的機器被刪除，遠程工作區操作將直接失敗並提示 “machine is no longer configured”。
- 錨點機制：只有選中目錄下的操作纔會執行遠程邏輯。選中目錄之外的路徑將保持本地行爲，不會受插件影響。
- 重啓要求：安裝新版本或修改配置後，建議重啓 Harness。
生態背景¶
DeepSeek Harness 的設計理念是「一切皆插件」。該插件屬於社區維護的插件項目，旨在擴展 Harness 的遠程開發能力。更多詳情可參考 技能樹插件目錄 或 GitHub 倉庫。
