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 强调「一切皆插件」，该插件由社区维护。完整文档与源码可参考项目主页。
