dsh-ssh

中文 | English

通过 SSH 把 DeepSeek Harness 的工作区放到任意一台远端机器上 —— 直接在 DSH 设置页里配置主机、把它某个目录选成工作区，之后所有 bash / 文件 / 搜索工具调用都在那台机器上执行，而不是在你本机。

设置页里添加 SSH 主机

浏览远端目录，选为工作区

为什么选它

完全基于 DSH 面向第三方插件的官方公开契约构建 —— 纯附加、不改 DSH core 一行、远端零安装（只需要一个普通 sshd）。卸载后 DSH 恢复原样；本地工作区行为与之前逐字节一致。

功能

• 设置页 SSH 主机：直接在 DSH 设置页增 / 删 / 改主机（host / port / user / 密钥或口令），一键测试连接。
• 远端目录即工作区：创建工作区时浏览远端目录树，任意选一个文件夹；本地 / 远端工作区共存，随时切换运行机器。
• 七工具远端执行：bash、read、write、edit、read_image、glob、grep 全在远端执行 —— 同名同参，对模型无感。
• 首次信任（TOFU）：首次连接未知主机会弹出指纹确认，之后每次连接都会校验主机密钥。
• 后台任务远端化：run_in_background 连同 job_list / job_output / job_kill 整条链路都在远端执行。
• Sandbox 远端同样生效：三种 sandbox 模式在远端与本地行为一致。
• 默认健壮：known_hosts 校验、断线自动重连、原子写入（临时文件 + rename）、ssh2 连接池（exec + SFTP 复用）。
• 凭据只写存储：口令经 DSH settings 的 secret 机制只写保存；私钥按本地路径引用。

安装

dsh plugin --profile web add @dsh-ssh/dsh-ssh

若 pnpm 报 ERR_PNPM_ADDING_TO_ROOT，在命令末尾加 -w（profile 目录是 pnpm workspace 根，pnpm 11 需要显式允许）。安装时若看到 cpu-features 编译失败的日志属正常——它是可选的原生加速依赖，失败会自动回退纯 JS 实现，不影响功能。

重启 DSH，在设置页添加你的第一台主机。

快速上手（30 秒）

1. 添加主机 —— 设置页 → SSH 主机 → 添加主机，填 host / port / user / 认证方式，点测试连接。
2. 信任密钥 —— 首次连接会弹指纹确认（TOFU），确认即信任。
3. 创建远端工作区 —— 新会话 → 创建 / 切换工作区 → 浏览远端目录 → 选一个文件夹。
4. 完成 —— 工作区为远端时，工具自动经 SSH 路由到远端执行，其余无需配置；standard preset 即可。

什么在哪侧执行

在远端工作区中，只有下面七个路由工具落在远端主机上：

兼容性

已知限制

• 不支持 ProxyJump / 多跳 —— 仅单跳直连。
• 远端 grep 基于 GNU grep，忽略规则与 rg 略有差异。
• 远端禁用 SFTP 时，文件操作自动降级为 exec + base64（可用但更慢）。
• 不支持 Windows 远端。

FAQ

会影响我的本地工作区吗？ 不会。插件是纯附加的 —— 本地路径仍走 DSH 宿主自身实现，逐字节不变。

支持后台任务吗？ 支持。run_in_background 与 job_list / job_output / job_kill 整条链路都在远端执行。

凭据安全吗？ 口令经 DSH secret 机制只写存储；私钥按本地路径引用、从不复制。未知主机在信任前都会先经 TOFU 指纹确认把关。

需要专用 preset 吗？ 不需要。工具路由与 preset 无关，standard preset 即可。

如何卸载？

dsh plugin --profile web remove @dsh-ssh/dsh-ssh

DSH 完全复原，不留痕迹。

开发

本仓库是 pnpm workspace；面向开发者的文档在 packages/dsh-ssh/。包结构、测试与真机验证脚本见 packages/dsh-ssh/CONTRIBUTING.md。

License

MIT