前言¶
DSH 的服务启动、停止、状态查看和 GUI 打开，通常分散在命令行与浏览器入口。dsh-whale-pet 将这些动作整合到一个 Windows 桌面宠物程序里：先检测 DSH 服务，未运行则后台拉起，就绪后再打开 GUI。
下面介绍它的核心能力、安装方式、典型用法和依赖。
这是什么¶
dsh-whale-pet 是一个 Windows 桌面宠物程序，由 miku00039-01 维护。它把 DeepSeek Harness（下文称 DSH）的服务启动、停止、状态监测和 GUI 唤起整合到一个零依赖的 .exe 里。
适合需要在 Windows 桌面上用鼠标完成 DSH 服务启停、状态查看和 GUI 打开的人。
核心能力¶
- 一键启动：检测 DSH 服务；未运行则后台拉起；就绪后打开 GUI。
- 人形桌宠：逐像素透明悬浮窗，可拖动、记住位置。
- 双击唤起：双击桌宠打开 GUI，复用同一 PWA 窗口，不堆标签页。
- 右键菜单：打开程序、关闭程序、查看状态、退出。
- 关闭程序：只停 DSH 服务并关闭 GUI 应用窗口；按窗口标题精确匹配，不影响其他浏览器页面。
- 托盘图标：左键唤起，右键菜单作为兜底入口。
- 状态监测：仅绿/红两态；在线 5 秒、离线 2 秒自适应频率。
- 状态卡片：显示服务状态、地址、PID、运行时长，以及桌宠内存和 GDI 句柄。
- 单实例：重复双击不会开第二个实例。
- 崩溃日志：未捕获异常自动写入
dsh-whale-pet-crash.log。 - DSH 插件：可作为插件安装，并在 DSH 中使用
/whalepet启动。
安装与启用¶
可以作为 DSH 插件安装。执行：
dsh plugin --profile web add github:miku00039-01/dsh-whale-pet
安装完成后，在 DSH 中运行：
/whalepet
即可启动鲸鱼娘桌宠。
也可以从 Releases 下载 DSH桌宠.exe，双击运行。首次运行会在 exe 同目录生成 dsh-whale-pet.conf，可按需修改。
如果要从源码构建，运行：
pwsh -File build.ps1
如果要触发 CI 自动构建 Release，可以推送 v* 标签，例如：
git tag v1.0.0
git push origin v1.0.0
典型用法¶
下面给出几个可复现步骤。
1、安装插件后，在 DSH 中输入：
/whalepet
启动桌宠。
2、双击桌宠，唤起 GUI。桌宠复用同一 PWA 窗口，不堆标签页。
3、右键桌宠，从菜单中选择：
打开程序
关闭程序
查看状态
退出
4、右键托盘图标，也可以使用兜底入口。
5、如果 GUI 默认打开方式不符合预期，修改 dsh-whale-pet.conf 中的 pwaShortcut，指向别的 PWA 快捷方式；置空则始终用默认浏览器打开。
依赖与运行方式¶
必选依赖：
- Windows 10 / 11
.NET Framework 4.x- 正确安装
DeepSeek Harness，包括Node.js、dsh CLI全局安装、已配置DEEPSEEK_API_KEY
可选依赖：
Chrome，用于 PWA 独立窗口；未安装或未找到时，自动回落到默认浏览器打开
桌宠通过 node 拉起 DSH 服务，并监听：
127.0.0.1:3080
启动服务时，桌宠使用：
dsh web --no-open
这样可以避免 DSH 默认自动打开浏览器造成双窗口。
“关闭程序”只停 DSH 服务并关闭 GUI 应用窗口，不影响其他浏览器页面。
注意事项¶
- 代码许可证为
MIT。 - 素材部分需遵循
assets/WHALE_ATTRIBUTION.md的授权说明；使用或分发前确认符合要求。 - 插件以当前
dsh进程权限运行。安装前应先检查源码与许可证。 dsh-whale-pet是 DSH 插件生态中的第三方项目，不应视为官方应用商店或官方组件。
链接¶
GitHub：
https://github.com/miku00039-01/dsh-whale-pet
可以访问仓库查看源码、构建脚本和素材授权说明。
