前言¶
DSH 的插件機制允許把更多工作流接入本地界面。對於經常需要在遠程超算或服務器上編輯文件、執行終端命令的使用者，常見做法是先本地編輯再同步，或單獨打開 SSH 窗口操作。@zhangfengshun/dsh-remote-ssh 提供另一條路徑：通過 SSH 連接遠程主機後，在 DSH 內置「文件」「終端」頁籤中直接操作遠程文件和終端。
插件定位¶
@zhangfengshun/dsh-remote-ssh 是一個類 VSCode Remote-SSH 的 DSH 插件，由 ZhangFengshun 維護，許可證爲 MIT。它的目標不是把遠程文件同步到本地後再編輯，而是通過 SSH 連接遠程超算或服務器，直接在 DSH 內置「文件」「終端」頁籤中操作遠程文件與遠程終端。
核心能力¶
下面介紹插件已覈實的幾項能力。
- SSH 連接：支持密鑰/密碼認證，支持 ProxyJump 跳板機，可從
~/.ssh/config一鍵導入。 - 遠程文件：內置「文件」頁籤可直接 SSH 讀寫遠程文件，無需同步。
- 遠程終端：內置「終端」頁籤可自動檢測遠程工作區，進入 SSH 交互式終端。
- 遠程工作區：選擇遠程目錄創建原生工作區，一鍵進入遠程環境。
- 模型工具：提供 12 個
remote_ssh_*工具，支持會話感知免填連接參數。
安裝與啓用¶
先確認當前 DSH 環境滿足 Node 引擎要求：>=20。
然後使用以下命令安裝到指定 profile：
dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.1.7
這裏的 <name> 表示目標 DSH profile。安裝完成後需要重啓 DSH。
啓用時還要注意 bundles 順序：@zhangfengshun/dsh-remote-ssh 必須在 bundles 列表中排在 dsh-better-sidebar 之後。
典型用法¶
下面是從遠程連接到進入遠程工作區的基本步驟。
- 進入設置，打開「遠程連接」，添加連接，填寫主機、端口、用戶、密鑰，然後點「測試連接」驗證。
- 添加工作區時，選擇「選擇遠程目錄…」，選擇連接，瀏覽並選擇遠程目錄。
- 打開內置「文件」頁籤，頁面會直接顯示遠程文件；編輯並保存後直接寫回遠程。
- 打開內置「終端」頁籤，插件會自動 SSH 到遠程主機；該自動 SSH 路徑僅支持密鑰認證。
模型工具¶
插件提供 12 個 remote_ssh_* 模型工具。在遠程工作區會話中調用這些工具時，可免填連接參數，減少每次調用時重複指定連接配置的操作。
適用場景與注意¶
這個插件適合需要在 DSH 中直接操作遠程超算、遠程服務器文件和終端的場景，尤其是已經有 SSH 連接配置、希望減少本地與遠端手動同步步驟的使用者。
使用前注意以下幾點：
- 安裝後需重啓 DSH。
@zhangfengshun/dsh-remote-ssh必須在 bundles 列表中排在dsh-better-sidebar之後。- Node 引擎要求
>=20。 - 內置「終端」頁籤自動 SSH 到遠程主機時僅支持密鑰認證。
- 插件會以當前 dsh 進程的權限運行，安裝前應檢查源碼與許可證。
鏈接¶
- GitHub：https://github.com/ZhangFengshun/dsh-remote-ssh
- 目錄頁：本次已覈實事實未包含目錄頁 URL，請以當前 DSH 插件目錄入口爲準。
