前言¶
做智能体或日常运维时，常见做法是：终端在一个窗口、传文件用 SFTP 客户端、看指标再开监控面板，对话里的 Agent 还要单独配 SSH 密钥或临时粘贴命令。上下文在工具之间切换，连接信息也不一定能被 Agent 安全复用。
DeepSeek Harness（DSH）把能力拆成插件。下面介绍社区维护的 foryourever/ssh-plugin-dsh：在 Harness 侧栏打开 SSH 工作台，把交互终端、SFTP、服务器监控和 Agent 工具放在同一界面，并复用已保存的连接。
这是什么¶
foryourever/ssh-plugin-dsh 是面向 DeepSeek Harness 的客户端类插件，维护者为 foryourever。简介为：SSH terminal, SFTP and server monitoring plugin for DeepSeek Harness（SSH 终端、文件传输与服务器监控）。
项目基于 jinpy666/dbx-plugin-ssh 适配，复用其 Rust 后端与 Vue 终端工作台，接入 Harness 侧栏、连接管理与 Agent 工具服务。当前 package 版本为 1.0.8，许可为 MIT；上游后端锁定 0.7.13-beta.1。插件目录页：skillhub.cn/plugins/foryourever/ssh-plugin-dsh，源码：github.com/foryourever/ssh-plugin-dsh。
核心功能¶
README 中归纳的能力如下，安装前可按需对照 验证记录 了解尚未验收的上游能力（如 Telnet、串口、VNC、实验性 RDP 等）。
终端工作台：PTY 交互终端、窗口调整、批量输入、快速命令、终端录制与远程目录跟随。
SFTP：浏览、排序、预览、上传下载、重命名与目录管理；传输进度与取消；文件选择器与拖放上传。系统剪贴板文件粘贴取决于宿主是否提供原生 paste 文件事件。
服务器监控：CPU、内存、磁盘、网络趋势，以及进程、磁盘和容器相关面板。
连接与认证：密码、私钥、SSH Agent 与自动认证；最多三跳 ProxyJump、连接保活、Known Hosts 校验；只读模式、sudo 配置、命令白名单与操作审计等沿用上游能力。创建连接的表单与说明已中文化，私钥可通过「选择文件…」导入；界面跟随 Harness 亮暗主题。
多会话：可同时连接不同服务器，或对同一服务器「新建会话」；标签切换保留各自终端与文件面板；关闭标签或「断开连接」只结束当前会话。返回列表或切换侧栏会保留会话；刷新页面或退出 Harness 会结束当前客户端会话。
Agent：与界面共享已保存连接；固定后端版本注册 16 个 SSH/SFTP 工具（数量以运行时清单为准），并支持在可见终端中执行 AI/MCP 命令以便观察过程。
| 类别 | 工具 |
|---|---|
| 命令与终端 | 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 |
安装与启用¶
前提：本机已安装 DeepSeek Harness。仓库自带构建好的客户端与 macOS ARM64 后端；其他平台需 Node.js 22+ 与 Python 3，在插件目录执行 npm run setup:backend，脚本会按平台下载锁定版本官方后端并校验 SHA-256。发布资产覆盖 macOS ARM64/x64、Linux x64/ARM64、Windows x64；README 写明当前运行验收环境为 macOS ARM64。
安装步骤以仓库 README 为准：先取得插件的本地目录并完成上述后端准备，再在可调用 plugin_manager 的 Harness 会话中安装本地 bundle。将 target 换成本地目录的绝对路径：
{
"action": "install_bundle",
"target": "/absolute/path/to/ssh-plugin-dsh"
}
也可在对话中让 Agent 执行同等操作，例如说明：使用 plugin_manager 安装本地 bundle，目录是 /absolute/path/to/ssh-plugin-dsh。
检查安装结果里的 application 与 warnings：applied 表示已应用，restart-required 表示需要重启对应 Harness 实例。
打开工作台：
- 点击 Harness 左侧 SSH。
- 点击「添加服务器」，填写地址、端口、用户名与认证方式；私钥可「选择文件…」导入。
- 保存并连接，使用终端、SFTP、监控与端口映射等。
- 在对话中让 Agent 引用已保存连接执行任务。
插件启用后由 Harness 管理后端，无需每次手动启动。编辑连接时，留空已有密码可保留原值，勾选清除选项才会清空。
侧栏没有 SSH 入口时（README 常见问题）：在 DeepSeek Harness Desktop 0.2.1-rc.5 中，新插件可能已在后端运行，但前端仍用启动时的清单。需 ⌘Q 完整退出 Harness 再打开；仅关窗口或刷新页面可能无法更新清单。
本地目录更新插件时：在仓库中同步最新代码后，按安装结果处理重新加载或重启；已打开页面需刷新才能用新客户端，刷新会结束当前连接。
典型用法¶
界面运维：日常巡检与排障用终端、命令历史、快速命令与指标/进程查看；改配置或传包用 SFTP；内网访问可配置 ProxyJump 与保活。
Agent 对话示例（README 原文风格，连接名需换成你保存的名称）：
列出 SSH 服务器，连接“测试服务器”，查看磁盘使用情况和最近的错误日志。
将本地配置上传到测试服务器，读取上传后的文件并核对内容。
在测试服务器执行一个后台任务，然后查询任务状态。
建议在服务器表单中保存凭据，让 Agent 通过连接名称或 ID 引用，避免在对话中粘贴密码或私钥。上游只读限制、危险命令检查、连接范围与 sudo 白名单继续生效。
数据、安全与适用注意¶
连接数据默认在 ~/.dsh-ssh/default；不同 DSH_PROFILE 使用不同子目录，也可通过 DSH_SSH_DATA_DIR 或插件 dataDir 指定。内容以 AES-256-GCM 加密存于本机数据目录，密钥与密文应一并备份；这不能隔离同一系统账户下的其他进程。插件不自动导入既有 DBX 应用中的连接。取消、超时或删除服务器可能重启整个后端并关闭其他活动会话；已被远端接受的命令可能仍在运行。细节见仓库 ADAPTATION.md。
适合谁：需要在 Harness 内完成 SSH/SFTP 运维，并希望 Agent 与人工共用同一套连接与审计策略的开发者或运维人员。
使用前请知悉：
- 插件在当前 DSH 进程权限下运行；安装前应自行审阅源码与 MIT 许可及 NOTICE 中的第三方归属。
- 浏览器宿主下的上传/下载与私钥导入行为与 DBX 原生桌面不同，不能假定任意本机路径或流式落盘能力（README「常见问题」有说明）。
- SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；本插件为社区适配项目，不代表上游作者或 DeepSeek 官方发布。
结尾¶
经过上面的步骤，你可以在 Harness 侧栏集中使用 SSH 终端、SFTP 与监控，并让 Agent 通过 16 个工具复用已保存连接做自动化。进一步了解安装细节、Agent 工具与开发构建，见 GitHub 仓库 README 与 docs/ADAPTATION.md。
- 目录页：https://www.skillhub.cn/plugins/foryourever/ssh-plugin-dsh
- GitHub：https://github.com/foryourever/ssh-plugin-dsh
