UynajGI/dsh-ssh
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、不支持掉线重连、无法终止后代进程等,使用时需要注意。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-ssh(UynajGI/dsh-ssh)
仓库:https://github.com/UynajGI/dsh-ssh
本站详情页:https://www.yhbd.top/plugins/uynajgi-dsh-ssh/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 11 · 最近提交 2026-08-16 · 主语言 TypeScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 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 | 中文
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 →
xmanrui/dsh-im
tencent-connect/dsh-qqbot
flymysql/dsh-remote
whiteguo233/dsh-openbiliclaw
omdsh-dev/dsh-lark
hanshanyike/dsh-yolo
THEWOLFWALKER/dsh-notifier