whale-girl
vlln/whale-girl
桌面宠物(QQ 宠物形态):右下角悬浮、可拖拽/投喂/玩耍。
安装
把 whale-girl 装进 DeepSeek Harness
npm 方式
直接拉已发布的 tarball,不用克隆整个仓库,也不需要额外配置。如果你用的是别的 profile,把 `web` 换成对应的名字。
GitHub 方式 · npm 包
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
我们跑过之后
我们跑过,装得上
这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 13 天前.
挂进你的 README
给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。
安装前须知
装 whale-girl 之前,先看这几条
- 源码在这里: vlln/whale-girl——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:MIT。
- 自动识别到:终端执行。授权之前请先读一遍源码。
- 被收录在这里不代表通过了安全审计。插件是带着你 agent 的权限在跑。
AI 锐评
是什么 — 一款QQ宠物风格的桌面浮动宠物,支持拖拽喂食玩耍。
谁该装 — 使用 DeepSeek Harness 进行会话任务的用户,希望获得宠物陪伴和任务反馈。 不适合不使用 Web GUI 的用户,因为这个插件是为 DeepSeek Harness Web GUI 设计的。
注意 — 沙箱实测通过:在全新 profile 里装上,并被 harness 注册进 profile。 没发现明显的坑。
锐评 — 我会装它,因为它能将任务完成度、会话和陪伴时间转化为宠物等级、头衔和记忆。
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.
我们跑过,装得上