dsh-remote-vs
メンテナンス: 活発xiray-xia/dsh-remote-vs
VS Codeのように、SSH先のファイル・ターミナル・GitをDSHから扱うリモート開発プラグインです。ホスト管理やリモート実行にも対応します。
$ dsh plugin add dsh-remote-vs7
スター
0
フォーク
TypeScript
言語
MIT
ライセンス
2026-10-14
作成日
2026-11-19
最終プッシュ
README
dsh-remote-vs · DSH 远程开发(VSCode 式)
中文 | English
Host 进程内的 SSH 主机管理 + helper 推送流水线 + VS Code 式远端工作台
(资源管理器 / 搜索 / 源代码管理 / 提交图与提交详情面板 / 多标签编辑器 / 悬浮编辑器 / 并排 Diff / 多终端 / 端口转发)。
主机配在 DSH 设置里(“远程主机”项);装了 dsh-better-sidebar 时另有
独立“远程工作台”tab,没装则退到原生右侧栏“远程工作台”页(同内容,引导页自助开,per-session 实例)。
编辑器还额外挂到会话视图槽,与“对话 / 轨迹”并列成一个远程编辑器标签,
这样代码区是整屏宽的;右侧栏那份是窄屏备用面。
P2 起原生工具在远端工作区里透明跑远端(见下)。
┌─ 本机 DSH Host ─────────────────────────────────┐
│ 本插件 Host 半 │ Client 半(浏览器) │
│ 主机/密钥/推送/路由 │ 设置两节 + 原生入口接管 │
│ /api/dsh-remote/* │ 工作台(右侧栏 + 会话视图)│
└──────────────────────┴──────────────────────────┘
│ ssh2(文件/进程/终端)+ helper RPC(远端 fs)
▼
┌─ 远端 Linux ─────────────────────────────────┐
│ ~/.dsh-helpers/<ver>/<arch>/dsh-ssh-helper │
│ 用户指定的远端工作目录 │
└──────────────────────────────────────────────┘
安装
dsh plugin --profile web add dsh-remote-vs
(从 npm 装,推荐;也可以直接跟仓库装:dsh plugin --profile web add github:xiray-xia/dsh-remote-vs。)
需要 DSH 0.2.2-rc.5 及以上、0.3.0 以下(engines.dsh 门到底;已按 rc.5 适配并通过类型检查与本地全量门禁)。
Host 仍是 0.2.2-rc.4 的请用插件 0.23.0;0.2.2-rc.2 / 0.2.2-rc.3 的请用插件 0.22.0;0.2.2-alpha.3 / 0.2.2-rc.1 的请用 0.20.1;0.2.2-alpha.2 一代请用 0.17.0;0.2.1-rc.2 一代请用 0.9.3。
--profile web 指明装进哪个 profile —— 本插件是 Web 插件,
要装进 Web GUI 所用的那个(web 是常见命名,以你自己的 profile 名为准);
桌面端用的是保留 profile desktop,见下面「桌面端」。
从
0.22.0(或更早)升级要注意:远端 helper 的 wire 协议由 2 升到 3(0.23.0起 helper 不再变化,0.23.0 → 0.24.0不涉及 helper 重推)。已有主机的部署记录会被识别为旧代, 首次连接该主机时自动重推新 helper(本机缓存里还留有旧版构建即可自动判定;缓存被清理过时,在设置页点一次 「推送」即可),每台主机首次会多一次约 47 MB 的上传。旧 helper 目录会保留,回滚就是推回旧版本。
这一条命令就够了,不需要放行任何构建脚本:包本身没有 prepare/postinstall,依赖树里也没有任何
带安装脚本的包(ssh2 是打进产物的,不是依赖);走仓库安装时还带着构建好的 lib/。
以前需要「在 profile 的 pnpm-workspace.yaml 里放行构建脚本后重跑」,那是 pnpm 12 对
「带安装脚本的依赖」的硬策略门(ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED / ERR_PNPM_IGNORED_BUILDS),
依赖侧无法豁免,只能从树里消掉。装完重启 dsh web,打开设置 → 远程主机开配。
桌面端(DSH Desktop)
桌面端是 Electron 壳 + 完整的 dsh Web 应用,但它跑在独立的保留 profile desktop
里(由桌面端自身管理):和 dsh web 的 web profile 不共享 node_modules、锁文件
和插件激活,需要在桌面端再装一次。$DSH_HOME 下的会话、设置、凭据和
~/.dsh/dsh-remote.json 主机配置是共享的,所以主机列表不用重配。
安装(二选一):
- 桌面端「插件」页面:完全启动桌面端一次 → 插件页输入
dsh-remote-vs(可钉版本) 安装 → 完全退出桌面端(托盘 Quit / 菜单退出;点窗口 × 只是隐藏到托盘)再重开。 - 桌面端自带的 dsh 命令:应用菜单 → Manage dsh Command… → Install,然后
完全退出桌面端,执行
dsh plugin --profile desktop add dsh-remote-vs,再重开。
注意:desktop 是桌面端独占的保留 profile,npm 全局安装的 dsh 不能管理它
(会报 profile "desktop" is managed exclusively by the Electron application),
只能走上面两条路径。桌面端的版本号等于它捆绑的 DSH 运行时版本,同样要满足
engines.dsh 要求(>=0.2.2-rc.5,关于面板可看);低于该版本时插件页会直接拒绝
安装。桌面端没有可见的 Web 端口,但本插件的 HTTP 路由与终端 socket 都经桌面端的
Host 转发(终端按 __DSH_TRANSPORT__.streamBaseUrl 解析地址),无需额外设置。
包内含预编译的 helper(
vendor/dsh-remote-helpers/,约 47 MB),所以首次安装下载量偏大 —— 它是唯一的 helper 投放渠道(官方 Release 不带 helper 可执行文件),去掉它就没法给新主机部署。
能力
远端工作台(VS Code 式 UI)
CLI・ターミナル の他のプラグイン
deepseek-harness-docker
by runzhliu
DeepSeek Harness のコミュニティ Docker/K8s パッケージ:Compose、Helm、Web UI、ヘッドレス CLI
deepseek-harness-android
by dphmoblie
Capacitor Android:本機 DSH Ubuntu ユーザースペース管理
dsh-subagent-codex
by mjylfz
ローカルのOpenAI Codex CLIにタスクを委譲するsubagent_codexツールを追加。作業は分離された外部プロセス上で実行されます。
mnemon
by mnemon-dev
LLM が監督する AI エージェント向け永続メモリ。グラフベースの想起、セッション横断の知識、単一バイナリで動作し、DeepSeek Harness、Claude Code、OpenClaw などに対応
