dsh-open-with：在本地编辑器中打开 DeepSeek Harness 工作区

前言¶

在 DeepSeek Harness (DSH) 中进行智能体开发时，工作区是核心载体。Web 界面虽然方便，但在需要深度编辑代码或查看本地文件结构时，往往受限于浏览器权限。dsh-open-with 插件通过宿主代理机制，将 Web 界面与本地开发环境连接起来，让你能够直接在检测到的本地编辑器中打开已注册的工作区。

是什么¶

这是一个 DSH 客户端插件，由维护者 ChuanTianML 开发。它的核心作用是从 Web GUI 中启动本地编辑器，打开当前已注册的 DeepSeek Harness 工作区目录。

核心功能¶

编辑器检测：自动检测多种本地编辑器，包括 VS Code、Cursor、Windsurf、Zed、JetBrains 系列 IDE 等。
配置化管理：支持通过配置文件添加自定义编辑器，或覆盖内置的检测规则。
动态刷新：点击“刷新编辑器”可重复执行宿主发现，更新启动器，无需重启 DSH 服务。
安全边界：浏览器只接收编辑器 ID、标签和可用性状态，命令和参数不会跨网络传输到浏览器。
兼容性适配：支持使用 sidebar.workspaces.row-menu 或兼容性适配器以适配旧版客户端。

安装与启用¶

该插件需要 DSH 0.1.0-rc.5 或更高版本。

添加插件到 Web 配置文件：

    dsh plugin --profile web add https://github.com/ChuanTianML/dsh-open-with/archive/refs/tags/v0.2.1.tar.gz

重启 DSH Web 服务器。
- Linux / macOS：使用 SIGTERM 终止进程，等待其完全退出后再刷新页面。
- Windows：使用 SIGTERM 终止进程，严禁使用 kill -9，否则可能中断 Session 的 zstd 写入。
验证安装版本：

    dsh plugin --profile web list dsh-open-with --depth 0

典型用法¶

在 DSH 的 Web 配置文件中添加插件配置。配置项分为 autoDetect（自动检测）、editors（自定义编辑器列表）和 defaultEditor（默认编辑器 ID）。

设置默认编辑器：

    - id: dsh-open-with
      name: dsh-open-with
      config:
        defaultEditor: cursor

添加自定义编辑器：

    - id: dsh-open-with
      name: dsh-open-with
      config:
        editors:
          - id: fleet
            label: Fleet
            command: fleet
            args: []

适用场景与注意¶

适用场景：需要在本地编辑器中直接调试代码、查看工作区文件结构的智能体开发场景。
权限与安全：编辑器进程在启动后会独立运行，生命周期长于 DSH Web 服务器。插件仅在本地操作，不会读取、上传或同步文件。
注意事项：
- 配置更改需要重启 DSH 服务才能生效。
- 偏好设置保存在浏览器本地状态中，不同浏览器可以有不同的默认编辑器。
- 仅能打开当前已注册且目录存在的工作区。

短结尾¶

该插件通过安全边界的设计，解决了 Web 界面与本地开发环境割裂的问题。更多细节及源码，请访问其 GitHub 仓库。