dsh-open-browser

非官方项目，由社区成员独立开发和维护。与 DeepSeek 官方无关。

Unofficial project, independently developed and maintained by community members. Not affiliated with DeepSeek.

一个 DeepSeek Harness (dsh) 插件：Web UI 服务器启动成功后，自动在浏览器中打开页面。

• 无需手动复制粘贴 URL——dsh web 一启动，页面就自动打开。
• 跨平台：Windows / macOS / Linux 统一行为。
• 零配置、零依赖（仅使用 Node 内置模块）。

特性

• 就绪后再打开：注入 webRuntime 服务并等待 Loader 结算，只有服务器真正绑定成功才打开浏览器；启动失败则保持安静。
• Chrome/Chromium 优先，默认浏览器兜底（三平台一致）：
  • Windows：探测 PROGRAMW6432 / PROGRAMFILES / PROGRAMFILES(X86) / LOCALAPPDATA 下的 chrome.exe，找不到回退 cmd /c start；
  • macOS：探测 /Applications 与 ~/Applications 下的 Chrome，找不到回退 open；
  • Linux：探测 google-chrome / chromium 等（含 /snap/bin），回退 xdg-open → gio open → sensible-browser。
• 不拖住 dsh 进程：detached + stdio ignore 启动，打开失败只记日志。

安装

要求已安装 dsh CLI（见官方文档）。

# 从 GitHub 安装（源码安装，仓库需带 prepare 构建脚本并授权构建）
dsh plugin --profile  add github:/dsh-open-browser

# 或从 npm 安装（推荐，安装的是预构建产物）
dsh plugin --profile  add dsh-open-browser

# 或从 tarball 安装
dsh plugin --profile  add ./dsh-open-browser-0.1.0.tgz

验证并启动：

dsh --profile  --dump-config   # 应看到 "# == dsh-open-browser" 层
dsh --profile 

移除：

dsh plugin --profile  remove dsh-open-browser

工作原理

cordis.patch.yml 向组合插入一行插件：

- insert:
    - id: open-browser
      name: dsh-open-browser

插件加载后：

1. 声明注入 webRuntime 服务——只有 dsh-web-app 绑定 Web 服务器后该服务才存在；
2. 读取 ctx.webServer.port 拼出 http://127.0.0.1: ；
3. 等待 Loader 结算（与官方就绪日志同一语义）后，按平台候选链在浏览器中打开 URL。