跳到主内容

dsh-open-in-vscode 使用指南

在 DSH Web 界面的工作区右侧菜单加一行「在 VSCode 中打开」,点一下就用本机 VS Code 打开该工作区目录,省去手动找路径。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-open-in-vscode

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:omdsh-dev/dsh-open-in-vscode

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 客户端优先使用 harness 的 sidebar.workspaces.row-menu 插槽;公开发布的
  • 点击该行会关闭菜单,并通过严格的 Typert Remote openInVscode/open 把工作区目录交给主机。
  • 主机侧用配置的编辑器 CLI 打开该目录(默认 code <path>),进程分离,
  • 已安装 VS Code,或 PATH 中存在编辑器 CLI。Windows 使用默认 code 时还会
  • DSH 0.1.0-rc.6 或更高版本。存在 Workspace 行菜单扩展点时使用原生插槽,

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后菜单里没有出现「在 VSCode 中打开」怎么办?

装完插件需要重启 Web 服务端并刷新页面,菜单行才会出现。README 明确要求用 kill -TERM 优雅退出后再启动,不要用 kill -9。

点击后没反应,怎么排查?

失败信息只打印在浏览器控制台,界面上不会弹提示。打开浏览器开发者工具查看以 [dsh-open-in-vscode] 开头的报错,最常见的是 code 命令不在 PATH 上。

macOS 上提示找不到 code 命令怎么解决?

需要先在 VS Code 里安装命令行工具(Shell Command: Install 'code' command in PATH),或者把插件的 command 改成其他能打开目录的编辑器命令。

可以用其他编辑器代替 VS Code 吗?

可以。把配置里的 command 换成任意能接收目录参数的编辑器可执行文件即可,还能用 args 追加参数。注意只有默认的 code 命令在 Windows 上会自动探测安装目录。

编辑器会在我的电脑上打开还是在服务器上打开?

在运行 DSH 服务端的那台机器上打开。如果你是通过浏览器远程访问别的机器上的 DSH,编辑器窗口会出现在那台服务器上,不会出现在你本地。

这个插件会读写我的文件或者被模型调用吗?

不会。它只在你手动点击菜单时启动编辑器进程,本身不读写文件,也没有注册任何工具或技能,模型看不到、也调用不了它。

关闭 DSH 服务后编辑器会跟着退出吗?

不会。编辑器是以分离进程方式启动的,启动后与 DSH 服务端脱离父子关系,服务端退出不影响已打开的编辑器窗口。

为什么某些工作区行没有这一菜单项?

只有带有真实目录路径的工作区才会渲染该菜单行;没有目录信息的行会被跳过,不显示这一项。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: dsh.plugin.json 声明 >=0.0.1;README 要求 0.1.0-rc.6 及以上
  • Node: ^22.19 || >=24

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则