前言¶
在 DeepSeek Harness（DSH）里跑智能体时，状态多在侧边栏或日志里：谁在调工具、是否在等审批、子代理是否在跑，都要自己扫一眼界面。网页里的小挂件可以装饰，但往往不直接绑宿主的真实事件。
下面介绍社区插件 鲸娘桌宠（仓库 GHSYES/dsh-whale-girl-pet）。它在 Windows 上开一块独立的 Electron 透明置顶窗，监听 DSH 的会话、工具调用、审批、子代理与归档等事件，用 22 个像素动作表达「正在干什么」；同时支持戳脸、拖动、缩放与本地换装。维护者为 GHSYES，在技能目录中归类为趣味换装。
这是什么¶
鲸娘不是嵌在 DSH 页面里的悬浮层：她是独立桌面窗，不占任务栏，也不会在页面里重复出现。插件作为 DSH 宿主插件（ESM，index.js）挂 HTTP 路由、维护状态机，并拉起 Electron 进程渲染透明窗口。
素材随插件分发；若在 %DSH_HOME%\pets\whale-girl-emoji 放置同名 GIF，会覆盖内置资源，便于换装。README 注明像素素材来源于 dsh-tui，美术资源许可与代码许可分开（见仓库 THIRD-PARTY-NOTICES.md）。
核心功能¶
与会话绑定的状态，而非随机动画¶
状态来自真实会话事件，并按 README 给出的优先级裁决（节选理解要点）：
- 设置里的动作预览优先。
- 互动反应（戳脸、挠痒等）覆盖短时待机。
- 等待确认（审批或提问）、出错、上下文清理/归档、worktree、多子代理、多会话调工具等，分别映射到对应动作。
- 无高优先级事件时进入待机循环：先「待机眨眼」约 30 秒，再随机播一轮其他待机动作，然后回到眨眼；5 分钟无互动进入「呼呼大睡」，点击唤醒后重新循环。
- 主会话正常结束，或（可选）个人工作台任务验收通过时，循环播放「任务完成」，需单击一次才会播「举大拇指」并回到正常待机。
共 22 个动作（如 thinking、typing、notification、happy 等），完整 key 与触发条件见仓库 README 表格。
桌面交互¶
- 单击左脸/右脸：戳脸反应；1 秒内连点 3 下：挠痒。
- 按住 Ctrl 再拖：移动窗口（普通拖动不会挪窗）。
- 右键：原生菜单（放大 / 缩小 / 恢复默认 / 收起）。
- 戳脸约 12% 概率「冒爱心」；主会话正常结束约 18% 概率冒爱心，其余进入任务完成循环。
窗口大小可在设置中调节 72–480 px；右键菜单每次 ±32 px。位置与尺寸写入 %DSH_HOME%\whale-pet\desktop\window-state.json，下次启动复原。
DSH 设置面板¶
路径：DSH 设置 → 鲸娘桌宠。可调显示开关、大小、不透明度（20%–100%）、点击穿透、待机轮换，并用网格预览并强制播放各动作约 3 秒。首次无 Electron 运行时时会自动下载固定版本 44.0.0 的 win32-x64 运行时（npmmirror / GitHub Releases，SHA-256 校验）；已安装 dsh-orb 时可复用其运行时。
数据与网络¶
状态与设置仅写本机 %DSH_HOME%\whale-pet\。README 说明不发送遥测；主动外网请求主要是首次下载 Electron。桌面页加载本机 DSH 的 /whale-pet/standalone。若安装可选插件 @dely0/dsh-personal-workbench，会每 2 秒轮询本机 GET /api/workbench/tasks 以联动任务完成庆祝；未安装则静默跳过。
环境与依赖¶
| 项 | 要求 |
|---|---|
| 系统 | Windows 10/11 x64 |
| DSH | Desktop 配置，engines.dsh >= 0.2.0-rc.2（package.json 中 dsh.engines.dsh 同为 >=0.2.0-rc.2） |
| Node.js | 20+ |
| 磁盘 | 插件约 3.5 MB；Electron 运行时下载约 160 MB、解压约 370 MB（已有 dsh-orb 运行时可不重复下载） |
当前插件包版本为 1.0.1，代码许可证 MIT。
安装与启用¶
推荐在 DSH 插件 → 发现 / 插件市场 搜索 dsh-whale-girl-pet 或「鲸娘桌宠」安装。市场目录与 awesome-dsh-plugin 同步，收录后通常一天内可见；若暂时搜不到，可用界面或命令行添加来源。
界面「添加插件」¶
打开 插件 → 添加插件，在输入框填写仓库来源（不要粘贴整条 dsh plugin ... add ... 命令，否则会报无法识别）：
github:GHSYES/dsh-whale-girl-pet
也可使用 README 提供的归档地址作为来源（仅填来源字段）。
命令行（desktop profile）¶
在 PowerShell 中执行：
dsh plugin --profile desktop add github:GHSYES/dsh-whale-girl-pet
成功后 dsh-whale-pet 会写入 profile 的 dsh.profile.bundles。需重启 DSH Desktop 生效（宿主插件仅在启动时加载）。若提示先初始化 profile，则启动并完全退出一次 DSH Desktop 后再重跑命令。可在 %DSH_HOME%\profiles\desktop\package.json 的 bundles 中确认是否包含 dsh-whale-pet。
无网络或不想自动下载 Electron¶
任选其一：安装 dsh-orb 让插件复用 %DSH_HOME%\dsh-orb\electron-runtime\electron.exe；或自备 Electron 44.x，设置环境变量 WHALE_PET_ELECTRON 指向 electron.exe 后启动 DSH。下载日志见 %DSH_HOME%\whale-pet\spawn.log 与 desktop.log。
典型用法¶
- 完成安装并重启 DSH Desktop 后，在设置中打开「显示在桌面上」，等待 Electron 就绪（必要时在面板查看下载进度或重试）。
- 照常使用 DSH 会话：调工具时可见「敲代码」等状态；出现审批或提问时可见「需要你确认」。
- 需要挪动桌宠时按住 Ctrl 拖动；被窗口挡住工作时可在设置中开启「点击穿透」。
- 换装：将自定义 GIF 放到
%DSH_HOME%\pets\whale-girl-emoji，文件名与内置动作一致即可覆盖。 - 在设置网格中点某个动作，可预览 3 秒，对应宿主 API
POST /whale-pet/api/preview。
适用场景与注意¶
适合谁：在 Windows 上使用 DSH Desktop、希望用桌面像素角色直观看会话与子代理状态，并愿意接受首次 Electron 运行时下载的开发者。
权限与信任：插件以当前 DSH 进程权限运行，向本机 webServer 注册 /whale-pet 路由并管理 Electron 子进程。安装前宜浏览仓库源码与 LICENSE、THIRD-PARTY-NOTICES.md。
已知限制（摘自 README）：
- DSH 完全退出后桌宠关闭；重新打开 DSH 会自动恢复。
- 改
index.js、runtime.js、desktop/*需重启 DSH Desktop；改standalone.js仅需重启桌宠窗口。 - 自动下载的 Electron 仅覆盖 Windows x64；其他平台需
WHALE_PET_ELECTRON。 - 同一 Windows 用户仅允许一个桌宠窗口（单实例锁）。
技能目录页：skillhub.cn 插件条目。社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
鲸娘桌宠把 DSH 里抽象的「智能体正在做什么」转成桌面上的像素反馈，并保留戳弄、缩放与本地换装。若你要在 Windows 上边写代码边看状态，可按上文命令安装 github:GHSYES/dsh-whale-girl-pet，在设置里打开桌面窗即可。
- 目录页：https://www.skillhub.cn/plugins/GHSYES/dsh-whale-girl-pet
- 源码与完整动作表：https://github.com/GHSYES/dsh-whale-girl-pet
