dsh-remote-dock
在 DeepSeek Harness 中使用 SSH 与 WSL 远程工作区
dsh-remote-dock 为 DeepSeek Harness 添加「远程」入口。连接 Linux 服务器(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-dock#v0.1.5
安装后重启 DSH 并刷新页面,侧栏会出现 远程。
使用命令行安装如果终端已能运行 dsh,可执行:
dsh plugin --profile desktop add "github:Lee-Eee-Eee/dsh-remote-dock#v0.1.5"
将 desktop 替换成宿主实际使用的 profile;网页版通常使用 web。安装到其他 profile 的插件不会出现在当前宿主中。
从旧名升级
本项目现名为 dsh-remote-dock,原名为 dsh-remote。先在当前 profile 的插件管理器中移除旧版,再添加上面的新来源并重启 DSH;新旧两份应只启用一份。已保存的目标、远程安装和模型配置会继续使用。
dsh-remote-workspace@0.1.0-alpha.* 是其他项目的旧 npm 包。本项目使用本页给出的 GitHub 来源安装。
首次连接
添加目标:打开「远程」,点 SSH 主机或 WSL 发行版旁的
+。也可用「添加目标」填写 SSH 别名或主机信息。探测环境:选择目标,点击「探测环境」。缺少 Node 或 DSH 时,打开「查看安装计划」,确认要执行的步骤后安装。

准备模型:远程尚未配置模型时,打开「移植本地配置」,选择所需的服务商、默认模型和 API 密钥组,点击「写入并重启」。API 密钥组会复制实际密钥值,请使用你信任的目标。远程已有可用模型时可跳过这步。
连接:点击「连接」,在主区打开远程 DSH,选择远程项目开始工作。连接后右侧即目标机器上的 DSH,模型与服务商沿用本机配置。

配置移植的预览只显示名称和数量,并排除本机浏览器会话凭据。远程会话与项目由嵌入的 DSH 界面管理。
连接后
多个目标可以同时保持连接,各自独立:切换目标就是切换一台机器的 DSH,互不影响。

| 操作 | 作用 |
|---|---|
| 重载 | 刷新远程界面 |
| 重启 | 重新启动目标上的 DSH |
| 停止远程 | 结束目标实例并断开本地连接 |
| 关闭面板 / 退出本地 DSH | 保留远程进程,之后可重新连接 |
环境要求
| 环境 | 要求 |
|---|---|
| DSH 宿主 | 0.2.1-rc.2 或更新版本 |
| 宿主运行环境 | Node 22.x(≥ 22.19.0),或 24 及以上 |
| SSH 目标 | Linux x86_64 / arm64,使用密钥或 agent 免交互登录 |
| 自动安装环境 | bash、tar,以及 curl 或 wget |
| WSL | Windows 与发行版之间回环可达;支持 mirrored 网络或启用 localhost forwarding 的 NAT 网络 |
常见问题
安装后没有「远程」入口? 确认安装到了当前宿主使用的 profile,然后重启 DSH、刷新页面。
SSH 连接失败? 先在本机终端确认 ssh <别名> 可以免交互登录,并且服务器允许 SSH 端口转发。密码提示不受支持。
界面能打开,但模型无法使用? 检查远程模型配置;使用「移植本地配置」写入后,重启远程 DSH。
市场显示「宿主要求未知」或旧截图? 使用 dshmarket 1.73.0 或更新版本识别 GitHub 插件的宿主要求;截图随市场目录构建同步。见市场展示信息。
WSL 网络、主机密钥和内嵌认证问题见技术参考中的排错。
No comments yet. Be the first to write one.