前言¶
DeepSeek Harness 的插件化架构允许开发者扩展环境交互能力。dsh-plugin-ssh 补充了 SSH/SFTP 能力，使 Agent 能够直接在宿主环境中执行命令、传输文件，并利用宿主的 AI 模型辅助排查问题。它无需独立的 SSH 客户端，直接集成在 Harness 的工作流中。
插件定位¶
这是 DeepSeek Harness 的 SSH/SFTP 工作区插件，提供多主机终端、文件传输与 AI 命令助手。由 techflag 维护，开源协议为 MIT。
安装与启用¶
安装前需确保已安装 DeepSeek Harness Web，且版本不低于 0.1.2-rc.1。在下载目录执行以下命令安装插件：
npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add ./dsh-plugin-ssh.tgz --ignore-scripts
安装完成后刷新浏览器，在侧栏即可看到 SSH 入口，点击打开工作区。
核心功能¶
主机管理¶
支持添加、编辑和删除服务器主机。连接前需核对服务器的 SHA256 指纹以确保安全。可选择“记住密码”，密码会以 AES-256-GCM 加密存储在宿主本地；私钥和私钥口令不保存。删除主机会同时清除对应的保存密码。
SSH 终端¶
提供交互式 PTY 终端，支持多会话标签页。关闭标签页会断开对应的 SSH 连接。终端尺寸与本地同步。
SFTP 文件¶
支持浏览远程目录，利用颜色区分文件类型。支持拖放或选择多文件上传到当前远程目录。选中文件可进行 UTF-8 文本编辑或下载。
工作区布局¶
文件区与终端区默认上下排列，可通过拖动分隔线调整比例。文件预览与终端也可上下拖动。
AI 助手与传输管理¶
- AI 助手：选中终端内容可点击“用 AI 解决选中内容”进行分析。
- 传输管理：手动上传及 AI 直传均显示字节进度、百分比和速度，支持取消与清理记录。
典型用法¶
对话中调用¶
在宿主输入框输入 @服务器，从候选菜单选择目标，直接描述任务。例如：“检查 Java 环境并部署这个 jar”。提交时，任务会被序列化为模型可见的 SSH 上下文。
完整工作区¶
输入 /ssh 可打开完整的 SSH 工作区。在此界面中，文件与终端的布局更加灵活，支持拖动调整。
AI 命令操作¶
AI 在回答中生成的单行 Shell 代码块，可点击 填入终端 或 执行。执行前需确认目标主机，且终端应处于空命令提示符。多行代码仅用于阅读。
注意事项与限制¶
网络与路由¶
SSH 路由仅接受本机地址 http://127.0.0.1:<端口>。远程访问 Harness 或使用 localhost 地址暂不支持。
文件与性能¶
- 单文件下载上限 32 MB。
- 64 KB 以内的 UTF-8 文本可编辑；超过 64 KB 时只读预览；超过 512 KB 时显示文件末尾约 512 KB。
- 最多支持 12 个并发 SSH 会话。
功能边界¶
暂不支持跳板机、目录递归传输、断点续传、自动重连、终端分屏、主机分组、语法高亮。
数据安全¶
- 密码存储在本地文件系统，以当前用户权限保护，不依赖系统钥匙串。
- 删除传输记录不会删除远程文件。
- 默认命令超时 60 秒，输出上限 128 KB。
