dsh-plugin-ssh

DSH SSH

DeepSeek Harness 的 SSH／SFTP 工作区插件。安装到现有 Harness，通过侧栏的 SSH 打开；顶部 DSH SSH 返回 Harness，连接保持到关闭会话、刷新页面或退出 Harness。

在 Harness 中连接服务器、管理文件，并随时让 AI 协助排查命令问题。

DSH SSH 是可安装的社区插件，无需另装独立 SSH 客户端。适合日常服务器维护、日志查看和配置修改。AI 使用宿主已配置的模型服务，模型调用费用由对应服务商计算。

当前稳定版本为 0.1.0，正在提交 DSH Market 收录。macOS 已完成实际 SSH 连接验证；Windows 已通过构建与自动测试，尚未完成 SSH 实机验收。

实际界面

文件区、终端区和 AI／传输区可以左右拖动；打开文件后，文件预览与终端也可以上下拖动。超过 64 KB 的 UTF-8 文本会以只读方式显示，超过 512 KB 时显示文件末尾约 512 KB，并保留完整文件下载入口。

更多界面和逐步操作见 中文使用教程。

对话操作服务器

在宿主输入框输入 @服务器，从 Harness 原生候选菜单选择目标，然后直接描述任务，例如“检查 Java 环境并部署这个 jar”或“分析 Nginx 启动失败并修复”。主机以行内引用显示，提交时才序列化为模型可见的 SSH 上下文。宿主 Agent 调用 dsh_ssh_hosts、dsh_ssh_exec、dsh_ssh_read、dsh_ssh_edit、dsh_ssh_upload，过程和结果显示为 Harness 原生工具卡片。输入 /ssh 可打开完整 SSH 工作区。若当前 Agent 预设限制了工具，需选择允许这些工具的预设。

命令、日志/文件内容和配置修改以对话卡片展示，命令输出支持运行时查看；执行结果返回给 Agent 继续分析。卡片的 打开 SSH / 在 SSH 中打开文件 会定位到同一主机或文件。卡片在会话历史中保留；运行时输出缓存最多保留 100 条，重启清空。

首次先在工作区核对指纹并连接。已保存密码的主机可由对话按需连接，私钥主机需保留手动连接。远程命令、读取文件及修改服从当前 Harness 会话的访问模式；宿主要求确认时，插件会补充主机信息供核对。每条命令使用独立 Shell，须指定远程目录，不继承手动终端的环境。默认命令超时 60 秒，输出上限 128 KB，超限停止且不自动重试；停止不能保证远程脱离终端的子进程已结束。

配置修改需要先读取文件，提交修改前后内容和版本，经确认后创建同目录备份、检查冲突并原子替换。修改成功不代表服务恢复，需继续运行配置检查及健康检查。备份路径会返回，当前不提供一键回滚。对话中的 JAR、压缩包等工作区文件由 dsh_ssh_upload 通过 SFTP 直传服务器，不经过公网临时文件站；工具卡片显示实时字节数、百分比和速度，并返回本地 SHA256。默认拒绝同名文件；用户明确要求替换时，先上传同目录临时文件，完整成功后再原子替换，随后仍应校验并完成健康检查。

手动操作报错后，点击 交给宿主 AI，回到对话点击 加入 SSH 报错上下文，检查内容后发送。不会覆盖已有草稿或自动发送。右侧独立 AI 面板仍可使用，其历史尚未合并到宿主会话。

快速上手

1. 安装到正在使用的 Harness profile，重启宿主，从侧栏打开 SSH。
2. 在 连接中心 → 添加主机 输入地址、端口、用户名和认证信息，核对指纹后连接。
3. 如需免重复输入，勾选 记住密码；已有主机可点 编辑 修改并保存。
4. 点 文件 打开目录面板并进入目标目录。可把一个或多个本地文件拖到工作区，也可点 上传 / 替换；拖入时会显示目标远程目录，同名文件会要求确认并采用临时文件原子替换。点文件名编辑文本，点下载箭头下载文件。
5. 选中终端内容后点击浮出的 用 AI 解决选中内容，也可按 ⌘ / Ctrl + J。选区会自动进入可检查、编辑的上下文。
6. AI 命令代码块下可点 填入终端 或 执行。执行前确认目标主机，终端应处于空命令提示符。

数据与权限

• 主机名称、地址、用户名和指纹同步到宿主 DSH_HOME/ssh-workbench/hosts.json，供对话工具与工作区共用；旧版浏览器主机配置在首次打开服务器菜单或工作区时迁移。布局偏好仍在浏览器本地。
• 勾选记住密码后，宿主以 AES-256-GCM 加密存储在 DSH_HOME/ssh-credentials。密钥文件与密文位于本机，并以当前用户文件权限保护；这不是系统钥匙串，也不抵御已取得该用户文件访问权限的程序。
• 编辑时密码留空沿用，取消勾选并保存可清除；删除主机同时清除对应密码。私钥和私钥口令不保存。
• 终端输出仅在用户选择附带上下文并发送时交给所选模型服务。报错检测在本地进行，AI 不自动运行命令。
• 删除传输记录不会删除远程文件。关闭 SSH 标签或退出宿主会断开连接。

