前言¶
默认情况下,DeepSeek Harness (DSH) 在浏览器标签页中运行,与普通网页混合在一起。dsh-desktop-app 插件通过将其转换为独立窗口来解决这个问题,使其看起来和表现得像原生软件:没有浏览器标签页,没有地址栏,没有书签栏,只有自己的任务栏条目和图标。
插件定位¶
这是一个由 MARIOMLY 维护的 DeepSeek Harness 插件。它注册了一个名为 desktop_app 的宿主工具,利用现有的 Chromium 浏览器将 Web GUI 变成一个窗口。
核心功能¶
- Chromium –app 模式:将 DSH 界面变为独立窗口,无浏览器标签、地址栏或书签栏。
- 系统托盘驻留:关闭窗口后服务继续在后台运行。托盘图标支持最小化到托盘、恢复窗口和重启服务。
- 无额外运行时:使用现有 Chromium 浏览器,无需 Electron。
- 托盘面板请求:支持从托盘面板请求最小化到托盘。
安装与启用¶
使用官方安装命令:
dsh plugin --profile web add github:MARIOMLY/dsh-desktop-app
安装后重启 dsh web 并验证:
dsh --profile web --dump-config | grep desktop-app
使用方法¶
在 DSH 会话中可以直接对话:
Make this open like a normal desktop app.
也可以使用具体命令(参数见下表):
* status:报告运行中的 Web 端口、检测到的浏览器、Desktop 目录及快捷方式安装状态。
* install:写入启动器并创建桌面快捷方式。
* remove:删除快捷方式和启动器。
* open:立即打开应用窗口。
* restart:重启 DSH 服务器并重新打开应用窗口。此操作需在 DSH 作业对象外创建辅助进程,否则会被终止。
可选参数:
* browser:浏览器 ID 或 Chromium 可执行文件路径。
* icon:快捷方式图标路径。
* shortcutName:桌面快捷方式文件名(默认 DeepSeek Harness.lnk)。
* delaySeconds:restart 专用,等待停止服务前的秒数(默认 15,上限 300)。
* closeOldWindows:restart 专用,是否在窗口关闭前清除旧窗口(默认 true)。
注意事项¶
- X 按钮限制:X 按钮无法从外部重定义(Windows 10/11 返回 ERROR_ACCESS_DENIED)。
- beforeunload 限制:
beforeunload确认在 –app 模式下被 Chromium 抑制。 - 依赖环境:需 Node.js >= 20。
- 服务保护:
restart操作会在 DSH 作业对象外创建辅助进程,以确保服务能被重启。 - 隐私影响:仅关闭 DSH 应用窗口,不会影响用户的其他浏览器标签页。
短结尾¶
该插件适合需要将 DSH 作为常驻窗口使用的开发者,它利用现有浏览器环境实现了接近原生应用的体验。更多细节可查看插件目录或GitHub 仓库。