在使用 DeepSeek Harness (DSH) 進行開發或運維時，我們通常侷限於本地計算機的環境。如果需要操作遠程 Linux 服務器，往往需要額外的 SSH 連接腳本或手動登錄，這增加了操作步驟和出錯概率。DSH Remote SSH 插件提供了直接的解決方案，它允許 DSH 的原生工具直接在遠程服務器上執行。
這是什麼¶
這是一個由 NaNQiQ 維護的 DSH 插件。它的核心作用是讓 DSH 的原生工具（如 read、write、edit、glob、grep、bash、terminal 等）在遠程 Linux 服務器上運行。目標服務器不需要安裝 DSH、Node.js 或 Python，插件通過 SSH/SFTP 協議與遠程環境交互，從而擴展了 DSH 的操作範圍。
核心功能¶
- 服務器管理：可以在 DSH Web UI 中添加、測試、管理和選擇 SSH 服務器。
- 環境切換：在本地計算機和已保存的服務器之間切換執行環境。
- 原生工具保留：保持使用官方 DSH 工具，而非削減版的
ssh_*替代品。 - 協議支持：使用 SFTP 處理文件，使用 SSH exec/shell 執行命令，使用 SSH PTY 處理交互式終端。
- 搜索行爲一致：在保留原生
glob / grep行爲的同時，會解析並緩存遠程 Linux 主機的 ripgrep。 - 認證方式：支持通過 SSH Agent、私鑰文件或臨時密碼進行認證。
- 安全校驗：首次連接時會驗證 SSH 主機密鑰指紋，防止意外更改。
- 連接複用：重用 DSH Host 維護的連接，避免每條消息都重新登錄。
安裝與啓用¶
確保系統已安裝 Node.js 24 或更新版本，且 dsh 和 pnpm 在 PATH 中。執行以下命令安裝並啓動：
dsh plugin --profile web add github:NaNQiQ/deepseek-harness-remote-ssh
dsh web
典型用法¶
- 啓動
dsh web。 - 在對話編輯器旁邊打開執行環境選擇器。
- 選擇 Add server。
- 填寫連接信息、認證方式和默認工作目錄設置。
- 按照內置的認證指南操作，並驗證服務器指紋。
- 點擊 Test and save。
- 在選擇器中點擊已保存的服務器。
此後，模型將繼續使用官方 DSH 工具，只是這些工具背後的執行位置變成了遠程服務器。
適用場景與注意¶
- 目標環境：目標必須是安裝了 SSH、SFTP 和 POSIX shell 的 Linux / Unix 主機。
- 工作目錄：每個服務器可以定義默認工作目錄，這是初始的
cwd，並非路徑沙箱。 - 權限控制：實際訪問權限等於遠程 SSH 賬戶的權限。
- 文件系統隔離：Remote Provider 不會將 DSH Host 的本地文件系統暴露給遠程執行環境。
- 密鑰管理：模型 API 密鑰和 Base URL 仍由 DSH 管理，插件不讀取或存儲這些敏感信息。
- 重啓要求：更新或移除插件後，需要重啓 DSH。
總結¶
DSH Remote SSH 通過封裝 SSH 協議，讓 DSH 的工具生態無縫延伸至遠程服務器。開發者無需在目標服務器上部署環境，即可利用現有的工具鏈進行遠程操作。插件源碼位於 GitHub：https://github.com/NaNQiQ/deepseek-harness-remote-ssh。
