DeepSeek Harness (DSH) 採用插件化架構，開發者通常需要在 Web 界面中管理雲服務器連接。dsh-cloud-connector 插件解決了這一需求，將 SSH 連接管理集成進 DSH 的 Web GUI，並提供了一套對話工具以支持在聊天窗口中直接操作服務器。
插件信息¶
- 項目名稱：
gzr123166/dsh-cloud-connector - 核心定位：Codex 風格的雲服務器 SSH 連接管理器
- 維護者：gzr123166
- 許可證：MIT
核心功能¶
1. 可視化設置頁管理¶
在 DSH 的設置頁「SSH 連接」中，提供可視化的操作界面：
- 添加連接：輸入 IP、端口、用戶名及私鑰路徑即可建立連接。
- 獨立控制：每臺服務器擁有獨立的開關，可隨時連接或斷開。
- 多服務器管理：支持對配置進行編輯（⚙）和刪除（🗑）。
- 開機自動連接：每臺服務器可單獨設置是否在 DSH 啓動後自動連接。
- 配置持久化：服務器列表及配置存儲在 servers.json 文件中，重啓 DSH 後配置不丟失。
2. 端口隧道¶
支持通過 SSH 隧道將服務器上的端口映射到本地瀏覽器：
- 支持將服務器監聽的本地端口（如 Jupyter、數據庫）映射到 localhost:本地端口。
- 提供啓停開關及開機自動建立功能。
3. 對話工具¶
插件提供一組 cloud_* 工具，可在對話中直接使用：
- cloud_connect：連接服務器。
- cloud_exec：遠程執行命令。
- cloud_transfer：文件上傳/下載。
- cloud_server_info：獲取系統信息（主機名、CPU、內存、磁盤、GPU、Python 版本）。
- cloud_gpu_monitor：GPU 監控。
- cloud_env_manager：Conda/Python 環境管理。
- cloud_task_queue：Slurm 任務隊列管理。
- cloud_list_connections：列出服務器及連接狀態。
- cloud_disconnect：斷開連接。
- cloud_manage_servers：增刪改服務器配置及自動連接設置。
安裝與啓用¶
方式一：使用 dsh plugin 命令¶
在終端中執行以下命令：
dsh plugin --profile web add github:gzr123166/dsh-cloud-connector#main
方式二：手動安裝¶
- 將本倉庫添加到
~/.dsh/profiles/web/package.json的 dependencies 中。 - 執行安裝命令：
cd ~/.dsh/profiles/web
pnpm install
- 確認
~/.dsh/profiles/web/package.json中的dsh.profile.bundles數組包含dsh-cloud-connector。 - 重啓 DSH。
使用流程¶
- 添加服務器：打開 DSH，進入「設置 → SSH 連接」，點擊「+ 添加」，填寫服務器信息並連接。
- 配置隧道：在設置頁底部的「端口隧道」區域，配置服務器端口到本地的映射。
- 對話操作：在聊天窗口中直接調用
cloud_*工具執行命令、管理環境或查看監控。
注意事項¶
- 私鑰路徑：默認私鑰路徑爲
C:/Users/linxianyuan/.ssh/id_rsa_cloud（示例路徑），使用前需替換爲實際的私鑰路徑。 - 配置文件：
servers.json文件已加入.gitignore，請勿提交到代碼倉庫。 - Windows 路徑問題：在 Windows 下執行 SSH 命令時，中文路徑可能導致命令行損壞，推薦使用 ASCII 路徑。
- 客戶端開發規範：插件開發時，
lib/client.js必須使用window.__ModuleLoader__.load({...})工廠包裝格式。
生態背景¶
DSH 強調「一切皆插件」，該插件由社區維護。完整文檔與源碼可參考項目主頁。
