Passer au contenu principal
F

dsh-remote

flymysql/dsh-remote

Espaces de travail distants SSH pour DSH, avec projets parallèles sur plusieurs hôtes, navigation et modification de fichiers, recherche récursive, terminaux et différences Git, ainsi que des outils Agent pour modifier, construire et tester à distance. La disposition IDE est facultative.

Installer

dsh plugin --profile web add github:flymysql/dsh-remote

README

English · 中文

dsh-remote

npm version downloads downloads license dsh-plugin

由 @flymysql 维护 · 主页 · 用量统计 · 博客 · 讨论区 · Issue · English

dsh-remote —— 远程项目,完整上下文

在 DeepSeek Harness 中,把 SSH 主机变成日常开发工作区:管理多主机项目,浏览和编辑远程文件、递归搜索文件与内容、使用终端、查看 Git 差异、建立本地/反向端口隧道;让 Agent 在所属远程工作区中读写文件、执行命令、构建和测试。多个工作区可独立并行。

可按习惯使用普通布局,或切换 IDE 三栏布局,并排查看远程文件、编辑器与原生 Agent 会话;切换时保留任务和未保存编辑。

DSH 远程工作区 IDE 模式:远程文件树、代码编辑器和原生 Agent 会话三栏

安装

dsh plugin --profile web add dsh-remote

安装或升级后,重启 DSH Web 并刷新页面。自动更新状态在设置 → 远程工作区 → 插件偏好中查看。

3 步开始

  1. 配置主机:设置 → 远程工作区,编辑 SSH 配置或保存主机凭据;打开设置会自动检查连通性,无需手动“连接”。
  2. 创建工作区:添加工作区 → 远程,选择主机与目录。每个工作区独立绑定主机,设置页不选目录或“当前远程机”。
  3. 开始开发:打开工作区文件或切换 IDE 模式,文件打开即可编辑并显示语法高亮,在远端搜索、运行命令并与 Agent 协作。
选择远程目录:固定路径与确认栏,目录列表占据弹窗主要区域

本地工作区也能用

打开普通本地项目后,点击 IDE 模式 或 工作区文件,即可使用同一套文件树、高亮编辑、递归搜索、Git 差异与本地终端。无需配置 SSH;Agent 继续使用宿主原生文件和命令工具,多个本地、远程项目可并行工作。

本地工作区:文件搜索、高亮编辑和原生 Agent 会话,Agent 已实际完成本地构建

日常开发

搜索远端文件与内容

文件、目录和内容递归搜索,无需先展开目录或同步镜像。默认界面只显示搜索范围与进度摘要;按需展开搜索选项、扫描详情,支持大小写、忽略项、停止与重试。点击结果进入目录或文件对应行。

简洁远程搜索:名称搜索结果包含嵌套目录与文件

查看远端 Git 改动

分别查看工作区和已暂存 diff,筛选文件,点击改动行定位源码。面板只读,不提交或修改暂存区。

远端 Git 工作区与已暂存改动、文件列表和源码 diff

在远端运行终端

终端进入当前会话的远程目录;像素鱼欢迎图后接真实 SSH shell。已保存凭据可自动应答,支持多终端并行。

DSH 远程终端:像素鱼欢迎图与实际 SSH 命令输出

端口转发(SSH 隧道)

谁要发起访问,就在谁那边开监听口:监听口开在本机是本地转发(ssh -L),开在远端是远程转发(ssh -R)。可同时运行多条;每行能直接勾选「自动重连」——只恢复上次运行中的转发,且按机器隔离,反向转发首次勾选会提示远端监听风险。

从旧版本升级:旧版没有 lastActive 的「自动重连」配置会暂停,行上显示「需重新确认」;重新勾选后才会参与自动恢复(反向转发需重新确认远端监听)。

端口转发面板:本地/反向方向、自动重连勾选框与添加转发表单

与 Agent 一起修改和构建

工具卡展示已应用改动、实际退出码和构建输出,编译诊断可跳转源码。编辑器保存会检测远端冲突、保留 CRLF,并保护保存期间继续输入的内容。

Agent 远程编辑成功后的已应用 diff、路径与增删行数

兼容与边界

  • 主要面向 DSH Web 0.2.x;0.2.2 需要 Node.js ≥24.9。旧版宿主回退、Desktop/TUI 与 Agent diff 差异见兼容说明。
  • 文件栏直接访问远端;镜像按需同步。草稿在当前页面内存,崩溃或强制退出仍可能丢失。
  • 不提供远端语言服务、扩展宿主或调试器。Agent 使用配置的 SSH 身份执行命令,请只配置可信主机。

文档与社区

完整工具与配置参考 · 排障 · 升级指南 · 更新记录

主页 · 讨论区 · 反馈问题 · 贡献指南 · 贡献者与致谢

由 @flymysql 与社区共同维护 · MIT

贡献者与致谢

感谢每一位让这个项目更好的朋友(头像可点进主页;按提交数排序,机器人不计):

@flymysql @baiseraku @glzhangzhi @hjwsm1989 @j10ha0 @FoolishWiser @kakaa-nju @4FMTWRV @dahaipeng @davidlin2k @FlintyLemming @GDWhisper @YiHui-Liu @Minggle @nekomona @shis23

贡献记录与早期贡献者

近期的亮点贡献(欢迎随时加入这个名单):

贡献者做了什么
@baiseraku整个 dsh-tui 适配层(#92)+ 底栏机器名修正(#98)
@hjwsm1989远程 .md 渲染连环两道:memo 守卫(#102)+ labels 契约(#107)
@shis23rw_sync 路径映射纠偏 + SFTP 超时韧性(#105)
@davidlin2k无凭据机器走用户自有 ssh(#100)
@GDWhisper目录补全逐字符重连修复(#42,issue #41)
@glzhangzhi多远端会话的连接池隔离(issue #25 的主体修复)

早期已合并 PR 的贡献者(考古名单):

@dahaipeng (#31) · @YiHui-Liu (#28) · @nekomona (#24) · @zhz1667 (#43) · FoolishWiser (#17) · @jace1cch (#16) · @Minggle (#10) · 4FMTWRV (#6) · glzhangzhi(per-session SSH 连接池修复)

名单随版本更新;头像墙之外的每一份 issue 报告、复现步骤、根因线索同样珍贵—— 本仓库近半修复的起点都是一条写清楚的 issue。

Plugins associés