安装

需要 Node.js 22.19+ 或 24+、pnpm、DeepSeek Harness Web。最低兼容／测试基线为官方 @deepseek-ai/dsh@0.1.2-rc.1；旧版 0.1.0-rc.7 不支持所需接口。先确认或升级 Harness，再安装插件。

如果全局安装了旧版，先运行 npm install -g @deepseek-ai/dsh@0.1.2-rc.1。可以从 GitHub Release 下载固定名称的预构建包：

curl -fL -o dsh-plugin-ssh.tgz https://github.com/techflag/dsh-plugin-ssh/releases/latest/download/dsh-plugin-ssh.tgz

在下载目录安装并启动：

npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add ./dsh-plugin-ssh.tgz --ignore-scripts
npx @deepseek-ai/dsh@0.1.2-rc.1 web

已有 dsh 命令时可直接使用 dsh plugin --profile web add ... --ignore-scripts。安装进自己的 profile 时，将 web 换成该名称，该配置必须包含 Harness Web UI。安装后刷新浏览器。

--ignore-scripts 跳过 ssh2 的可选原生加速构建，使用其 JavaScript 实现；不需要 Electron、独立客户端或编译器。首次运行 Harness 本身所需的环境按官方快速开始准备。

卸载：

dsh plugin --profile web remove dsh-plugin-ssh

使用

• 连接中心：添加主机，密码／私钥登录；先核对服务器 SHA256 指纹，再连接。保存主机信息和指纹；可选择在宿主侧加密记住密码，不保存私钥或私钥口令。
• 终端：多会话标签、交互式 PTY、终端尺寸同步。关闭标签会关闭对应 SSH 连接。
• 文件：浏览远程目录，多种颜色区分目录、配置、日志、部署包、压缩包与脚本；支持把多个文件拖入当前远程目录，也可通过文件选择器上传；同名文件确认后安全替换，并支持下载及 UTF-8 文本编辑。暂不支持拖动文件夹。
• 传输：上传进度、取消、结果；下载状态。文本保存采用版本校验和同目录临时文件替换。
• 错误提示：提交命令后，本地检测常见错误／用法提示，在终端显示「询问 AI」。点击后预填本次输出和问题，按「发送」进行模型分析；不会自动上传终端内容。检测是启发式，不代表已获取命令退出码。
• AI：读取 Harness 已配置的模型，支持流式回答和停止。终端选区会显示“用 AI 解决选中内容”，快捷键为 ⌘/Ctrl + J；发送前可检查、编辑上下文。普通问题默认不附带终端输出，AI 不自动执行命令。回答中的命令使用独立颜色与代码块展示；完整的单行 Shell 代码块支持“填入终端”及确认目标主机后“执行”。执行前应确保终端停在空命令提示符。多行代码及含占位符的示例仅供阅读。
• 模型服务：返回 Harness 的「设置 → 模型」配置供应商、地址和密钥。插件不另存模型密钥。密钥由宿主统一保存在 DSH_HOME/.credentials.yaml，重启或安装 SSH 插件不会清除；设置页显示“已配置”且输入框为空是隐藏密钥的正常状态。模型调用失败时，AI 面板会区分密钥未配置／无效、额度、限流、网络、超时和空响应。
• 快捷命令：插入当前终端，由用户按 Enter 执行。

当前边界

SSH 路由仅接受本机 http://127.0.0.1:<端口>，远程访问 Harness 或 localhost 地址暂不支持。会话保存在当前页面内，刷新会断开连接。

单文件下载上限 32 MB；64 KB 以内的 UTF-8 文本可编辑，更大的文本可只读预览，超过 512 KB 时显示末尾约 512 KB；最多 12 个并发 SSH 会话。暂不支持跳板机、目录递归传输、断点续传、自动重连、终端分屏、主机分组、语法高亮。文本替换要求服务器支持 OpenSSH 原子 rename；版本检查不等同于远端文件锁。不提供 CPU／延迟监测或可靠的命令退出码识别。

开发和构建

克隆本仓库后运行：

corepack enable
corepack yarn install --immutable
corepack yarn check
corepack yarn pack:plugin

产物在 dist/，包含 Host 模块、Harness Client 模块、静态工作区和 bundle patch。不会包含 Electron 或 Desktop 包。

实现：Host 使用 ssh2 + ws，通过 ctx.webServer 注册路由，ctx.effect 清理资源；AI 使用 ctx.llm。Client 通过 dsh.client 被发现，向 sidebar.footer.action 和 shell.overlay 添加独立条目。

官方依据：打包与安装、Client 模块、Slots。

安装冒烟测试（使用单独安装的官方 CLI，避免命中旧版全局命令）：

npm install --prefix /tmp/dsh-official --ignore-scripts @deepseek-ai/dsh@0.1.2-rc.1
node scripts/smoke-install.mjs /tmp/dsh-official/node_modules/@deepseek-ai/dsh/lib/bin.js dist/dsh-plugin-ssh.tgz

GitHub Actions 的 Plugin checks 工作流在 macOS／Windows 执行构建、类型检查和测试，并在 Linux 验证安装包。工作流通过不等同于 Windows SSH 实机验收。