在 DeepSeek Harness (DSH) 的 Web profile 中,默认行为是在默认浏览器中打开一个标签页。这种方式缺乏独立应用的操作体验,且容易干扰日常浏览。big0lives 开发的 dsh-web-window-companion 插件通过改变浏览器启动方式,解决了这个问题。
这是什么¶
这是一个 DSH Web profile 插件(bundle)。安装后,dsh web 的行为会变为:不再往默认浏览器里扔一个标签页,而是用 Edge 或 Chrome 的 App 模式打开一个独立窗口。该插件由 big0lives 维护,采用 MIT 许可证,核心价值在于将 Web GUI 变为桌面应用模式,且具备窗口关闭即停服的能力。
核心功能¶
- 不再往默认浏览器里扔一个标签页。
- 用 Edge / Chrome 的 App 模式打开独立窗口。
- 关掉窗口即优雅停服。
- 零依赖、零配置、纯 JavaScript。
- 浏览器探测顺序:Edge (x86 -> x64) -> Chrome (x64 -> x86)。
安装与启用¶
在 web profile 中执行安装命令:
dsh plugin --profile web add github:big0lives/dsh-web-window-companion
安装完成后,执行以下命令验证插件层是否生效:
dsh --profile web --dump-config
在输出中应能看到 # == dsh-web-window-companion 层。
若需卸载:
dsh plugin --profile web remove dsh-web-window-companion
典型用法¶
安装后直接启动:
dsh web
- 终端会打印带 token 的 URL(
dsh web: http://127.0.0.1:3080/?token=...)。如果 App 窗口无法打开,可以手动复制该 URL 使用。 - 关闭 App 窗口后,服务会优雅退出(root fiber dispose,exit code 0)。
- 在 SSH 远程启动时,插件会自动保持静默,不抢窗口。
适用场景与注意¶
适合将 DSH Web 当作桌面应用使用。
- 零依赖:无需构建步骤,纯 JavaScript 实现,git 安装无需额外配置。
- 环境探测:会优先探测 Edge,然后是 Chrome,探测顺序为 x86 -> x64。
- 隐私保护:使用专用浏览器 profile,不碰你日常浏览器的任何状态。
⚠️ 注意:姊妹项目 dsh-win-quick-launcher 与本插件使用同一个浏览器专用 profile。两者二选一,不要同时启用。
结语¶
该插件通过简单的配置,实现了 DSH Web 的桌面化体验,适合需要快速启停且不希望占用默认浏览器的场景。