前言¶
DeepSeek Harness（DSH）採用插件化架構。在使用過程中，可能需要管理多臺物理或虛擬機。通常每個 DSH 後端實例對應一個工作區，切換後端會中斷當前會話。本插件通過 SSH 協議連接多臺機器，將它們的工作區與會話聚合到同一原生側欄中，任務在所屬機器運行，無需在多臺機器間切換。
是什麼¶
wazzfhaha/dsh-multi-end 是一個 DSH 插件，通過 SSH 管理多臺機器的工作區與會話。
它由 Wazzfhaha 維護，遵循 MIT 許可證。核心功能是利用 SSH 協議將多臺遠程機器的 DSH 實例納入統一管理，實現跨機器的工作區瀏覽和會話交互。
核心功能¶
-
主機與連接管理
支持手動添加 SSH 主機，或從本地的~/.ssh/config導入配置。SSH 端口和 DSH 端口可獨立配置。支持斷線有限次重試、手動重連。連接時會進行只讀檢查，驗證工作區與會話控制的基礎協議。 -
統一側欄與原生界面
聚合原生工作區側欄，遠端工作區會標註來源機器。會話界面保持原生風格。原生“+”按鈕仍用於主後端的工作區添加，遠端工作區添加需在“多端管理”中操作。 -
會話管理
支持對遠端會話進行改名、歸檔、取消歸檔、置頂以及在同一工作區內排序。已歸檔的會話會從管理頁的快捷列表中隱藏。 -
文件與目錄操作
支持遠端目錄瀏覽和新建文件夾。當遠端目錄接口不可用時，會自動回退到 SSH 的 SFTP 子系統進行瀏覽和新建。也可以手動輸入絕對路徑添加工作區。 -
消息路由
顯式路由對話、取消、歷史、分叉、附件、消息隊列及會話 skills 請求。
安裝與啓用¶
在運行主 DSH 後端的終端中執行以下命令：
dsh plugin --profile web add -w https://github.com/Wazzfhaha/dsh-multi-end/releases/download/v0.0.8/dsh-ssh-workspaces-0.0.8.tgz
安裝後重啓對應後端，打開“設置 → DSH 多端管理”即可開始使用。
典型用法¶
- 添加主機：在“多端管理”頁面手動添加 SSH 主機，或從 SSH config 導入。
- 添加遠端工作區：在已連接的主機列表中，點擊添加遠端工作區，瀏覽或填寫目錄路徑。
- 操作遠端會話：在側欄中直接使用原生會話界面進行對話、歸檔或置頂操作。
- 斷線重連：遇到斷線時，插件會自動嘗試重連。連接失敗或需要強制重連時，可在管理頁點擊“重連”。
適用場景與注意¶
本插件通過 SSH 連接遠端 DSH，因此遠端機器必須已安裝並運行 DSH，但不需要安裝本插件。
在安裝前，建議檢查源碼與許可證。對於舊版本用戶，請先檢查舊配置，避免重複註冊。使用時需注意以下限制：
- 功能轉發：工具審批、用戶提問和第三方交互卡片尚未轉發，這些場景需使用所屬後端的界面。
- SFTP 要求：目錄接口不可用時回退到 SFTP，要求該 SSH 用戶啓用 SFTP，且 SFTP 與 DSH 看到的絕對路徑一致（不支持路徑不同的 chroot）。
- 不支持的功能：遠端文件側欄、跨機器移動、全局配置同步不在當前支持範圍。
- 平臺驗證：Windows 和 macOS 遠端尚未實機驗證。
總結¶
該插件通過 SSH 實現了多臺 DSH 機器的統一側欄管理，適合需要在同一界面維護多臺機器工作區的開發者。更多細節可查閱官方目錄頁與 GitHub 倉庫。
