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

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

能力

能力	说明
主机管理	增删改查、搜索、连接测试；配置存 ~/.dsh/dsh-ssh.json；支持密钥 / 密码认证、passphrase 密钥、ProxyJump 跳板机（多级）
配置导入	一键解析标准 ~/.ssh/config（Host/HostName/User/Port/IdentityFile/ProxyJump 等），已有别名自动跳过
持久连接池	每台主机复用长连接（对应 ssh-skill 的守护进程），空闲 30 分钟自动断开，断线自动重连（最多 3 次）
命令执行	exec 带超时（默认 60s），stdout/stderr 分离，输出截断保护（2MB）
Web 终端	xterm.js + WebSocket PTY 终端，自适应尺寸，实时输出
文件传输	SFTP 上传（浏览器选文件，NDJSON 进度流）、下载（进度条 + 浏览器保存）；远程目录浏览
端口转发	本地端口转发隧道（仅监听 127.0.0.1），访问远程数据库 / 内网服务，支持列表 / 停止
集群执行	一条命令并发跑多台主机（按别名 / 环境 / 标签过滤，默认并发 8）
Agent 工具	ssh_list / ssh_exec / ssh_upload / ssh_download / ssh_tunnel / ssh_cluster，GUI 与 Agent 共享同一份主机配置

安全模型

• 所有 /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 可能把远端环境中的 密钥带回对话记录。

安装

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

# 推荐：直接从 npm 安装
dsh plugin --profile web add @captain1275/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