dsh-remote

English · 中文

dsh-remote

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

在 DeepSeek Harness 中，把 SSH 主机变成日常开发工作区：浏览远程文件、编辑代码、运行终端，让 Agent 在同一远端完成任务。多个工作区可并行连接不同主机。

IDE 模式：左侧文件，中间编辑器，右侧原生 Agent 会话。 可调整栏宽；窄屏切换文件、编辑器与会话。切回普通布局保留任务和未保存编辑。

安装

dsh plugin --profile web add dsh-remote

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

3 步开始

1. 配置主机：设置 → 远程工作区，编辑 SSH 配置或保存主机凭据；打开设置会自动检查连通性，无需手动“连接”。
2. 创建工作区：添加工作区 → 远程，选择主机与目录。每个工作区独立绑定主机，设置页不选目录或“当前远程机”。
3. 开始开发：打开工作区文件或切换 IDE 模式，在远端编辑、搜索、运行命令并与 Agent 协作。

日常开发

搜索远端文件与内容

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

查看远端 Git 改动

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

在远端运行终端

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

与 Agent 一起修改和构建

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

兼容与边界

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

文档与社区

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

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

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

贡献者与致谢

感谢每一位让这个项目更好的朋友（头像可点进主页；按提交数排序，机器人不计）：

贡献记录与早期贡献者

近期的亮点贡献（欢迎随时加入这个名单）：

贡献者	做了什么
@baiseraku	整个 dsh-tui 适配层（#92）+ 底栏机器名修正（#98）
@hjwsm1989	远程 .md 渲染连环两道：memo 守卫（#102）+ labels 契约（#107）
@shis23	rw_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。