@zhangfengshun/dsh-remote-ssh

English | 中文

类 VSCode Remote-SSH 的 DSH 插件：通过 SSH 连接远程超算 / 服务器，在 DSH 内置「文件」「终端」页签中直接操作远程文件和终端。

功能

能力	说明
🔌 SSH 连接	密钥 / 密码认证，ProxyJump 跳板机，~/.ssh/config 一键导入
📂 远程文件	内置「文件」页签直接 SSH 读写远程文件，无需同步
💻 远程终端	内置「终端」页签自动检测远程工作区，SSH 交互式终端
🌐 远程工作区	选择远程目录创建原生工作区，一键进入远程环境
🤖 模型工具	12 个 remote_ssh_* 工具，会话感知免填连接参数

安装

dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.1.0

安装后需重启 DSH。@zhangfengshun/dsh-remote-ssh 必须在 bundles 列表中排在 dsh-better-sidebar 之后。

使用

1. 设置 → 🖥️ 远程连接 → 添加连接（主机/端口/用户/密钥）→ 点「测试连接」验证
2. 添加工作区 → 选「选择远程目录…」→ 选连接 → 浏览并选择远程目录
3. 打开内置「文件」页签 → 直接显示远程文件，编辑保存直接写回远程
4. 打开内置「终端」页签 → 自动 SSH 到远程主机（仅密钥认证）

模型工具

工具	用途
remote_ssh_profiles	列出连接配置 + 当前会话远程工作区上下文
remote_ssh_exec	执行远程命令
remote_ssh_ls	列举远程目录
remote_ssh_cat	读取远程文件
remote_ssh_write	写入远程文件
remote_ssh_grep	搜索远程文件内容
remote_ssh_glob	查找远程文件
remote_ssh_mkdir	创建远程目录
remote_ssh_delete	删除远程文件/目录
remote_ssh_move	移动/重命名
remote_ssh_sync	远端同步到本地镜像
remote_ssh_push	本地镜像推送回远端

远程工作区会话中调用工具可免填 profileId 等连接参数。

原理

插件注册 4 个 exact 路由（/sidebar/api/fs.tree、fs.read、fs.write、fs.search），在 better-sidebar 的 prefix 路由之前拦截。会话 cwd 含 .remote-ssh.json 时走 SSH，否则走本地 fs。客户端看到的是本地镜像路径，Host 自动转换为远程路径——对客户端完全透明。

Shell wrapper（~/.dsh/remote-ssh/dsh-remote-shell[.cmd]）检测工作区 .remote-ssh.json，自动 ssh -tt 连接远程，使内置「终端」页签透明接入。

❤️ 七夕快乐

本项目是送给 zhangyi 的七夕礼物。

愿它像连接起一台台远方的超算一样，也把我们紧紧连在一起。七夕快乐 ❤️

—— 2026 年 8 月 18 日

许可证

MIT