前言¶
DeepSeek Harness (DSH) 采用“一切皆插件”的架构，允许开发者通过插件扩展功能。lemoncat7/dsh-ssh 是此类插件之一，旨在解决 AI 代理在远程服务器上的操作需求。它将 SSH 会话管理、SFTP/FTP 文件传输、浏览器交互终端、代理和端口转发功能集成到 DSH 工作区中，无需依赖本机的 ssh 或 sftp 命令即可完成连接。
核心能力¶
该插件提供以下核心功能：
- 认证方式：支持 SSH 密码、私钥和 SSH Agent 认证。
- 代理与跳板：支持 HTTP CONNECT、SOCKS5 和 SSH 跳板代理。
- 端口转发：支持本地转发（-L）、远程转发（-R）和动态 SOCKS5 转发（-D）。
- 交互终端：提供浏览器交互终端，支持输入、增量输出、窗口尺寸同步。
- 文件管理：支持 SFTP 和 FTP/FTPS 文件浏览、预览（文本/图片/PDF）、流式下载以及拖放上传。
- Markdown 编辑：支持 Markdown 手动/自动刷新模式下的编辑与保存。
- Agent 工具：提供
ssh_list、ssh_set_cwd、ssh_exec、ssh_terminal_open、ssh_terminal_send和ssh_terminal_read等工具接口。
安装¶
使用官方命令安装该插件：
dsh plugin --profile web add @lemoncat7/dsh-ssh@latest
安装或升级后，需重启对应的 DSH Profile。
典型用法¶
根据使用场景，该插件支持以下操作：
- 执行一次性命令：使用
ssh_exec工具在远端执行单次命令。 - 打开交互终端：使用
ssh_terminal_open打开当前 Agent 独占的 SSH 终端。 - 终端交互：使用
ssh_terminal_send向终端发送文本并等待输出稳定，或使用ssh_terminal_read分页读取终端回滚缓冲区。 - 工作目录管理：使用
ssh_set_cwd设置并验证当前会话在指定主机上的工作目录。 - Markdown 编辑：在 Markdown 手动模式下直接编辑正文并保存，或利用自动刷新模式只读查看。
- HTML 预览：在禁用脚本、导航和表单能力的沙箱中显示 HTML/HTM 静态页面。
- 文件下载：使用 SFTP 进行流式文件下载，无需暂存到 DSH 磁盘。
注意事项¶
在使用过程中，请注意以下事实与限制：
- 环境依赖：不依赖本机
ssh或sftp命令。 - 预览限制：文件预览最大 1 MB；Markdown 编辑限完整 UTF-8 文件，最大 256 KB。
- 本地目录：本地目录支持取决于运行环境（桌面端）。
- 文件保存：保存文件需服务器支持 OpenSSH 原子替换扩展。
- 沙箱显示：HTML/HTM 在禁用脚本、导航和表单能力的沙箱中显示。
- 连接安全：首次连接主机需确认指纹。
生态背景¶
DeepSeek Harness (DSH) 是一个基于插件的智能体开发环境。插件目录（如 skillhub.cn）与 DeepSeek / 幻方无官方从属关系，是社区驱动的生态补充。本插件由社区开发者 lemoncat7 维护，遵循 MIT 许可证。
