DSH Remote SSH

简体中文 | English

让 DeepSeek Harness（DSH） 使用原生工具直接操作远程 Linux 服务器。

在对话输入框旁选择一台已添加的服务器后，DSH 原有的 read / write / edit / glob / grep / bash / terminal 会切换到远端执行。插件不修改 DSH 源码，服务器也无需安装 DSH、本插件、Node.js 或 Python。

功能

• 在 DSH 页面内添加、测试、管理和选择 SSH 服务器。
• 在本地电脑与已添加的服务器之间切换执行环境。
• 保留 DSH 官方工具，不新增能力受限的 ssh_* 替代工具。
• 通过 SFTP 操作文件，通过 SSH exec / Shell 执行命令，通过 SSH PTY 提供交互终端。
• 保留官方 glob / grep，自动处理并缓存远端 Linux 所需的 ripgrep。
• 支持 SSH Agent、私钥文件和临时密码认证。
• 首次连接核对 SSH Host Key 指纹，指纹变化时拒绝连接。
• DSH Host 维护并复用服务器连接，不会为每条消息重新登录。

安装

需要 Node.js 24 或更高版本，并确保 dsh 和 pnpm 可在命令行中使用。

dsh plugin --profile web add github:NaNQiQ/deepseek-harness-remote-ssh
dsh web

如果 Windows 提示找不到 pnpm，请在 CMD 中执行 npm install -g pnpm@11，然后重新打开 CMD。

使用

1. 启动 dsh web。
2. 打开输入框旁的执行环境选择器。
3. 选择“添加服务器”。
4. 填写连接信息、认证方式和默认工作目录。
5. 按页面引导准备认证并核对服务器指纹。
6. 点击“测试并保存”。
7. 在输入框旁选择该服务器。

以后只需选择已保存的服务器。切换后模型仍然使用 DSH 官方工具，变化的只是工具背后的执行位置。

界面预览

架构

flowchart TB
    M[Model]
    T[DSH 官方工具<br/>read · write · edit · glob · grep · bash · terminal]
    I[DSH 官方执行接口<br/>ctx.fs · ctx.subprocess · ctx.shell · ctx.terminals]

    M --> T --> I

    subgraph W[Execution World]
        direction LR

        subgraph L[Local]
            LP[DSH 原生 Provider]
            LOS[本地操作系统]
            LP --> LOS
        end

        subgraph R[Remote SSH]
            RP[DSH Remote SSH Provider]
            FS[SFTP<br/>远程文件系统]
            EX[SSH exec<br/>进程 / Shell]
            PTY[SSH PTY<br/>交互终端]
            RG[官方 glob / grep 参数<br/>远端 Linux ripgrep]

            RP --> FS
            RP --> EX
            RP --> PTY
            RP --> RG
        end
    end

    I --> LP
    I --> RP

原生 DSH @ Linux
        ≈
DSH @ 本地电脑 + DSH Remote SSH → 同一台 Linux

插件只改变 DSH 在哪里执行，不改变 模型如何使用 DSH 工具。详细实现见 ARCHITECTURE.md。

认证

远端要求与安全边界

• 目标为提供 SSH / SFTP 和 POSIX Shell 的 Linux / Unix 主机。
• 每台服务器可设置默认工作目录；它是默认 cwd，不是路径沙箱。
• 实际访问能力等同于远端 SSH 账号权限。
• Remote Provider 不会向远端暴露 DSH Host 的本地文件系统。
• 模型 API Key、Base URL 等仍由 DSH 管理，本插件不读取或保存。

更多说明见 SECURITY.md。

更新与卸载

dsh plugin --profile web update dsh-remote-ssh
dsh plugin --profile web remove dsh-remote-ssh

更新或卸载后重新启动 DSH。

文档

• ARCHITECTURE.md — 架构与实现
• SECURITY.md — 安全模型与凭据处理
• CHANGELOG.md — 版本变更
• CONTRIBUTING.md — 开发与贡献

相关项目

• DeepSeek Harness

友链

License

MIT