前言¶
在 DeepSeek Harness(DSH)里用 Web 界面管理多个工作区时,常见做法是记下目录路径,再切到终端或文件管理器手动打开编辑器。路径一长、工作区一多,这一步很容易打断节奏。
下面介绍的 dsh-open-in-vscode 把这一步收进侧边栏:每个工作区行的 … 溢出菜单里多出一项,点一下就在本机 VS Code(或你配置的编辑器 CLI)里打开对应目录。插件由社区维护者 omdsh-dev 发布,归类为客户端插件,在 GitHub 上约 54 stars、6 forks。
这是什么¶
dsh-open-in-vscode 是 DSH 的客户端 + 宿主组合插件:Web 界面负责展示菜单项,DSH 宿主进程负责调用本机编辑器命令。
它解决的是「从 Web GUI 跳转到本地 IDE」的衔接问题,不新增工具、技能或模型可调用的设置项,也不读写工作区文件本身。
核心功能¶
侧边栏菜单入口¶
插件优先使用 DSH 提供的 sidebar.workspaces.row-menu 扩展槽;在公开版 DSH 0.1.0-rc.6 上,若原生槽位不可用,会回退到兼容适配层。两条路径渲染的菜单项一致,并跟随界面语言:
- 中文环境:在 VSCode 中打开
- 英文环境:Open in VSCode
点击后的调用链¶
用户点击菜单项后,客户端关闭菜单,通过 Typert Remote 调用 openInVscode/open,把当前工作区目录传给宿主。宿主侧以 detached 方式启动配置的编辑器 CLI(默认 code <path>),编辑器进程独立于 DSH 服务存活。
能力边界¶
| 操作 | 运行位置 | 是否需要审批 |
|---|---|---|
| 在用户点击后打开工作区目录 | 宿主(用户手势触发) | 否 |
| 其他 | — | 插件无 tools、无 settings namespace、无面向模型的接口 |
前置条件¶
- 本机安装 VS Code,或 PATH 上存在可打开目录的编辑器 CLI。Windows 下默认的
code命令会探测常见安装路径;macOS 需先安装 VS Code shell command,或在配置里改用其他可执行文件。 - DSH 版本 0.1.0-rc.6 或更新。
0.1.0-rc.6起支持原生工作区行菜单扩展点;更早版本不在插件支持范围内。
安装与启用¶
在 Web profile 中添加插件(会在 profile 内执行 pnpm 并协调 bundle 层):
dsh plugin --profile web add https://github.com/omdsh-dev/dsh-open-in-vscode/archive/refs/tags/v0.1.6.tar.gz
重启 Web 服务(向进程发送 kill -TERM <pid> 并等待退出,不要用 kill -9,以免中断会话 zstd 日志),然后刷新页面。宿主插件挂载在 dsh-open-in-vscode 下,客户端 bundle 由 /plugins/dsh-open-in-vscode/client.js 提供。
确认已安装版本:
dsh plugin --profile web list dsh-open-in-vscode --depth 0
当前发布版本为 v0.1.6,许可证 MIT。
配置¶
可在 cordis.yml 中调整以下字段:
| 键 | 默认值 | 含义 |
|---|---|---|
command |
code |
用于打开目录的可执行文件。默认在 Windows 上会探测标准 VS Code 安装位置;其他命令通过 PATH 解析。 |
args |
[] |
传入目录路径之前的额外参数。 |
若可执行文件不存在,插件会明确报错并给出修复提示;相对路径会被拒绝。
典型用法¶
经过上面的安装与重启步骤后,打开 DSH Web 界面,在侧边栏找到目标工作区,点击该行右侧 …,选择 在 VSCode 中打开(或英文界面下的 Open in VSCode)。本机应弹出 VS Code 并打开该工作区目录。
若你使用 Cursor、VSCodium 等兼容 CLI,可在 cordis.yml 里把 command 改成对应的可执行文件名,必要时通过 args 传入额外参数。
适用场景与注意¶
适合谁
- 经常在 DSH Web 界面切换工作区,又习惯在本机 IDE 里继续编辑的开发者。
- 希望减少「复制路径 → 终端
code」重复操作的团队。
使用前请留意
- 插件以当前 DSH 宿主进程的用户权限运行;安装前建议查看 GitHub 源码 与 MIT 许可证,确认行为符合你的部署策略。
- 插件只打开用户已在 DSH 中可见的工作区目录,不提供文件读写、远程执行或其他自动化能力。
- DSH 生态遵循「一切皆插件」思路;SkillHub 目录页 是社区收录站点,与 DeepSeek / 幻方无官方从属关系。
链接¶
- 目录页:https://www.skillhub.cn/plugins/omdsh-dev/dsh-open-in-vscode
- GitHub:https://github.com/omdsh-dev/dsh-open-in-vscode