Skip to main content
L

dsh-remote

lee-eee-eee/dsh-remote

Use SSH hosts and WSL distributions as remote DSH workspaces, with environment setup, model configuration porting, and the remote interface embedded locally.

Install

dsh plugin --profile web add github:lee-eee-eee/dsh-remote

README

dsh-remote

dsh-remote

在 DeepSeek Harness 中使用 SSH 与 WSL 远程工作区

Release CI MIT license

简体中文 / English · 安装 · 使用 · 文档

dsh-remote 为 DeepSeek Harness 添加「远程」入口。连接 Linux 服务器(SSH)或 WSL 发行版后,目标上的完整 DSH 界面会出现在本地主区;文件读写和命令执行都发生在目标环境中。

远程工作区:左侧管理 SSH 与 WSL 目标,右侧使用远程 DSH

真实桌面截图。

功能

  • SSH 与 WSL 目标管理:发现 SSH 配置中的主机和本机 WSL 发行版,也可手动添加。SSH 连接沿用本机密钥、agent 和跳板机配置。
  • 远程环境准备:探测 Node 与 DSH,先展示安装计划,再按确认的步骤安装到用户目录,无需 sudo。
  • 模型配置移植:将本机服务商配置、默认模型和 API 密钥复制到远程,写入前备份原文件。
  • 连接管理:在面板内重载、全屏、重启或停止远程 DSH;重新连接时优先恢复已有实例,SSH 隧道断开后自动重试。

安装

需要 DSH 0.2.1-rc.2 或更新版本。在插件管理器中添加以下来源:

github:Lee-Eee-Eee/dsh-remote#v0.1.3

安装后重启 DSH 并刷新页面,侧栏会出现 远程。

使用命令行安装

如果终端已能运行 dsh,可执行:

dsh plugin --profile desktop add "github:Lee-Eee-Eee/dsh-remote#v0.1.3"

将 desktop 替换成宿主实际使用的 profile;网页版通常使用 web。安装到其他 profile 的插件不会出现在当前宿主中。

首次连接

  1. 添加目标:打开「远程」,点 SSH 主机或 WSL 发行版旁的 +。也可用「添加目标」填写 SSH 别名或主机信息。
  2. 探测环境:选择目标,点击「探测环境」。缺少 Node 或 DSH 时,打开「查看安装计划」,确认要执行的步骤后安装。
  3. 准备模型:远程尚未配置模型时,打开「移植本地配置」,选择所需的服务商、默认模型和 API 密钥组,点击「写入并重启」。API 密钥组会复制实际密钥值,请使用你信任的目标。远程已有可用模型时可跳过这步。
  4. 连接:点击「连接」,在主区打开远程 DSH,选择远程项目开始工作。

配置移植的预览只显示名称和数量,并排除本机浏览器会话凭据。远程会话与项目由嵌入的 DSH 界面管理。

连接后

操作作用
重载刷新远程界面
重启重新启动目标上的 DSH
停止远程结束目标实例并断开本地连接
关闭面板 / 退出本地 DSH保留远程进程,之后可重新连接

环境要求

环境要求
宿主运行环境Node 22.x(≥ 22.19.0),或 24 及以上
SSH 目标Linux x86_64 / arm64,使用密钥或 agent 免交互登录
自动安装环境bash、tar,以及 curl 或 wget
WSLWindows 与发行版之间回环可达;支持 mirrored 网络或启用 localhost forwarding 的 NAT 网络

常见问题

安装后没有「远程」入口? 确认安装到了当前宿主使用的 profile,然后重启 DSH、刷新页面。

SSH 连接失败? 先在本机终端确认 ssh <别名> 可以免交互登录,并且服务器允许 SSH 端口转发。密码提示不受支持。

界面能打开,但模型无法使用? 检查远程模型配置;使用「移植本地配置」写入后,重启远程 DSH。

WSL 网络、主机密钥和内嵌认证问题见技术参考中的排错。

文档与反馈

许可

MIT

Related plugins