0QwQ0/dsh-whale-desktop-launcher

DSH 鲸鱼娘桌面启动器

这是一个适用于 DeepSeek Harness 的 Windows 桌面启动器插件。插件会在桌面创建带鲸鱼娘图标的 DeepSeek Harness.exe；双击后，它会按需在后台启动 DSH Web，并使用 Microsoft Edge 或 Google Chrome 的应用模式打开页面，不显示标签栏、地址栏和普通浏览器工具栏。

本项目是 HUITianYi/dsh-whale-desktop-launcher 的 fork，新增了启动进度悬浮窗、系统托盘控制和 DPI 感知渲染。

功能

- 单击桌面程序即可启动或连接 dsh web，不显示终端黑窗。
- 启动过程中会弹出一个小型置顶悬浮窗，展示各阶段进度（检查服务、启动服务、等待就绪、打开界面）。
- 启动器运行期间常驻系统托盘图标（与桌面图标一致的鲸鱼娘）：悬停可查看当前状态，左键双击打开界面，右键菜单可打开界面、重启服务或退出（退出会一并停止 DSH 服务进程）。
- 单实例：托盘运行期间再次双击桌面图标，只会重新打开界面窗口。
- Chromium --app 模式提供简洁的桌面应用窗口。
- 插件内置透明 PNG 和多尺寸 Windows ICO。
- bundle 激活时记录当前 DSH 可执行文件、参数和工作目录，同时兼容 npm 安装版与源码版。
- 已经健康运行的 DSH 服务会直接复用；若端口被其他服务占用，则明确报错。
- 就绪检测兼容 dsh-ui-auth 登录页：未登录的页面请求会被重定向到 /auth/login，启动器将返回的登录页视为 DSH 已启动。
- 升级时会自动替换桌面上的旧版启动器；仅当桌面同名文件不是可执行程序时才拒绝覆盖。
- 包安装时不执行 preinstall、install、postinstall 或 prepare 生命周期脚本。

环境要求

- Windows 10 或 Windows 11。
- 已配置 DeepSeek Harness web profile。
- Microsoft Edge 或 Google Chrome。
- DSH 所要求的 Node.js 22.19 或更高版本。

安装

将 bundle 安装到 Web profile：

dsh plugin --profile web add github:0QwQ0/dsh-whale-desktop-launcher#v0.3.0

重启一次 dsh web。插件激活后会把便携配置写入 ~/.dsh/whale-desktop-launcher/，并创建：

桌面\DeepSeek Harness.exe

之后双击桌面程序即可一键启动。

可选鲸鱼娘皮肤

启动器可以搭配非商业许可的 Small-tailqwq/dsh-deep-whale 皮肤：

git clone https://github.com/Small-tailqwq/dsh-deep-whale "$HOME\.dsh\plugins\dsh-deep-whale"
dsh plugin --profile web add "$HOME\.dsh\plugins\dsh-deep-whale\maid-atelier"

该皮肤使用独立的 CC BY-NC-SA 4.0 许可证与署名要求。

卸载

移除 DSH bundle：

dsh plugin --profile web remove dsh-whale-desktop-launcher

为了避免插件卸载时删除用户可见文件，以下内容不会自动清理，可按需手动删除：

%USERPROFILE%\Desktop\DeepSeek Harness.exe
%USERPROFILE%\.dsh\whale-desktop-launcher\

开发

npm run build:launcher
npm test
npm run pack:check

预构建 EXE 已提交在 assets/，因此从 GitHub 安装时不需要批准构建脚本。

许可证

- 源代码：MIT。
- 鲸鱼娘图像：CC BY-NC-SA 4.0，仅限非商业使用。

这是社区项目，并非 DeepSeek AI 官方产品。