前言¶
DeepSeek Harness (DSH) Web GUI 通過插件體系擴展功能。當需要在同一個界面中管理多臺服務器的 SSH 連接時，直接打開多個終端窗口會分散注意力。dsh-ssh-hub 插件爲 DSH 提供了一個集成式的終端面板，支持在一個懸浮窗口中管理多個會話、分組視圖以及廣播命令。
插件簡介¶
這是一個用於 DeepSeek Harness Web GUI 的多服務器 SSH 終端面板。
* 維護者：JUNQINGV587
* 許可證：MIT
* 核心價值：在 DSH 界面中通過一個可拖拽、可調整大小的懸浮窗口，提供類似 Wave Terminal 的多會話管理體驗。
核心功能¶
- 終端窗口：窗口懸浮於 GUI 之上，支持拖拽標題欄移動、拖拽角落調整大小、雙擊標題欄最大化。窗口失焦時僅變暗邊框，終端輸出始終可見。
- 標籤頁與會話：一個標籤頁對應一個會話，支持
Alt+1-9快速切換。標籤欄顯示連接狀態（連接中/運行中/已關閉），產生輸出時會有琥珀色脈衝提示。 - 分組視圖：支持將多個會話並排顯示。通過拖拽標籤頁可合併、拆分或調整順序；拖拽標籤頁到另一個標籤頁可創建分組。分組內可執行廣播命令。
- 會話面板：提供全局視圖，顯示所有會話狀態、回收倒計時，並提供操作入口。
- 會話歸屬：會話由主機託管，關閉窗口、移除視圖、刷新頁面或切換對話時不會銷燬會話，網絡恢復後會自動重連。
- 快捷鍵系統：提供 Wave 風格的 Alt 組快捷鍵（如
Alt+m放大視圖），所有操作可在設置中自定義。 - 認證方式：支持密碼、私鑰（帶口令）、SSH Agent 和無認證四種方式。
- 連接測試：保存服務器前可進行延遲和認證檢查，失敗時會在窗口內顯示具體原因。
- 主題適配：終端界面跟隨 DSH GUI 主題，並遵守 WCAG 對比度標準（前景/背景對比度 >= 7:1）。
- 配置與安全：
- 支持設置卡片（DSH >= 0.1.0-rc.7），可配置超時、保活間隔、終端主題和會話回收時間。
- 密碼和私鑰以
0600權限存儲在本地，API 不會返回這些敏感信息。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add github:JUNQINGV587/dsh-ssh-hub
安裝完成後重啓 DSH 並刷新瀏覽器即可使用。
典型用法¶
- 打開終端：點擊左側邊欄底部的「SSH 終端」按鈕，或使用快捷鍵 `Ctrl+Shift+`` 打開窗口。
- 添加服務器：進入「管理服務器」 -> 「添加服務器」，填寫名稱、主機、端口、用戶名，並選擇認證方式（密碼/私鑰/SSH Agent/無認證）。
- 新建會話：在終端窗口的標籤欄點擊「新會話」，選擇服務器即可建立連接。
- 創建分組：點擊「新建組合」按鈕並勾選會話，或直接將一個標籤頁拖拽到另一個標籤頁上以合併爲分組。
- 廣播命令：在分組視圖下，點擊「廣播」，選擇目標成員，輸入命令並回車，命令將同時發送給選中的所有成員。
- 放大視圖：雙擊終端內的文本塊，或按
Alt+m可將當前內容放大至窗口大小。
適用場景與注意¶
- 環境要求：需要 DSH Web GUI（測試版本
dsh >= 0.1.0-rc.7）以及 Node.js >= 20。 - 權限要求：SSH 守護進程必須允許來自運行 DSH 的機器的登錄請求。
- 安全性：插件以當前 DSH 進程的權限運行，請謹慎在非迴環地址（如
0.0.0.0）上暴露 DSH Web 服務。 - 構建問題：從 Git 倉庫安裝時，如果遇到
Ignored build scripts錯誤，需在配置文件中添加allowBuilds鍵。
結語¶
dsh-ssh-hub 通過分組管理和廣播功能，簡化了多服務器運維流程。插件具備完善的測試套件和主題適配能力，適合需要頻繁在多個 SSH 會話間切換的 DSH 用戶。
插件目錄：https://www.skillhub.cn/plugins/JUNQINGV587/dsh-ssh-hub
GitHub 倉庫：https://github.com/JUNQINGV587/dsh-ssh-hub
