# DSH 鲸鱼娘桌面启动器

中文 | [English](README.md)

<p align="center">
  <img src="assets/whale-girl.png" width="280" alt="鲸鱼娘桌面启动器图标">
</p>

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

本项目是 [HUITianYi/dsh-whale-desktop-launcher](https://github.com/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：

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

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

```text
桌面\DeepSeek Harness.exe
```

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

## 可选鲸鱼娘皮肤

启动器可以搭配非商业许可的 [`Small-tailqwq/dsh-deep-whale`](https://github.com/Small-tailqwq/dsh-deep-whale) 皮肤：

```powershell
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：

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

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

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

## 开发

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

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

## 许可证

- 源代码：[MIT](LICENSE)。
- 鲸鱼娘图像：[CC BY-NC-SA 4.0](ASSET_LICENSE.md)，仅限非商业使用。

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