whale-girl：DeepSeek Harness 的桌面宠物 DSH plugin

whale-girl 是 DeepSeek Harness（DSH）的桌面宠物插件（DSH plugin），以 QQ 宠物形态悬浮在 DSH Web GUI 右下角，为开发者提供陪伴感。它解决的是长时间编码或会话过程中的枯燥与孤独问题，通过可拖拽、可投喂/玩耍的积累型伙伴，将任务完成、会话活跃等行为转化为资历等级、称号与回忆。核心能力包括 15 种状态机（如 idle、working、celebrate、error、sleep 等），支持配置尺寸、透明度、游走开关等，并允许切换角色。

whale-girl 这个 DSH plugin 支持哪些核心特性？

whale-girl 提供丰富的互动状态机：拖拽宠物会斜向拉扯（drag），点击菜单可喂食（eat）或玩耍（play）并触发开心（joy）；空闲超过 60 秒会打盹（sleep），互动时唤醒（wake）；任务完成或升级时举手欢呼（celebrate），失败或出错时惊吓（error）后失落（disappointed）；新会话开始挥手欢迎（welcome），会话思考时沉思陪伴（think），等待批准时期待（wait），周期游走（walk），常态待机（idle）。所有状态转换语义见 docs/state-machine.md。

whale-girl 怎么安装？

whale-girl 是官方 bundle 插件格式，通过 DSH profile 管理。推荐使用 git 源安装（构建产物已入库），也可本地目录安装。安装后需重启 web 使 bundle 层生效，右下角出现宠物。更新时使用 update 命令。

dsh plugin --profile web add github:vlln/whale-girl#main
# 或本地目录：dsh plugin --profile web add <whale-girl 本地路径>

whale-girl 怎么配置？

配置通过宿主 settings.yaml 的 whale-girl section 或设置 UI 修改，热生效免重启。主要参数包括 enabled（网页端渲染开关）、size（宠物尺寸 64–160 px）、opacity（常态透明度 0.2–1）、walk.enabled（游走开关）、sleepAfterMs（空闲多久打盹）。注意语义层（XP/称号阈值）不可配置，以保持积累账本一致性。

whale-girl 支持哪些角色和状态素材？

菜单「🎭 换角色」可循环切换角色，每个角色提供全部 15 种状态素材，素材契约见 docs/sprites-spec.md。贡献新角色指南见 docs/adding-a-character.md。角色形象由 ZipZipPipe 创作（《鲸鱼娘》表情包角色），sprites 基于其设定生成。

whale-girl 作为参考实现有什么价值？

whale-girl 是官方 repository-plugin 格式的完整范本，不绑定具体基线版本，随官方机制演进。其结构（lib/ 与 docs/decisions/scripts 分离）、规范（门禁 + 决策记录 + 素材全量契约）可供开发新插件对照。由 vlln 维护，采用 MIT 协议，最近更新于 2026-08。

查看更多 DSH 插件，访问 dsh-plugin.org