whale-girl
vlln/whale-girl
桌面宠物(QQ 宠物形态):右下角悬浮、可拖拽/投喂/玩耍。
安装
把 whale-girl 装进 DeepSeek Harness
GitHub 方式 · GitHub 源码
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
我们跑过之后
我们跑过,装得上
这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 昨天.
安装前须知
装 whale-girl 之前,先看这几条
- 源码在这里: vlln/whale-girl——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:MIT。
- 被收录在这里不代表通过了安全审计。插件是带着你 agent 的权限在跑。
AI 锐评
是什么 — DSH Web GUI 右下角悬浮的桌面宠物,可拖拽投喂玩耍并积累任务资历。
谁该装 — 在 DSH Web GUI 进行任务时适合装它积累资历。想不添加桌面伴侣的用户可以不装。
注意 — 没发现明显的坑。沙箱实测通过,在全新 profile 注册进 profile。配置修改如尺寸、游走开关热生效无需重启。
锐评 — 我会装它,因为它能在任务时积累资历,但前提是 Web GUI 用户。
grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。
whale-girl 是做什么的

whale-girl 是一个 DeepSeek Harness 插件,在 DSH Web GUI 右下角显示可拖拽的桌面宠物。它不是独立的 agent,也不替代会话、任务或批准流程,而是把这些活动转成可见的陪伴状态:新会话会欢迎,思考中会陪伴,等待批准时等待,任务完成时庆祝,请求出错时表现出惊吓和失落。点击菜单可以投喂或玩耍,悬停可查看资历等级、任务数和最近共同记忆;任务、会话与活跃陪伴时长会持续积累等级、称号和回忆。
插件以官方 bundle 接入 web profile,网页端重启后生效。宿主设置中的 whale-girl: 可调整是否启用、尺寸、透明度、游走和入睡时间,配置热生效。网页端宠物不访问外部服务的事实未在 README 中说明,因此不应据此判断其网络行为。
它适合希望在工作台中加入轻量状态反馈和趣味陪伴的开发者。不需要宠物、希望界面保持简洁,或已经运行独立桌面伴侣时,不建议使用;后者会渲染同一个角色,可能造成重复显示。desktop/ 不随 dsh plugin 安装,使用 Node 引擎和 Tauri 外壳,并通过公开端点与插件配合。
whale-girl 的文档
行为说明
初始配置和 onboarding 期间宠物隐藏。网页端根据活动切换状态:新会话为 welcome;会话运行或思考中为 think,偶尔为 working;等待批准为 wait;任务完成、升级、称号或回合完成为 celebrate;任务失败或请求出错为 error,随后为 disappointed;空闲达到 60000 ms 后为 sleep,互动后为 wake。投喂和玩耍分别触发 eat、play,随后进入 joy。平时还会 idle、周期游走 walk。完整优先级见 docs/state-machine.md。
配置
在设置 UI 或 <dshHome>/settings.yaml 的 whale-girl: section 中修改,热生效:
| 键 | 默认值 | 作用 |
|---|---|---|
enabled |
true |
开关网页端渲染 |
size |
110 |
尺寸,范围 64–160 px |
opacity |
1 |
常态透明度,范围 0.2–1 |
walk.enabled |
true |
开关游走 |
sleepAfterMs |
60000 |
入睡前的空闲时长 |
资历、XP 和称号语义不可配置。角色可在菜单中切换,也可使用 localStorage 键 whale-girl:character。
命令与桌面伴侣
更新使用 dsh plugin --profile web update whale-girl,之后需重启 web。desktop/ 不由 dsh plugin 安装;在该目录运行 npm install,推荐使用 cd src-tauri && cargo run 启动 Tauri 外壳,也可运行 npm run start:headless 使用无窗模式。
环境要求
桌面伴侣使用 Node 引擎和 Tauri v2 渲染壳;README 也保留 Electron 外壳。它读取 /state、/events、/presence、/interact、/config、/assets。运行时网页端自动隐藏;退出或 45s TTL 过期后恢复。
根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README
同一分类
whale-girl 的同类插件
dsh-dafeiyu
QCYTSN
Desktop-native BigFish companion for DeepSeek Harness — real Agent status, always on top on Windows.
我们跑过,装得上
dsh-pet
PC2005-cloud
DSH Web UI 桌面宠物:25 个透明动画、屏幕漫游、点击反应与拖拽,附可复现的素材生成链。
没有一行式安装命令——这个插件在一个大仓库的子目录里,也没发 npm 包。
dsh-stock-watch
Awu12277
A 股自选股实时行情盯盘插件:在 DeepSeek Harness(DSH)Web 界面的右上角显示一个可折叠弹窗,实时监控自选股行情、切换分组、查看分时与 K 线、设置买卖目标价。
我们跑过,装得上