MuYu-Zh/dsh-open-browser

Plugin插件 Native原生 ⭐ 2 Search & Web Access搜索与联网

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

catalog descriptioncatalog 简介 / catalog description:源码启动自动唤醒web ui

Project Overview项目介绍

dsh-open-browser is an unofficial DeepSeek Harness plugin that automatically opens the Web UI in a browser once the dsh web server is ready, eliminating manual URL copying. It injects the webRuntime service, waits for the Loader to settle and the port to bind, then launches Chrome/Chromium first with the system default browser as fallback across Windows, macOS, and Linux. Use it when you want the page to open on startup; it is community-maintained, unaffiliated with DeepSeek, and stays quiet on failure.

dsh-open-browser 是一个非官方 DeepSeek Harness 插件,在 dsh web 服务器就绪后自动用浏览器打开 Web UI 页面,无需手动复制 URL。它注入 webRuntime 服务、等待 Loader 结算确认端口绑定成功,再按平台优先启动 Chrome/Chromium、回退系统默认浏览器,跨 Windows/macOS/Linux,零配置零依赖。适合希望启动即打开页面的场景;注意它为社区项目,与 DeepSeek 官方无关,启动失败时仅静默记录日志。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-open-browser

把 MuYu-Zh/dsh-open-browser 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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 安装(推荐;仓库已包含预构建 index.js,无需再构建)
dsh plugin --profile <name> add github:MuYu-Zh/dsh-open-browser

# 或从 npm 安装(需已发布到 npm registry)
dsh plugin --profile <name> add dsh-open-browser

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

验证并启动:

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

移除:

dsh plugin --profile <name> 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:<port>;
  3. 等待 Loader 结算(与官方就绪日志同一语义)后,按平台候选链在浏览器中打开 URL。

npm 包结构

  • index.js:预构建产物,安装后直接可用
  • cordis.patch.yml:DSH bundle 装配声明
  • src/open-browser.ts:TypeScript 源码
  • README.md:本文档

开发

# 源码在 src/open-browser.ts,index.js 是无类型分发入口
# 修改源码后,按需重新转译:
#   npx tsc --target es2022 --module esnext --moduleResolution bundler src/open-browser.ts --outFile index.js
# (转译前请移除 @deepseek-ai/cordis 的类型导入)

# 本地校验 npm 包内容
npm pack --dry-run --ignore-scripts

许可

MIT


插件专区发帖模板(可直接复制)

标题:

DSH|dsh-open-browser|dsh Web UI 启动后自动用浏览器打开页面(跨 Windows/macOS/Linux)

正文:

> 非官方项目,由社区成员独立开发和维护。

**项目地址:**
https://github.com/MuYu-Zh/dsh-open-browser

**项目介绍:**
dsh-open-browser 是一个 DeepSeek Harness 插件:dsh Web UI 服务器成功启动后,
自动在浏览器中打开页面,无需手动复制 URL。
- 跨平台:Windows / macOS / Linux 统一行为,Chrome/Chromium 优先、系统默认浏览器兜底;
- 零配置、零外部依赖(仅用 Node 内置模块);
- 等 Loader 结算(服务器真正就绪)后才打开,启动失败保持安静,不打断 dsh。

**与 DSH 的集成方式:**
插件注入 webRuntime 服务并等待 Loader 结算,读取 ctx.webServer.port 拼出页面地址;
通过 cordis.patch.yml 以 dsh.bundle 组合包形式安装:
`dsh plugin --profile <name> add github:MuYu-Zh/dsh-open-browser`

**截图:**
(添加 dsh 启动后浏览器自动打开页面的截图/GIF)
← 上一个 Prev dsh-travel-plan 下一个 Next dsh-plugin-reading-pipeline →