dsh-open-in: 在 DeepSeek Harness Web 界面直接打开工作区

前言

DeepSeek Harness (DSH) 提供了基于 Web 的交互界面来管理工作区和智能体。在实际开发中,开发者经常需要从 Web 界面直接跳转到本地开发环境,比如在编辑器中打开项目目录,或在终端中进入该目录。

dsh-open-in 插件解决了这个痛点。它不需要在 DSH 端构建任何工具,而是作为一层集成,将你本地已安装的启动器(如 VS Code、Windows Terminal、文件资源管理器)通过 Web 界面调用起来。

是什么

dsh-open-in 是一个 DSH 插件,由维护者 NevermindZZT 开发。

它不提供新的智能体能力或工具,其唯一职责是:当你已经通过 DSH Web 界面打开了一个工作区时,允许你从该界面的侧边栏菜单中,直接以你配置的命令行参数启动外部程序,将当前工作区目录传递给这些程序。

核心功能

该插件具备以下能力:

  1. 可配置的目标
    你可以在设置中添加、编辑或删除目标。每个目标包含唯一标识符、显示标签、执行命令、参数列表以及运行平台限制。配置可以保存在持久化的用户设置文档中,也可以通过 cordis.yml 进行部署级别的覆盖。
  2. 菜单集成
    插件会自动向 DSH Web 界面中每一个真实的“工作区”行添加溢出菜单。菜单中会根据你配置的目标生成对应的条目(例如“Open in VS Code”、“Open in File Explorer”)。
  3. 平台自动适配
    内置的目标(如 explorer、terminal)会自动适配宿主机平台。例如,在 Windows 上可能调用 wt -d,在 macOS 上调用 open -a Terminal。你也可以手动覆盖默认行为。
  4. 宿主程序启动
    插件会在宿主机上以 detached(分离)模式启动你配置的可执行文件。它只负责发送目标 ID 和目录路径,由宿主程序决定如何处理该路径。
  5. 无需构建
    插件包含预编译的库文件,安装后无需任何构建步骤。

安装与启用

安装该插件需要 DSH 版本 0.1.2-rc.1 或更新,并且必须使用 Web Profile。

执行以下命令将插件添加到你的 Web Profile:

dsh plugin --profile web add dsh-open-in

安装完成后,刷新 Web 界面,插件会作为 dsh-open-in 挂载。你可以通过以下命令验证插件是否正确加载:

dsh --profile web --dump-config | grep dsh-open-in

典型用法

配置插件后,使用流程如下:

  1. 在 Web 界面的侧边栏找到已打开的工作区。
  2. 点击该工作区行右侧的 … 溢出菜单。
  3. 选择你配置好的目标(例如“Open in VS Code”)。
  4. 宿主程序会立即启动,并将该工作区目录作为工作目录打开。

在设置界面中配置目标:
* 进入 Settings → Plugins。
* 找到 “Open In” 卡片。
* 在卡片中添加、修改或删除目标行,点击 Save 即可生效。

适用场景与注意

  • 工具依赖:你必须在系统中安装并配置好你要调用的工具,且它们的可执行文件(如 VS Code CLI 的 code 命令、Windows Terminal 的 wt 命令)必须处于系统 PATH 中。
  • 路径限制:插件拒绝相对路径,只接受绝对路径。
  • 权限与安全:该插件只运行你明确配置好的命令。它不提供任何工具、技能或模型可见面。它仅作为宿主进程的启动器,直接响应你在 Web 界面的点击操作(无需二次审批)。
  • 配置覆盖:在设置界面中进行的修改会覆盖 cordis.yml 中的默认配置。

结语

dsh-open-in 体现了 DSH “一切皆插件”的理念。它通过极简的方式,将 Web 界面与本地开发环境无缝连接,减少了路径复制和手动打开应用的繁琐操作。

更多信息可参考 DeepSeek Harness 插件目录 或 GitHub 仓库。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