UynajGI/dsh-ssh 预览 preview

UynajGI/dsh-ssh

Plugin插件 Native原生 ⭐ 11 MIT Notifications & Remote通知与远程

DeepSeek Harness的SSH远程执行插件:支持ProxyJump链、SFTP文件系统、通过ssh2的子进程和PTY

Project Overview项目介绍

This is a native SSH remote-development plugin built exclusively for DeepSeek Harness, published on npm under the MIT license. It is built on top of the ssh2 library, and enables moving Bash execution, file manipulation, PTY terminals, and LSP functionality to a remote host over a single SSH connection. It supports multi-hop ProxyJump chains, full SFTP upload and download, and all common authentication methods, and does not require DeepSeek Harness to be installed on the remote target host. You can install it easily via the npm command npm i dsh-ssh.

The plugin implements remote providers for DSH’s ctx.subprocess and ctx.fs capability seams, so any tool built on those two seams works remotely without any code changes. It follows an architecture of “local brain, remote hands”: orchestration, memory, and LLM API calls all run on your local machine, while all commands and file operations execute remotely. It also adds a custom UI flow for adding remote workspaces in DSH’s web GUI, with a connection sidebar and directory browser similar to VS Code’s Remote Explorer. It lets users browse saved connections, ~/.ssh/config hosts, and both local and remote directories directly.

The plugin requires Node.js version 22 or higher to run, and users need to add a one-line configuration entry to their cordis.yml to mount all functionality at once, or split it into three separate entries for advanced deployments. It has several known limitations inherited from the SSH protocol, including inability to expose remote process IDs, no tree-scoped process termination, and no support for automatic reconnection after a dropped connection. All connection, authentication, and operation errors are surfaced with clear human-readable messages, and plugin teardown properly cleans up all active processes, open connections, and temporary files. It is released under the open source MIT license with no cost to use.

这是DeepSeek Harness生态下的原生SSH远程开发插件,基于ssh2库构建,可通过单条SSH连接将Bash命令执行、文件操作、PTY终端、LSP等能力迁移到远程主机。它支持多跳ProxyJump跳转链路、SFTP上传下载,覆盖多种身份认证方式,且不需要在目标远程主机安装DeepSeek Harness本身。

该插件替换了DeepSeek Harness的ctx.subprocess(远程进程)和ctx.fs(远程文件)两个核心能力接口,所有基于这两个接口开发的工具都可以零修改切换到远程主机运行,实现“本地LLM推理编排,远程命令执行文件操作”的开发模式。它还支持网页端图形界面添加远程工作区,适合需要在远程服务器完成开发任务的用户。

该插件采用MIT许可开源,依赖Node.js 22及以上版本,可通过npm安装,需要用户在cordis.yml配置中填写目标主机地址、用户名、认证信息等必要参数。它存在一些已知限制,比如无法获取远程进程ID、不支持掉线重连、无法终止后代进程等,使用时需要注意。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 11 stars - an early-stage project星标 11,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:UynajGI/dsh-ssh

把 UynajGI/dsh-ssh 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-ssh

English | 中文

npm version license node version CI status GitHub stars dsh-plugin

SSH remote-execution plugin for DeepSeek Harness. Moves Bash, file tools, PTY terminals, and LSP onto a remote host over a single SSH connection — with multi-hop ProxyJump chains, SFTP upload/download, and full auth coverage. Built on ssh2.

First (and as of 2026-08, only) SSH remote-development plugin in the dsh-plugin ecosystem. Verified end-to-end against a real two-hop jump environment with key auth.

Architecture: local brain, remote hands

Your machine (deepseek-harness)                      Remote host
┌────────────────────────────────────┐    SSH    ┌──────────────────────┐
│ agent loop (orchestration, memory) │◄──────────►│ bash / command exec  │
│ LLM API calls (direct, no egress)  │   exec    │ filesystem (SFTP)    │
│ credentials / config / sessions    │   pty     │ PTY terminals        │
│ ctx.subprocess → dsh-ssh           │   sftp    │ LSP / git / builds   │
│ ctx.fs → dsh-ssh                   │           │                      │
└────────────────────────────────────┘           └──────────────────────┘

The harness does not need to be installed remotely. dsh-ssh implements remote providers for two of the harness's capability seams — ctx.subprocess (remote processes) and ctx.fs (remote files). Every tool built on those seams (bash, file tools, terminals, LSP, subagent processes) switches to the remote host with zero changes: the model thinks locally, commands run remotely, results stream back into the local model context.

Install

npm i dsh-ssh

Quick start (cordis.yml)

One row mounts everything — the shared connection owner plus both remote providers:

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-a2a 下一个 Next minta →