前言¶
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
