DeepSeek Harness (DSH) 的 Web profile 依赖本地服务运行。在 Windows 环境下，启动这些服务并打开浏览器通常需要终端命令。DeepSeek Harness 的插件系统支持扩展。dsh-whale-desktop-launcher 插件解决了这一痛点，通过创建一个桌面快捷方式，自动在后台启动服务并在 Chromium 应用模式下打开 UI。
这是一个 Windows 桌面启动器插件，由 0QwQ0 维护。它会在桌面生成一个带鲸鱼图标（whale-girl）的 DeepSeek Harness.exe。点击该图标时，插件会在后台启动 DSH Web 服务，并使用 Chromium 的 --app 模式打开一个无标签页、无工具栏的紧凑型桌面窗口。
核心功能¶
- 一键启动与重连：无需打开终端即可启动或重连到
dsh web。 - 浮动进度窗口：启动过程中会显示一个悬浮窗口，展示各个阶段（检查服务、启动服务器、等待就绪、打开 UI）。
- 系统托盘控制：程序运行时会在系统托盘驻留图标。悬停查看状态，双击打开 UI，使用菜单重启服务或退出（退出会停止 DSH 服务）。
- 单实例模式：程序运行时再次双击桌面图标，只会重新打开 UI 窗口，不会重复启动服务。
- Chromium 应用模式：提供类似原生应用的窗口体验。
- 资源捆绑：内置鲸鱼女孩 PNG 和多分辨率 ICO 图标。
- 参数捕获：激活时会捕获当前的 DSH 可执行文件路径、参数和工作目录，确保 npm checkout 和源码检查都能正常工作。
- 复用现有服务：如果端口上已有健康的服务，插件会复用它，而不是启动新的实例。
- 就绪检测：能够识别
dsh-ui-auth登录页面作为服务就绪的标志，自动处理未认证请求的跳转。 - 自动升级：升级时会在桌面替换旧的
DeepSeek Harness.exe。
安装与启用¶
- 使用以下命令安装插件到 Web profile：
dsh plugin --profile web add github:0QwQ0/dsh-whale-desktop-launcher#v0.3.0
- 安装完成后，重启
dsh web一次，以便插件激活并写入配置。
典型用法¶
安装并重启服务后，桌面上会出现 DeepSeek Harness.exe。双击该图标即可启动 UI。
注意事项与适用场景¶
- 环境要求：需要 Windows 10 或 11。需要 Node.js 22.19 或更高版本。需要已安装 DSH Web profile。需要 Microsoft Edge 或 Google Chrome。
- 许可证：鲸鱼女孩艺术作品使用 CC BY-NC-SA 4.0 许可证（仅限非商业使用）。源代码使用 MIT 许可证。
- 卸载行为：卸载插件时不会删除桌面上的
DeepSeek Harness.exe文件，需要手动删除。 - 生命周期脚本：安装过程中不会运行
preinstall、install、postinstall或prepare脚本。 - 适用场景：适合需要在 Windows 桌面上快速访问 DSH Web 界面的开发者，特别是习惯使用 Chromium 应用模式而非标准浏览器标签页的用户。
结语¶
该插件通过封装底层服务启动逻辑，降低了 DSH 在 Windows 上的使用门槛，提供了类似原生应用的操作体验。
