ChuanTianML/dsh-open-with

从 DeepSeek Harness Web 界面用本机编辑器打开当前已经登记的 Workspace。Session 页头中的紧凑分段按钮可以直接启动首选编辑器，也可以打开完整的编辑器选择菜单；兼容客户端仍然保留 Workspace … 菜单入口。

English | 中文

演示

上面的录制展示了为兼容性保留的 Workspace 菜单入口。从 0.2.0 开始，同一个选择器也可以直接从当前 Session 页头使用。

功能

• Session 页头通过 Host 投影的 Workspace sessionIds 映射当前会话，不会根据浏览器路径猜测 Workspace。
• Host 会检测 VS Code 系列、Cursor、Windsurf、Zed、Trae、VSCodium、常见 JetBrains IDE、Android Studio、Sublime Text、系统终端和文件管理器；管理员配置可以新增启动目标，也可以覆盖内置项。
• 主操作使用 Host 默认值或当前浏览器记住的编辑器打开 Workspace。点击右侧箭头可以选择其他编辑器；选中的编辑器会启动并成为当前浏览器的首选项。
• 选择“重新检测编辑器”会重新执行 Host 检测，并原子更新所有已经挂载的页头和 Workspace 菜单入口，不需要重启 DSH。
• 配置过但找不到的编辑器会保留为禁用菜单项，并显示修复提示；未安装的自动检测候选不会占用菜单。
• 客户端在 Host 声明 sidebar.workspaces.row-menu 时使用原生插槽；客户端尚未提供该插槽时，使用受限兼容适配器。
• 编辑器进程启动后与 DSH Web 服务器分离，可以独立存活。Windows 启动会保留应用的首个可见窗口；子进程不会继承 Host 的 API key、token、密码及其他凭据环境变量。

自动检测目标

平台	自动检测的目标
macOS	VS Code、VS Code Insiders、Cursor、Windsurf、Zed、Trae、VSCodium、IntelliJ IDEA、WebStorm、PyCharm、GoLand、CLion、Rider、PhpStorm、RubyMine、DataGrip、RustRover、Android Studio、Sublime Text、终端、Finder
Windows	同一组编辑器应用，以及 Windows Terminal、文件资源管理器
Linux	同一组编辑器应用，以及 x-terminal-emulator、xdg-open

所有平台都会查询 PATH；macOS 和 Windows 还会检查各内置配置中列出的标准应用目录。Windows 还会查询系统 App Paths 注册项和限定范围内的 JetBrains Toolbox apps 目录。Host 插件加载时以及用户选择“重新检测编辑器”时都会执行检测。修改插件配置仍然需要重启 DSH。

前置条件

• 至少存在一个可用的内置编辑器或已配置的编辑器可执行文件。
• DSH 0.1.0-rc.5 或更高版本。较新的运行时可以提供原生 Workspace 行菜单插槽；较早的兼容客户端使用受限适配器。

安装

把插件加入 Web profile：

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

使用 SIGTERM 重启 Web 服务器，等待它退出后刷新页面。切勿使用 kill -9，否则可能中断 Session zstd 写入。使用以下命令确认安装版本：

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

配置

所有部署选项都是经过校验的 Cordis 配置字段：

键	默认值	含义
autoDetect	true	加入当前平台上可用的内置编辑器。
editors	[]	新增或覆盖内置项的白名单 { id, label, command, args } 编辑器配置。
defaultEditor	vscode	当前浏览器尚未保存选择时使用的首选编辑器 id。

示例：

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

编辑器 id 只能包含小写字母、数字、点、下划线和连字符。重复的自定义 id、空名称和非法 id 会导致插件加载失败。自定义配置与内置项使用相同 id 时会覆盖该内置启动方案，例如可以把 vscode 指向 VS Code Insiders，同时命令仍不会发送到浏览器。

能力边界

浏览器只能获得编辑器 id、名称、可用状态和修复提示，命令和参数不会经过线协议。打开请求只携带 Workspace id 和编辑器 id；Host 通过 ctx.workspaceRegistry 解析 Workspace，并通过已经校验的编辑器白名单解析命令，然后才会启动进程。

编辑器进程会继承打开图形应用所需的桌面和会话变量，但 Host 会移除变量名表明其包含 API key、access token、secret、credential、password、private key、connection string 或 database URL 的环境变量。SSH_AUTH_SOCK 只指向用户的 agent socket，并不直接包含凭据，因此会保留。

插件只能打开仍然存在目录的已登记 Workspace。它不会读取、写入、克隆、同步或上传 Workspace 文件，也不注册模型工具、技能、提示词或模型可见事件。启动操作来自用户在 Web 界面中的明确点击，因此不需要 Agent 审批。

首选编辑器保存在当前浏览器中。不同浏览器可以选择不同的默认值，而不改变 Host 配置。

只有 Host 接受启动后才会更新首选项。启动失败不会改变原选择，并会通过浏览器临时提示明确告知用户。在兼容客户端中，键盘导航会临时显示原本只有悬浮时可见的 Workspace 操作按钮。

开发

仓库使用相邻的 ../dsh DeepSeek Harness 源码作为开发期链接依赖。

pnpm install
pnpm run check

pnpm run check 会执行类型检查、lint、测试和生产构建。file profile 安装不会自动构建包，因此需要提交 lib/。

src/contract.ts 中的严格 Typert 描述符由 Host manifest 和客户端 Remote 贡献共用。Host 编辑器注册表负责可执行文件发现和命令隐私，Workspace 注册表负责从 id 解析路径。行菜单插槽声明由 Harness 持有；该声明进入公开客户端包之前，插件使用一个窄类型适配器。

交互约定、安全边界、兼容方案和验证策略详见 DESIGN.md。

License

MIT