DSH 多端管理 · Remote SSH

DSH 多端管理：通过 SSH 远程连接多台机器，在同一原生侧栏管理工作区与会话，任务在所属机器运行。支持手动添加主机或导入已有 SSH config；全局设置仍使用主后端。

Remote SSH multi-host management for DSH. Access remote workspaces and sessions in one native sidebar, with tasks running on their original machines.

0.0.7 开发预览。适配基线：DSH 0.1.5-rc.1。尚未完成跨平台实机验收与完整交互支持。

界面预览

以下为真实 DSH 页面和插件组件，使用虚构的演示主机与会话。

查看手动添加主机界面

安装与使用

当前提供 v0.0.7 安装包，验证基线为 DSH 0.1.5-rc.1。

在运行主 DSH 后端的终端中执行：

dsh plugin --profile web add -w https://github.com/Wazzfhaha/dsh-multi-end/releases/download/v0.0.7/dsh-ssh-workspaces-0.0.7.tgz

如使用其他 profile，请替换 web。安装后重启对应后端，打开“设置 → DSH 多端管理”，手动添加 SSH 主机或从 SSH config 导入。

远端需运行 DSH，但不需要安装本插件。曾手动安装或使用本地链接安装本插件的用户，请先检查旧配置，避免重复注册。

详见 安装说明 和 兼容性与限制。

0.0.7 修复

• 主后端重启后，自动恢复此前成功连接的 SSH 主机；主动断开后不再自动连接。升级后需先成功连接一次，以记录恢复意愿。
• 远端会话的运行、完成与活动通知实时进入原生侧栏，无需刷新页面。
• 不保存带令牌的登录链接，不重发消息或任务。手动登录链接连接仍需重新提供凭证。

已实现

• 手动添加主机、选择导入 SSH config；SSH 和 DSH 端口独立配置。
• 聚合原生工作区侧栏，标注后端来源；使用原生会话界面。
• 浏览远端已有目录、添加工作区、在所属工作区创建会话。
• 会话改名、归档与同一工作区内排序；已归档会话从管理页快捷列表隐藏。
• 显式路由对话、取消、历史、分叉、附件、消息队列及会话 skills 请求。
• 断线有限次重试、手动重连；保留未发送草稿，不自动重发失败消息。
• 连接时只读检查工作区与会话控制基础协议；这不代表已识别远端版本或验证全部操作。

当前限制

工具审批、用户提问和第三方交互卡片尚未转发；这些场景需要使用所属后端的界面。归档恢复没有接入。远端文件侧栏、跨机器移动、全局配置同步不在当前支持范围。Windows/macOS 远端尚未实机验证。详见 兼容表。

安装与使用 · 手动上传 GitHub

开发

使用 Node.js 24+：

npm ci
npm run build
npm test

src/browser/ 是浏览器源文件，src/client.js 是生成入口。测试使用 Node 内置框架和本地模拟服务，不会连接真实 SSH 主机或发送模型请求。真实后端验收须使用独立 profile 和专用测试会话。

直接在这个固定 Git 仓库中开发、运行和提交；升级版本不更换目录，也不再导出源码副本。node_modules/ 和 .runtime/ 不纳入 Git。当前包保留 private: true，避免误发布到 npm。Linux 登录探测的补充测试可运行 python3 -B tests/remote-probe.test.py。

插件依赖 DSH 的运行时 gateway 适配，不修改其安装文件；它不是上游承诺稳定的多后端扩展接口。更新 DSH 后需要重新验收。

MIT 许可证仅覆盖本项目代码；DSH 和依赖项保留各自许可证。