@zhangfengshun/dsh-remote-ssh

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

功能

能力	说明
🔌 SSH 连接	密钥 / 密码认证，ProxyJump 跳板机，`~/.ssh/config` 一键导入
📂 远程文件	内置「文件」页签直接 SSH 读写远程文件，无需同步
💻 远程终端	内置「终端」页签自动检测远程工作区，SSH 交互式终端
🌐 远程工作区	选择远程目录创建原生工作区，一键进入远程环境
🤖 模型工具	12 个 `remote_ssh_*` 工具，会话感知免填连接参数
⚡ 打开提速	单往返合并读 + raw 文本快路径 + 结果缓存（LRU + 5s TTL）：首开 ≈1.31×，TTL 内重复打开 0 往返，过期复验 ≈5×（真实超算实测）；`remote_ssh_exec` 连接复用 ≈15×

截图

设置 → 🖥️ 远程连接：连接配置（密钥 / 密码 / ProxyJump 跳板机）· 连接测试 · 从 ~/.ssh/config 一键导入

设置：远程连接

内置「文件」页签：直接浏览远程主机文件（右侧文件树即远程目录，编辑保存直写远程）

内置文件页签直接浏览远程文件

内置「终端」页签：自动 SSH 到远程超算（图为 SLURM 作业调度环境）；左侧会话即模型免填调用 remote_ssh_* 工具

内置终端页签自动 SSH 远程超算

安装

▼
bash
复制代码
dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.3.5

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

内置「文件」页签的 SSH 直读依赖 dsh-better-sidebar ≥ 0.15 的文件 API（/sidebar/api/fs.* 端点），请勿使用更早版本；当前已逐点验证至 dsh-better-sidebar 0.18.0。

使用

设置 → 🖥️ 远程连接 → 添加连接（主机/端口/用户/密钥）→ 点「测试连接」验证
添加工作区 → 选「选择远程目录…」→ 选连接 → 浏览并选择远程目录
打开内置「文件」页签 → 直接显示远程文件，编辑保存直接写回远程
打开内置「终端」页签 → 自动 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 等连接参数；全部文件/命令类工具走持久 SSH 会话池 + 结果缓存，remote_ssh_exec 单命令实测 ≈15× 提速。

原理

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

远程读取采用单往返合并读：一条池化命令同时返回 size/mtime 帧与文件内容（文本类扩展名优先 raw 直传，字节长 + U+FFFD 双校验失败自动回退 base64，结果逐字节一致）；配合主机侧结果缓存与变更失效（见下节）。

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

缓存与一致性

远程读取与目录列举结果在主机侧缓存（读 LRU 32 条 + 列举 LRU 64 条，TTL 5 秒；单条 >1MiB 不缓存、总量 32MB 字节预算，防止大文件驻留拖慢宿主）：TTL 内重复打开或切回页签 0 网络往返；过期后先做一次轻量 mtime+size 复验，未变化则免重传。写、删除、移动、建目录、上传、推送（push）、成功的远端 exec 与变更类 git 子命令（add/reset/commit/checkout/revert/cherry-pick）会自动失效相关缓存，并以每 profile 缓存代（epoch）兜底「同秒同 size 写」等粒度盲区。

已知限制：

集成终端（ssh -tt）与远端其它进程改动的文件依赖 TTL + 复验兜底，最多 5 秒陈旧；
/sidebar/file 下载池化路径有效上限约 6.29MB，更大文件自动退回一次性连接下载（可成功，多一次重连开销）；
二进制内容伪装成文本扩展名时会多一次 base64 回退往返（结果正确）。

❤️ 七夕快乐

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

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

—— 2026 年 8 月 18 日

许可证

MIT

@zhangfengshun/dsh-remote-ssh

English | 中文

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

功能

能力	说明
🔌 SSH 连接	密钥 / 密码认证，ProxyJump 跳板机，`~/.ssh/config` 一键导入
📂 远程文件	内置「文件」页签直接 SSH 读写远程文件，无需同步
💻 远程终端	内置「终端」页签自动检测远程工作区，SSH 交互式终端
🌐 远程工作区	选择远程目录创建原生工作区，一键进入远程环境
🤖 模型工具	12 个 `remote_ssh_*` 工具，会话感知免填连接参数
⚡ 打开提速	单往返合并读 + raw 文本快路径 + 结果缓存（LRU + 5s TTL）：首开 ≈1.31×，TTL 内重复打开 0 往返，过期复验 ≈5×（真实超算实测）；`remote_ssh_exec` 连接复用 ≈15×

截图

设置 → 🖥️ 远程连接：连接配置（密钥 / 密码 / ProxyJump 跳板机）· 连接测试 · 从 ~/.ssh/config 一键导入

设置：远程连接

内置「文件」页签：直接浏览远程主机文件（右侧文件树即远程目录，编辑保存直写远程）

内置文件页签直接浏览远程文件

内置「终端」页签：自动 SSH 到远程超算（图为 SLURM 作业调度环境）；左侧会话即模型免填调用 remote_ssh_* 工具

内置终端页签自动 SSH 远程超算

安装

▼
bash
复制代码
dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.3.5

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

内置「文件」页签的 SSH 直读依赖 dsh-better-sidebar ≥ 0.15 的文件 API（/sidebar/api/fs.* 端点），请勿使用更早版本；当前已逐点验证至 dsh-better-sidebar 0.18.0。

使用

设置 → 🖥️ 远程连接 → 添加连接（主机/端口/用户/密钥）→ 点「测试连接」验证
添加工作区 → 选「选择远程目录…」→ 选连接 → 浏览并选择远程目录
打开内置「文件」页签 → 直接显示远程文件，编辑保存直接写回远程
打开内置「终端」页签 → 自动 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 等连接参数；全部文件/命令类工具走持久 SSH 会话池 + 结果缓存，remote_ssh_exec 单命令实测 ≈15× 提速。

原理

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

缓存与一致性

已知限制：

集成终端（ssh -tt）与远端其它进程改动的文件依赖 TTL + 复验兜底，最多 5 秒陈旧；
/sidebar/file 下载池化路径有效上限约 6.29MB，更大文件自动退回一次性连接下载（可成功，多一次重连开销）；
二进制内容伪装成文本扩展名时会多一次 base64 回退往返（结果正确）。

❤️ 七夕快乐

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

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

—— 2026 年 8 月 18 日

许可证

MIT