dawsondx/dsh-web-open 预览 preview

dawsondx/dsh-web-open

DeepSeek 工具集(dsh)捆绑包:当 `dsh web` 就绪时,打印完整的 GUI 网址并在默认浏览器中打开。跨平台,零运行时依赖,安全可靠。

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH) that automatically opens your default browser once the dsh web command finishes launching the local DSH web interface. The official DSH distribution (as of 0.1.0-rc.6) only prints the local web URL to the console log, with no built-in capability to automatically launch a browser after startup, and does not include a --open CLI flag for this workflow. It installs with a single dsh plugin add command, runs cross-platform on Windows, macOS, and Linux, and requires no extra runtime dependencies to work after installation.

To install the plugin, you must first have DSH installed, have initialized your DSH profile by running dsh web at least once, and have pnpm available in your system PATH. You can install it from the public npm registry with the command dsh plugin --profile web add @dawsondx/dsh-web-open or directly from this GitHub repository with dsh plugin --profile web add github:dawsondx/dsh-web-open. After installation, DSH automatically registers the plugin to your profile, and it will take effect the next time you run dsh web. You can verify the installation worked correctly by running dsh web --dump-config and checking for the "id: web-open" entry in the output.

The plugin is released under the permissive MIT open source license, and is designed with fail-safe behavior to avoid breaking your DSH installation. It only depends on DSH's stable core interfaces, and if DSH changes internal service names in future releases, the plugin will silently degrade instead of crashing the entire DSH boot process. Unlike other DSH browser plugins that launch a headless browser for model web scraping, this plugin opens your regular desktop browser to access the DSH GUI. It works predictably on headless Linux servers by printing the URL and not attempting to open a browser.

这是一个专为 DeepSeek Harness (DSH) 开发的原生插件,为 dsh web 命令增加了启动完成后自动打开浏览器的功能。官方 DSH 0.1.0-rc.6 版本目前只提供打印链接到日志的功能,没有启动后自动打开浏览器的能力,也没有 --open 这类 CLI 参数。本插件仅需一条命令即可安装,支持 Windows、macOS、Linux 全平台运行。

安装要求用户预先装好 DSH,完成 profile 初始化(运行过一次 dsh web),且系统 PATH 中包含 pnpm。可通过 npm 官方源或 GitHub 仓库安装,安装后会自动注册到 DSH 的 profile,重启 dsh web 即可生效。插件支持自定义配置,可以通过 profile 文件或环境变量调整行为,比如只打印链接不打开浏览器。

本插件采用 MIT 许可协议,核心零运行依赖,只依赖 DSH 稳定核心接口,做了故障安全设计,就算接口变动也只会静默降级不影响 DSH 启动。它只解决自动打开用户浏览器的需求,区别于给模型用的无头浏览器抓取插件。对于无图形界面的 Linux 环境,也会正常打印链接不报错。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
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 @dawsondx/dsh-web-open

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

READMEREADME

dsh-web-open: Auto-open browser when dsh web is ready

中文 | English

MIT npm Windows / macOS / Linux CI


中文

一句话:dsh web 启动完成 → 完整链接自动打印 → 浏览器自动打开。 装一次,任何装了 dsh 的机器都能用;零依赖、跨平台、故障安全。

以前 vs 现在

以前(每次都要) 现在(一次装好)
记一长串 npx @deepseek-ai/dsh web 输 dsh web 即可(想更省事可自建快捷方式/别名)
启动后自己拼 http://127.0.0.1:3080/ 复制进浏览器 链接自动打印,浏览器自动打开
每台机器手动配 PATH、建快捷方式 dsh plugin --profile web add @dawsondx/dsh-web-open 一行安装

效果长这样

$ dsh web
[web-open] Web GUI ready: http://127.0.0.1:3080/
# ↑ 完整链接自动打印,浏览器同时自动打开 —— 全程零手动操作

本仓库包含什么(安装前先看清楚)

部分 内容 安装方式 平台
插件本体(核心) index.js / opener.js / cordis.patch.yml:dsh web 就绪后打印链接并自动打开浏览器 dsh plugin --profile web add @dawsondx/dsh-web-open(或 GitHub 直装) Windows / macOS / Linux
可选:Windows 启动器 contrib/windows/dsh-web.cmd:一键启动 + 自动检查官方新版 自行复制到 PATH 目录,或为它建桌面快捷方式 仅 Windows
可选:Windows 更新脚本 contrib/windows/dsh-update.cmd:一键更新 harness 同上 仅 Windows
可选:Unix shell 函数 contrib/unix/dsh-fn.sh:dsh = dsh web 加入 ~/.bashrc / ~/.zshrc macOS / Linux

插件本体不包含更新功能,也不包含桌面快捷方式——桌面快捷方式、PATH 配置属于每台机器自己的事,仓库不替你创建;可选的 Windows 脚本复制到 PATH 后即可使用。

为什么需要它

官方 dsh (0.1.0-rc.6) 目前只有 printUrl(把链接打印到日志里),没有"启动后自动打开浏览器"的能力;CLI 也没有 --open 参数。社区现有的 dsh-plugin-browser / @anweat/dsh-browser 是给模型用的无头浏览器工具(Playwright 抓网页),与本插件解决的问题不同——本插件打开的是你自己的浏览器来看 GUI。

这个插件解决一个问题:dsh web 启动完成后,打印 URL 并自动打开浏览器。跨平台、零运行时依赖、故障安全设计。

安装

前提条件:已安装 dsh、已初始化 profile(跑过一次 dsh web 即可),且 PATH 里有 pnpm。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev DSH-closerAI 下一个 Next dsh-deepseek-price →