dsh Remote SSH

English | 中文

把 SSH 主机作为 DeepSeek Harness 中的透明工作区使用。

选择 LOCAL > project 时，普通文件、搜索、shell 和后台任务工具在本机运行；选择 > project 时，同一批工具改在对应 SSH 主机上运行。插件不会增加另一套 remote_* 工具，远端失败也绝不会回退本机。

功能

• 自动读取用户与系统 OpenSSH 配置，包括递归 Include，并发现其中的具体主机；
• 在设置页面管理多台 SSH 主机，以及每台主机上的多个工作区；
• 本机和远端使用同一个可编辑目录浏览器；
• 工作区与终端调用显示为 LOCAL > ... 或 > ...；
• 文件系统、搜索、子进程、后台任务和终端都根据当前工作区透明路由；
• 远端搜索结果始终使用 POSIX 路径；超长工具结果保存在对应 SSH 主机的私有运行目录，可继续用 read/grep 分页读取；
• POSIX 远端工作区只显示 bash，Windows 本机工作区只显示 pwsh；
• 每台服务器复用一条 SSH/AHP 长连接；每次 Bash 调用像 VS Code 新建终端标签页一样打开独立 channel，不会重新进行 SSH 握手；
• 同一服务器上的多个工作区共享一个 host 级 SSH/AHP 连接；
• 删除远端映射后保留可阅读的 Workspace 与 Session 历史，但旧会话不能继续调用工具。

远端工作区目前支持 POSIX/Linux 主机，尚未支持 Windows SSH 主机。

安装

把已发布 bundle 安装到 Web profile：

dsh plugin --profile web add dsh-remote-ssh
dsh web

从 DeepSeek Harness 源码 checkout 运行时，用 pnpm dsh 代替 dsh。本地开发插件时：

pnpm install
pnpm run check
pnpm dsh plugin --profile web add link:E:/absolute/path/to/dsh-remote-ssh
pnpm dsh --profile web

Codex、Claude Code 及其他自动化 Agent 应直接遵循 INSTALL.md。它是一份完整且可重复执行的安装 runbook。

设置主机

1. 先用普通 OpenSSH 配置并验证主机，推荐使用 SSH Key 或 SSH Agent 认证。
2. 打开 设置 → Remote SSH。页面会自动读取平台默认的用户与系统 SSH 配置。
3. 测试主机，然后用 浏览远端… 选择工作区目录。
4. 在 > 中新建或打开会话。

如需使用非默认配置，在 设置 → 插件 → Remote SSH → 自定义 SSH 配置文件 中填写绝对路径。

远端主机需要：

• POSIX shell，以及可非交互使用的 OpenSSH 连接；
• 用于 shell 和子进程执行的 bash、base64 与 mkfifo；
• 为 glob 和 grep 工具提供的 rg；
• 由官方 VS Code CLI 或已有 VS Code Server 提供的 VS Code Agent Host。

插件会依次检查 PATH 中的 code、私有位置 ~/.dsh-remote-ssh/cli/bin/code，以及主机上已经缓存的兼容 VS Code Server。插件不会静默安装远端软件包。