前言¶
DSH 的核心理念是「一切皆插件」。在本地開發時，模型調用、思考、決策都在本地進行。當需要操作遠程服務器或容器時，開發者往往面臨文件同步困難、命令執行環境不一致、搜索結果不準確等痛點。dsh-multi-remote 解決了這個問題，它允許 agent 的文件讀寫、bash 執行、搜索全部在目標環境裏執行——大腦留在本地，文件和命令在遠端。
這是什麼¶
dsh-multi-remote 是一個 DSH 客戶端插件。它由 jk-uzi 維護，目前 Star 數爲 1，採用 MIT 許可證。它是一個客戶端組件，旨在解決智能體在遠程環境下的協作問題，讓 agent 能夠無縫接入 SSH、WSL 和 Docker 環境。
核心功能¶
- 多後端支持：同時支持 SSH、WSL 和 Docker 三種遠程環境。
- 本地決策，遠程執行：模型調用、思考、決策在本地執行；而文件讀寫、命令執行、搜索在遠端執行。
- 真 PTY 終端：支持遠程交互式終端，提供真實的僞終端體驗，支持狀態跨調用保留（如
cd、環境變量、後臺任務）。 - 本地錨點鏡像：支持配置本地錨點目錄作爲只讀鏡像邊界，用於界面展示文件樹，但 agent 的實際操作不受此限制。
- 自動識別：支持自動識別 WSL 發行版和 Docker 容器。
安裝與啓用¶
插件通過 Node.js 腳本進行安裝。在項目根目錄下執行以下命令：
node scripts/in
安裝前建議檢查源碼以確保安全。
典型用法¶
- 通過側邊欄連接：在 DSH 的側邊欄中找到「遠程開發」彈窗，選擇後端（SSH/WSL/Docker），系統會自動識別目標列表（如 WSL 發行版、Docker 容器或歷史 SSH 記錄）。
- 通過 Agent 調用：在對話中讓 agent 調用
remote_connect工具連接目標。 - 配置工作區：連接成功後，將返回的錨點目錄作爲工作區打開，並在該工作區下新建會話。此時 agent 的所有操作將自動落在這個遠程環境上。
適用場景與注意¶
- 遠端環境要求：SSH 需要遠程開啓
sshd並有登錄賬號；WSL 需要已安裝的發行版；Docker 需要已運行的容器。遠端無需安裝 DSH 或 API key。 - 本地錨點限制：本地錨點目錄是有界的、只讀鏡像。超過單文件上限（256 KiB）的文件會顯示佔位文件，內容不會拉取到本地。搜索（glob/grep）在遠程執行，不依賴本地 ripgrep。
- 權限提示：插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證。
短結尾¶
該插件通過將計算與存儲分離，降低了本地環境配置的複雜度，使 agent 能夠安全地操作遠程資源。詳細信息可查閱項目目錄：dsh-multi-remote 或源碼：GitHub。
