前言¶
DeepSeek Harness（DSH）采用插件化架构。在使用过程中，可能需要管理多台物理或虚拟机。通常每个 DSH 后端实例对应一个工作区，切换后端会中断当前会话。本插件通过 SSH 协议连接多台机器，将它们的工作区与会话聚合到同一原生侧栏中，任务在所属机器运行，无需在多台机器间切换。
是什么¶
wazzfhaha/dsh-multi-end 是一个 DSH 插件，通过 SSH 管理多台机器的工作区与会话。
它由 Wazzfhaha 维护，遵循 MIT 许可证。核心功能是利用 SSH 协议将多台远程机器的 DSH 实例纳入统一管理，实现跨机器的工作区浏览和会话交互。
核心功能¶
-
主机与连接管理
支持手动添加 SSH 主机，或从本地的~/.ssh/config导入配置。SSH 端口和 DSH 端口可独立配置。支持断线有限次重试、手动重连。连接时会进行只读检查，验证工作区与会话控制的基础协议。 -
统一侧栏与原生界面
聚合原生工作区侧栏，远端工作区会标注来源机器。会话界面保持原生风格。原生“+”按钮仍用于主后端的工作区添加，远端工作区添加需在“多端管理”中操作。 -
会话管理
支持对远端会话进行改名、归档、取消归档、置顶以及在同一工作区内排序。已归档的会话会从管理页的快捷列表中隐藏。 -
文件与目录操作
支持远端目录浏览和新建文件夹。当远端目录接口不可用时，会自动回退到 SSH 的 SFTP 子系统进行浏览和新建。也可以手动输入绝对路径添加工作区。 -
消息路由
显式路由对话、取消、历史、分叉、附件、消息队列及会话 skills 请求。
安装与启用¶
在运行主 DSH 后端的终端中执行以下命令：
dsh plugin --profile web add -w https://github.com/Wazzfhaha/dsh-multi-end/releases/download/v0.0.8/dsh-ssh-workspaces-0.0.8.tgz
安装后重启对应后端，打开“设置 → DSH 多端管理”即可开始使用。
典型用法¶
- 添加主机：在“多端管理”页面手动添加 SSH 主机，或从 SSH config 导入。
- 添加远端工作区：在已连接的主机列表中，点击添加远端工作区，浏览或填写目录路径。
- 操作远端会话：在侧栏中直接使用原生会话界面进行对话、归档或置顶操作。
- 断线重连：遇到断线时，插件会自动尝试重连。连接失败或需要强制重连时，可在管理页点击“重连”。
适用场景与注意¶
本插件通过 SSH 连接远端 DSH，因此远端机器必须已安装并运行 DSH，但不需要安装本插件。
在安装前，建议检查源码与许可证。对于旧版本用户，请先检查旧配置，避免重复注册。使用时需注意以下限制：
- 功能转发：工具审批、用户提问和第三方交互卡片尚未转发，这些场景需使用所属后端的界面。
- SFTP 要求：目录接口不可用时回退到 SFTP，要求该 SSH 用户启用 SFTP，且 SFTP 与 DSH 看到的绝对路径一致（不支持路径不同的 chroot）。
- 不支持的功能：远端文件侧栏、跨机器移动、全局配置同步不在当前支持范围。
- 平台验证：Windows 和 macOS 远端尚未实机验证。
总结¶
该插件通过 SSH 实现了多台 DSH 机器的统一侧栏管理，适合需要在同一界面维护多台机器工作区的开发者。更多细节可查阅官方目录页与 GitHub 仓库。
