whale-girl DSH 插件

whale-girl 是一个为 DSH Web GUI 设计的桌面宠物伙伴。它可拖拽移动，通过菜单投喂或玩耍，并对任务完成、会话事件、空闲超时等做出 15 种以上动画反馈。宠物会根据你的活跃度积累经验等级、称号和回忆，增加陪伴感。

如何安装 whale-girl DSH 插件

dsh plugin --profile web add "github:vlln/whale-girl#main"   # 推荐：git 源一行（构建产物已入库

复制不会执行命令。安装 whale-girl DSH 插件前请核对仓库和版本。

whale-girl DSH 插件数据来源

whale-girl DSH 插件快照日期：2026年8月16日

discovered

whale-girl DSH 插件能做什么

拖拽宠物在屏幕上移动
通过右键菜单投喂（🍗）或玩耍（🎾），触发进食/抛接球动画
对任务完成、错误、新会话、等待批准、空闲超时等状态做出 15 种以上动画，如庆祝、惊吓、失落、欢迎、沉思等
积累资历等级、称号和回忆，根据任务完成、会话和活跃陪伴时长增长
支持多角色切换，可通过菜单或 localStorage 设置
可配置尺寸、透明度、游走、休眠超时等，热生效无需重启

whale-girl DSH 插件适合哪些场景

工作间隙与宠物互动，放松心情，观看可爱动画
任务完成或失败时获得视觉反馈，让进度更直观
在 Web 界面角落拥有一个持续陪伴的伙伴，根据你的活动做出反应
通过宠物庆祝升级来获得成就感，激励自己继续工作

whale-girl DSH 插件适合谁

希望在 DSH Web 界面内拥有趣味互动桌面宠物的用户
喜欢在开发/工作环境中加入陪伴元素的开发者或高级用户

whale-girl DSH 插件的限制

仅支持 DSH Web GUI（需通过 `dsh plugin --profile web` 安装并重启）
依赖 DSH 宿主环境和其设置配置（settings.yaml 中的 whale-girl 节）
语义层（经验阈值、称号条件）不可配置，修改会破坏积累账本一致性
默认初始状态下宠物隐藏，需手动启用

whale-girl DSH 插件的仓库 README 摘录

以下文字摘自 whale-girl DSH 插件的上游仓库 vlln/whale-girl 的 README，版权归原作者，仅作引用。

右下角悬浮的积累型伙伴：可拖拽、可投喂/玩耍，陪伴你的工作台脉搏—— 完成任务/会话/活跃陪伴时长积累成资历等级、称号与回忆。 </p> <p align="center"> <img src="https://badgen.net/badge/license/MIT/green" alt="license" /> <img src="https://badgen.net/badge/format/official%20bundle/8257D0" alt="official bundle" /> </p> --- ## 安装官方 **bundle 插件** 格式（仓库根 `package.json` 的 `dsh.bundle` + `dsh.client`）。经官方 profile 管理： ```sh dsh plugin --profile web add "github:vlln/whale-girl#main" # 推荐：git 源一行（构建产物已入库） # 或本地目录：dsh plugin --profile web add <whale-girl 本地路径> ``` 装完 **重启 web**（bundle 层在启动时合成），右下角出现宠物：点击弹出菜单（🍗 喂食 / 🎾 玩耍），拖拽可移动；hover 显示状态条（资历等级/任务数/最近共同回忆）。初始配置/欢迎页（onboarding）宠物隐藏。更新插件时 `dsh plugin --profile web update whale-girl`（或换 git 源 ref），重启生效。 ## 使用 | 你做什么 / 发生什么 | 宠物表现 | |---|---| | 拖拽宠物 | 被斜向拉扯（`drag`） | | 点击菜单 🍗 喂食 / 🎾 玩耍 | 啃咬/抛接球（`eat`/`play`）→ 开心（`joy`） | | 空闲 ≥60s | 打盹（`sleep`）；互动时醒过来（`wake`） | | 任务完成 / 升级 / 称号 / 回合完成 | 举手欢呼（`celebrate`） | | 任务失败 / 请求出错 | 惊吓（`error`）→ 失落（`disappointed`） | | 新会话开始 | 挥手欢迎（`welcome`） | | 任一会话运行/思考中 | 沉思陪伴（`think`，偶尔 `working` 工作姿态） | | 等待批准 | 期待等待（`wait`） | | 周期游走 | 散步（`walk`） | | 常态 | 待机（`idle`，随机眨眼/转身） | 完整状态机（优先级/转换语义/触发源）见 [docs/state-machine.md](docs/state-machine.md)。 ## 状态预览 | 状

阅读完整 README仓库许可: MIT

whale-girl DSH 插件常见问题

如何安装 whale-girl 作为 DSH 插件？

在终端执行 `dsh plugin --profile web add "github:vlln/whale-girl#main"`，然后重启 Web 界面。也可以将仓库克隆到本地，使用 `dsh plugin --profile web add <本地路径>`。重启后，宠物会出现在右下角。

如何更新 whale-girl 到新版本？

运行 `dsh plugin --profile web update whale-girl` 即可拉取最新版本。如果使用 git 源引用，可以更改命令中的 ref。更新后需要重启 Web 界面才能生效。

可以更换宠物的外观吗？

可以，通过菜单中的「🎭 换角色」按钮或设置 localStorage 键 `whale-girl:character` 为角色名来切换不同角色。每个角色都提供完整的 15 种状态动画。你也可以按照 docs/adding-a-character.md 中的指南贡献新角色。

如何配置 whale-girl 的设置？

设置通过 DSH 宿主机的 settings.yaml 文件的 `whale-girl:` 节管理。例如，可以设置 `enabled: true`、`size: 110`、`opacity: 1` 和 `walk.enabled: true`。修改后无需重启 Web 界面即可热生效。也可以通过设置 UI（如果有）进行配置。

安装后宠物没有出现怎么办？

首先确保安装后重启了 Web 界面。检查插件是否启用：在 settings.yaml 中设置 `whale-girl.enabled: true`。宠物在初始配置时是隐藏的，需要手动启用。另外，确认安装命令成功执行，并且插件出现在 `dsh plugin --profile web list` 列表中。