DeepSeek Harness (DSH) 旨在通过插件系统扩展能力。在运维场景中,智能体或开发者往往需要在对话中直接操作服务器,而不仅仅是处理文本。dsh-withSsh 插件将 AI 协作、真实的 SSH 终端操作记录和操作痕迹整合在同一页面,提供一种可视化的控制台。
这是一个由 lhwu1 维护的客户端插件,采用 MIT 许可证。它不是独立的 SSH 客户端,而是作为 DeepSeek Harness 的插件存在,用于在对话中连接服务器,让人工和 AI 共享终端进行操作和复盘。
核心功能¶
该插件主要提供以下能力:
- 服务器状态监控:提供 CPU、负载、内存、交换区等关键指标的查看入口。
- 日志排查与服务检查:支持在终端直接输入命令,也支持让 AI 执行命令并返回结果。
- 算力与进程检查:用于确认 GPU 或 NPU 占用情况。
- 目录浏览:提供只读的文件树视图,显示目录和文件元数据。
- 人机协同:人工和 AI 可以在同一对话中执行命令,且操作来源在终端中有明确区分。
安装与启用¶
安装插件需要已安装 DeepSeek Harness 并能在命令行使用 dsh。通过以下命令将插件添加到 Harness 的 web 配置档:
dsh plugin --profile web add github:lhwu1/dsh-withSsh
安装完成后,需要检查配置是否加载。确认输出中包含 dsh-withssh 和 dsh-withssh-web。随后启动 Web 表层:
dsh --profile web --port 3080
在浏览器访问对应地址,在对话中选择 SSH 控制台 标签页即可使用。
典型用法¶
- 建立连接:在对话的 SSH 控制台输入主机、端口、账号和密码建立连接。插件会返回 SHA-256 主机密钥指纹,必须由用户手动核对确认。
- 人工操作:连接成功后,在右上角的终端直接输入命令(如
top、systemctl),查看服务状态或日志。 - AI 协作:在对话中告知 AI 需要检查服务。AI 会通过
ssh_exec执行命令。终端中 AI 的命令会显示为黄色,点击?可查看中文说明。 - 结果交互:终端显示远端回显,AI 对话中也会收到标准输出、错误输出和退出码。用户根据真实日志决定下一步。
适用场景与注意事项¶
- 适用人群:运维人员、SRE、平台工程师以及需要与 AI 协作进行服务器巡检和故障排查的开发者。
- 安全与限制:
- 密码仅短暂经过连接请求和插件进程内存,不会写入持久化文件。
- 首次连接必须手动确认主机密钥指纹。
- 远端输出限制为 256 KiB,且移除了 ANSI/OSC 控制序列。
- 文件浏览器为只读模式,不支持上传或删除。
- 高风险操作(如递归删除)会请求 Harness 审批。
- 插件依赖 Harness Web 表层的同源访问模型,重启 Harness 会清理内存中的 SSH 连接。
该插件通过整合 AI 对话与真实终端,解决了在单一界面中完成服务器操作与复盘的需求。更多细节可查阅 插件目录 或 源码仓库。