@luweiyabo/dsh-whale-pet
A floating whale desktop pet for the DeepSeek Harness Web UI: 94 categorized animations, event-aware actions, custom uploads, click reactions, dragging and screen wandering.
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:luweiyabo/dsh-whale-pet说明文档
阅读完整 README ↗如何使用
基础交互
| 操作 | 效果 |
|---|---|
| 悬停 | 宠物朝向光标所在一侧，移开后恢复原朝向；拖拽或惯性滑行期间不生效 |
| 单击宠物 | 根据头部、身体或尾部区域播放不同回应，并切换选中状态；选中后点击页面可让宠物前往目标位置 |
| 双击宠物 | 播放“蓝鲸现世”特殊动画并取消选中状态 |
| 拖拽 | 移动并放置宠物；快速甩动后会惯性滑行，系统启用“减少动态效果”时不滑行 |
| 完全拖出屏幕 | 宠物进入边缘隐藏状态；将指针移到对应屏幕边缘可露出召回区域 |
| 右键宠物 | 打开快捷菜单：回家、打开设置或隐藏 |
打开设置
进入 设置 → 插件 → 鲸鱼桌宠，可以调整：
- 显示、文字气泡和账户余额气泡
- 宠物尺寸、默认角落和会话感知范围
- 安静、均衡、活泼三档自主活跃程度
- 工作、编码、阅读、搜索、思考、等待、倾听和错误等意图对应的动作
- 自主动作、移动动作和点击回应动作池
- 自定义动作上传、预览和删除
- 自定义事件触发规则
所有设置会自动保存并即时生效，无需重启。
动作配置
完整内置动作见动作展示。动作选择器会跟随 Harness 语言显示中文或英文名称，并支持按分类、英文 ID 或中英文名称搜索；内置动作与用户上传动作都可以加入自主动作池、绑定事件意图或用于触发规则。
配置与数据
插件设置保存在 DSH 的 whale-pet 设置命名空间，自定义动画保存在 $DSH_HOME/whale-pet/actions/。插件不会把动画、设置或 API Key 上传到本项目维护者的服务器。
常用环境变量：
| 环境变量 | 用途 |
|---|---|
DSH_HOME | 指定 DSH 数据目录；未设置时使用 DSH 默认目录 |
DEEPSEEK_API_KEY | DeepSeek 余额查询凭据来源之一 |
MOONSHOT_API_KEY | Moonshot 余额查询凭据来源之一 |
STEPFUN_API_KEY | StepFun 余额查询凭据来源之一 |