dsh-ssh

dsh-ssh — 远程 SSH 运维插件（DSH 版 ssh-skill）

English | 中文

基于 badseal/ssh-skill 的能力清单，为 DeepSeek Harness（DSH）定制的远程 SSH 插件：Host 进程内的持久连接池 + Web GUI 主机管理面板 + Web 终端 + Agent 工具，全部通过官方 NPM SDK 实现，不修改 DSH 源码。

能力

安全模型

• 所有 /api/dsh-ssh/* 路由仅限 loopback 访问（含同源校验）——对远程服务器执行命令的接口不会暴露给局域网。
• 密码 / 密钥口令以明文保存在 ~/.dsh/dsh-ssh.json，文件权限 0600、目录 0700（与 ssh-skill 把密码写进 ssh-config 注释同一信任模型）。
• 隧道只监听 127.0.0.1。
• Agent 使用工具前，主机需先在 GUI 中配置（或从 ~/.ssh/config 导入）。
• ssh_upload / ssh_download 以宿主进程权限直接读写本机任意路径（不经 bash 沙箱）——与 ssh-skill 的宿主本地路径语义一致，注意该权限面。
• exec / cluster 的远程输出原样返回（不脱敏），命令如 env 可能把远端环境中的密钥带回对话记录。

安装

推荐直接安装全家桶聚合包 @linxin666/dsh-web-ui-all（一个包装齐全部功能插件与皮肤），或单独安装本插件：

### 从 npm 安装（推荐）
dsh plugin --profile web add @linxin666/dsh-ssh

### 从仓库安装（开发调试）
git clone https://github.com/zhu1090093659/dsh-web-ui.git
cd dsh-web-ui
pnpm install && pnpm -r build
dsh plugin --profile web add link:$(pwd)/packages/dsh-ssh

安装后重启 dsh web：侧边栏出现「SSH」入口；Agent 提示词中自动出现插件说明。

配置

设置面板（插件配置）可开关 announceToAgent（是否向 Agent 宣告插件）与 enabled（总开关）。

数据

• 主机配置：~/.dsh/dsh-ssh.json（版本化 JSON，原子写入）
• 传输暂存：os.tmpdir()/dsh-ssh-uploads/

开发

pnpm install --filter @linxin666/dsh-ssh...
pnpm --filter @linxin666/dsh-ssh test    # 单测：store + 引擎（内嵌 ssh2 Server + 真实 sshd）
pnpm --filter @linxin666/dsh-ssh build   # tsc 类型 + tsdown 双半区产物

已知限制

• 上传的远程目标路径必须是绝对路径（相对路径会被拒绝）。
• 下载暂不支持整个目录（逐文件下载）；上传支持目录递归（walk 本地目录逐文件传）。
• exec 断线自动重连（最多 3 次）可能重复执行非幂等命令——长命令注意副作用。
• 跳板机 ProxyJump 的每一跳必须是本插件已配置的主机别名。
• 断点续传（resume）暂未实现。
• Agent 工具的传输为宿主机器本地路径（与 ssh-skill 相同的语义）。