在 DeepSeek Harness (dsh) 的生态中,智能体对远程主机的操作是一个常见需求。传统方式往往需要在目标机器上部署额外的 Agent 组件,增加了维护成本。dsh-tool-ssh 插件通过调用本地 OpenSSH 客户端,解决了这一问题,允许 dsh Agent 在不安装目标端 Agent 的情况下执行命令或传输文件。
插件定位¶
dsh-tool-ssh 是一个针对 DeepSeek Harness (dsh) 的 SSH 工具插件,由开发者 hcyinnn 维护,属于联网工具类别。它通过 OpenSSH 协议实现远程交互,核心价值在于零 Agent 部署——只要目标机器支持 SSH 登录,即可进行操作。该插件采用 MIT 许可证。
核心功能¶
该插件提供三个主要能力:
ssh_run:在远程主机上执行一条 shell 命令,返回标准输出、标准错误和退出码。ssh_upload:使用scp将本地文件或目录上传到远程主机。ssh_download:使用scp将远程文件或目录下载到本地。
安装¶
安装前需确保本地已安装 DeepSeek Harness (dsh) 以及 OpenSSH 客户端(macOS / Linux 自带,Windows 可使用 OpenSSH for Windows 或 Git Bash)。
使用官方安装命令:
dsh plugin add github:<你的用户名>/dsh-tool-ssh
典型用法¶
Agent 可以通过自然语言直接触发以下操作:
- 在生产服务器
10.0.0.5上执行systemctl status nginx。 - 将本地的
dist/目录上传到10.0.0.5:/var/www/app。 - 从远程主机
web-1下载/var/log/app.log到本地。
适用场景与注意事项¶
该插件适合需要在远程服务器上进行运维操作、文件传输的场景。使用时需注意以下几点:
- 目标机器要求:目标机器无需安装 Agent 组件,只要能用
ssh登录即可。 - 安全与认证:默认启用
BatchMode=yes,避免交互式提示。建议使用密钥认证,不要在配置中写死密码。 - 输出限制:为防止内存溢出,输出流设置了上限(默认 2 MiB),超出部分会返回
truncated标记。 - 权限风险:插件以当前 dsh 进程的权限运行,安装前应检查源码与许可证。
总结¶
dsh-tool-ssh 通过标准 SSH 协议为 DeepSeek Harness 提供了远程操作能力,简化了运维流程。更多详情可查阅 GitHub 仓库 或 社区目录。