DSH桌面宠物插件

whale-girl

DSH Web GUI 的桌面宠物插件（QQ 宠物形态）：右下角悬浮、可拖拽/投喂/玩耍的积累型伙伴。

📖 介绍

whale-girl 是一个为 DeepSeek Harness Web GUI 设计的桌面宠物插件，由 vlln 创建维护。它在页面右下角放置一个持久化的鲸鱼娘伙伴，支持拖拽、投喂、玩耍等交互。完成的任务、会话和陪伴时间会积累为资历等级、头衔和记忆。

项目采用官方 bundle 插件格式（dsh.bundle + cordis.patch.yml），是 DSH 插件开发的参考实现。GitHub 星标 312，MIT 开源协议，已有 5 位贡献者参与。

✨ 亮点

1. 完整状态机：15 种状态（idle、working、celebrate、error、disappointed、joy、eat、play、drag、walk、sleep、wake、welcome、think、wait）
2. 积累型成长：任务完成、会话时间积累为资历等级和头衔
3. 记忆系统：共享记忆随互动积累
4. 桌面伴侣：可选的 Tauri 桌面应用，宠物常驻 OS 桌面
5. 角色切换：支持多角色切换，每个角色都有完整的 15 种状态动画
6. 设置面板：DSH 设置页直接配置大小、透明度、漫游、投喂/玩耍回复池等
7. 参考实现：官方 bundle 插件格式的完整示例，适合学习插件开发

🎯 核心功能

📦 安装方式

DSH 插件安装（推荐）：

dsh plugin --profile web add "github:vlln/whale-girl#main"
# 或 npm 源
dsh plugin --profile web add whale-girl@0.1.0

安装后重启 dsh web，宠物出现在右下角。

桌面伴侣（可选）：

npm install -g whale-girl-desktop
whale-girl-desktop --headless
# 首次构建 Tauri 壳（约 5-15 分钟）
cd "$(npm root -g)/whale-girl-desktop/src-tauri" && cargo build --release
./target/release/whale-girl-desktop

🎭 状态预览

📊 技术栈

• 语言：JavaScript 91.8% + Python 6.3% + Rust 1.3%
• 桌面壳：Tauri v2（推荐，约 12MB）
• 协议：MIT
• 贡献者：5 人

📝 总结评价

whale-girl 是一个非常有创意的 DSH 插件，它把 QQ 宠物的概念带到了 AI 开发环境中。15 种完整状态动画、积累型成长系统、记忆机制，让这个小宠物不只是装饰，而是一个有"生命"的伙伴。桌面伴侣模式通过 Tauri 实现了跨平台常驻，设计很优雅。作为 DSH 官方 bundle 插件格式的参考实现，它的代码结构和约定（决策记录、门禁、资产合约）也值得插件开发者学习。

GitHub： https://github.com/vlln/whale-girl
Stars： 312 ⭐