ssh-plugin-dsh

DeepSeek Harness SSH 插件

在 DeepSeek Harness 中连接服务器，把终端、文件传输、服务器监控和 AI 运维放在同一个工作台里。

本项目基于 [jinpy666/dbx-plugin-ssh](https://github.com/jinpy666/dbx-plugin-ssh) 适配，复用其 Rust 后端和 Vue 终端工作台，并接入 Harness 的侧栏、连接管理与 Agent 工具服务。

[安装使用](#安装) · [Agent 自动化](#agent-自动化) · [配置与开发](docs/ADAPTATION.md) · [验证记录](docs/VALIDATION.md) · [上游项目](https://github.com/jinpy666/dbx-plugin-ssh)

先看效果

在 Harness 侧栏打开 SSH，同时使用 SFTP、终端和 CPU、内存、磁盘、网络监控。

可以用它做什么

| 场景 | 对应能力 |

| --- | --- |

| 日常巡检与问题排查 | 交互式终端、命令历史、快速命令、服务器指标与进程查看 |

| 管理远程文件 | SFTP 浏览、预览、上传、下载、重命名和目录管理 |

| 访问内网服务器 | 最多三跳 ProxyJump、连接保活和 Known Hosts 校验 |

| 控制运维权限 | 只读模式、sudo 配置、命令白名单和操作审计 |

| 自动化重复任务 | Harness Agent 复用已保存的连接，调用 SSH/SFTP 工具 |

核心能力

• 终端工作台：PTY 交互终端、窗口调整、批量输入、快速命令、终端录制与远程目录跟随。
• SFTP 文件管理：文件浏览、排序、预览、传输进度与取消；支持文件选择器和拖放上传。系统剪贴板文件粘贴取决于宿主是否提供原生 paste 文件事件。
• 服务器监控：CPU、内存、磁盘、网络趋势，以及进程、磁盘和容器管理面板。
• 连接与认证：密码、私钥、SSH Agent 和自动认证，保留上游跳板机、TOTP、键盘交互和受控提权能力。
• 中文界面与主题：创建连接的字段、说明和选项已中文化；私钥可通过「选择文件…」导入，工具栏与图表跟随 Harness 亮暗主题。
• 多会话工作台：同时打开不同服务器，或对同一服务器点击「新建会话」打开多个独立终端。顶部标签切换时保留各自的终端输出、输入和文件面板；点击标签旁的关闭按钮或「断开连接」只关闭当前会话。返回服务器列表或切换 Harness 侧栏也保留会话；刷新页面或退出 Harness 会结束当前客户端会话。
• Agent 与界面共享连接：提供 16 个 SSH/SFTP 工具，支持在可见终端中执行 AI/MCP 命令，方便查看执行过程。

当前主要面向 SSH/SFTP 运维。Telnet、串口、VNC、实验性 RDP 等上游实现仍保留，兼容情况与尚未验收的功能见[验证记录](docs/VALIDATION.md)。

安装

需要已安装的 DeepSeek Harness。仓库自带构建好的客户端和 macOS ARM64 后端；其他平台需先下载匹配的后端。

1. 克隆仓库

git clone https://github.com/foryourever/ssh-plugin-dsh.git
cd ssh-plugin-dsh

macOS ARM64 可直接继续安装。其他平台需要 Node.js 22+ 和 Python 3，在仓库目录运行：

npm run setup:backend

脚本按当前平台下载锁定版本的官方后端，并校验 SHA-256。发布资产覆盖 macOS ARM64/x64、Linux x64/ARM64、Windows x64；当前运行验收环境为 macOS ARM64。

2. 安装到 Harness

在可调用 plugin_manager 的 Harness 会话中，让 Agent 安装本地插件目录，例如：

> 使用 plugin_manager 安装本地 bundle，目录是 /absolute/path/to/ssh-plugin-dsh。

对应工具参数如下，将 target 替换为克隆目录的绝对路径：

{
  "action": "install_bundle",
  "target": "/absolute/path/to/ssh-plugin-dsh"
}

检查安装结果中的 application 和 warnings：applied 表示已应用，restart-required 表示需要重启对应 Harness 实例。

3. 打开 SSH 工作台

1. 点击 Harness 左侧 SSH。

2. 点击「添加服务器」，填写地址、端口、用户名和认证方式；私钥认证可点击「选择文件…」导入私钥。

3. 保存并连接，使用终端、SFTP、服务器监控和端口映射等功能。

4. 在 Harness 对话中让 Agent 使用已保存的连接执行任务。

插件启用后由 Harness 管理，无需每次手动启动后端。编辑连接时，留空已有密码可保留原值，勾选清除选项才会清空。

Agent 自动化

直接在 Harness 中描述任务，Agent 可通过连接名称或 ID 使用已保存的服务器：

> 列出 SSH 服务器，连接“测试服务器”，查看磁盘使用情况和最近的错误日志。

> 将本地配置上传到测试服务器，读取上传后的文件并核对内容。

> 在测试服务器执行一个后台任务，然后查询任务状态。

当前固定后端版本实际注册 16 个工具：

| 类别 | 工具 |

| --- | --- |

| 命令与终端 | ssh_exec、ssh_exec_sudo、ssh_multi_exec、ssh_terminal_input |

| 后台任务与连接 | ssh_run_bg、ssh_task_status、ssh_close、ssh_list_connections |

| 主机指纹 | ssh_list_known_hosts、ssh_remove_known_host |

| SFTP | sftp_list_dir、sftp_stat、sftp_upload、sftp_download、sftp_read_file、sftp_write_file |

工具数量以运行时清单为准。上游只读限制、危险命令检查、连接范围和 sudo 白名单继续生效。建议在服务器表单中保存凭据，让 Agent 引用连接，避免在对话中粘贴密码或私钥。

数据与安全