Skip to content
  • Home
  • Plugin manual
  • dsh-whale-pet

aceice01/dsh-whale-pet

30Last commit Aug 15, 2026

dsh-whale-pet DSH plugin

This plugin adds a cute whale girl desktop pet to DeepSeek Harness (DSH). It features idle, working, happy, and coquetry animations with pre-synthesized Xiaoyi neural voice, supports interactive actions like poking and head-patting, and provides task completion reminders. It also includes a balance badge showing DeepSeek account balance and a recharge link.

ui-productivity

How to install the dsh-whale-pet DSH plugin

dsh plugin --profile web add github:aceice01/dsh-whale-pet

Copying does not run this command. Review the repository and version before installing the dsh-whale-pet DSH plugin.

dsh-whale-pet DSH plugin data source

dsh-whale-pet DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-whale-pet DSH plugin can do

  • Display a whale girl pet with transparent background and multiple state animations (idle, working, completed, error, coquetry, jump).
  • Play pre-synthesized Xiaoyi neural voice from 49 lines, completely offline.
  • Interactive reactions: poke (random response), long-press for head-patting, double-click to mute, right-click menu, triple-click for TTS diagnostic panel.
  • Task reminders: completion (jump+confetti+arpeggio+voice), error comfort, approval prompts, progress announcements.
  • Volume control with separate sliders for total, voice, sound effects, and celebration; settings persist.
  • Drag the pet window (desktop) or hold the whale girl to drag the overlay (web).
  • Balance badge in session header showing DeepSeek account balance, auto-refreshes every minute, with click-to-recharge link.
  • Supports both desktop (Electron overlay window) and web (browser overlay) modes.

Where the dsh-whale-pet DSH plugin fits

  • Enjoy a cute desktop pet while working with DeepSeek Harness.
  • Quickly check your DeepSeek account balance without leaving the chat interface.
  • Get notified of task completion, errors, or approvals with voice and animation.
  • Customize the pet's voice lines and animations using provided tools.
  • Use the web version to have the pet appear in a browser-based DSH session.

Who the dsh-whale-pet DSH plugin is for

  • Developers and users of DeepSeek Harness who want a desktop pet.
  • Fans of anime-style virtual pets and interactive desktop companions.

dsh-whale-pet DSH plugin limitations

  • Only supports Windows operating system.
  • Requires DeepSeek Harness (desktop client or npx dsh) to be installed.
  • Voice playback requires a first-time click on the pet to unlock AudioContext (browser autoplay policy).
  • The desktop version may need a main.js patch to close the pet window when the main client closes.
  • The character art is a fan-made non-official asset, not affiliated with DeepSeek.

dsh-whale-pet DSH plugin: from the repository README

Quoted from the aceice01/dsh-whale-pet README, the upstream source of the dsh-whale-pet DSH plugin. Copyright remains with the original authors.

> ⚠️ **免责声明** > > 这是一个**非官方同人项目**，与 DeepSeek 官方（深度求索）**无隶属或背书关系**。 > 本项目**不用于商业用途**。角色素材版权归原作者所有（见文末致谢）， > 使用 DeepSeek 品牌名称仅为指明所适配的工具，不构成任何官方授权或关联。 --- ## ✨ 功能 | 功能 | 说明 | |---|---| | 🐋 同人形象 | DeepSeek 鲸鱼娘同人动画（透明背景，已去绿幕/品红残留） | | 🎞️ 状态动画 | 待机 / 工作 / 完成 / 出错 / 撒娇 / 跳跃，待机变体轮换 | | 🗣️ 晓伊语音 | 神经网络人声，49 条台词预合成，完全离线播放 | | 🥰 互动 | 戳一戳随机反应 · 长按摸头 · 双击静音 · 右键菜单 · 三击诊断 | | 📢 提醒 | 任务完成（跳跃+纸屑+琶音+语音）· 出错安慰 · 审批提示 · 进度播报 | | 🎛️ 音量 | 总音量 + 语音/音效/庆祝分动作音量（持久保存） | | 🖱️ 拖动 | 桌面版全身拖动 · Web 版按住鲸鱼娘拖动 | 支持 **两种形态**： - 🖥️ **桌面版**：DSH Desktop（Electron）右下角独立透明置顶小窗 - 🌐 **Web 版**：浏览器访问 `dsh --profile web` 时，页面右下角悬浮层 ## 💰 附带功能：余额徽章 + 充值入口 插件还包含一个**会话头部余额徽章**（`/api/balance` 代理官方接口）： | 功能 | 说明 | |---|---| | 💰 余额显示 | 会话头部显示 DeepSeek 账户余额（如 `余额 ¥12.34`），每分钟自动刷新 | | 🔄 点击刷新 | 点击徽章立即刷新余额 | | ⚡ 充值入口 | 徽章旁的 **"充值"** 链接，一键跳转 DeepSeek 开放平台充值页 | | 🔒 安全 | API Key 只在服务端使用，**不会传到浏览器**（通过 `credentialRef` 解析） | | 🛡️ 容错 | 网络失败时保留上次余额并标记 `stale`，不闪断 | > 余额徽章默认随插件一起启用；不需要的话可在 `cordis.patch.yml` 中移除 > `client.js` 的注入，或保持插件但忽略徽章（不影响桌宠功能）。 ## 📦 安装 ### 要求 - **Windows** - 已安装 **DeepSeek Harness 桌面客户端** 和/或 **npx 版 dsh** ### 方式一：DSH 插件命令（推荐，自动激活） ```powershell dsh plugin --profile web add github:aceice01/dsh-

Read the full READMERepository license: NOASSERTION

dsh-whale-pet DSH plugin questions

How do I install the whale pet plugin?

Run the command `dsh plugin --profile web add github:aceice01/dsh-whale-pet` in PowerShell. If you don't have the dsh command, use `npx @deepseek-ai/dsh plugin --profile web add github:aceice01/dsh-whale-pet`. After installation, restart the DSH desktop app or dsh web service.

How do I uninstall the plugin?

You can use the one-click install script with the `-Uninstall` flag: `powershell -ExecutionPolicy Bypass -File install.ps1 -Uninstall`. This will remove the plugin from both desktop and web profiles and restore original files from backup.

The pet doesn't appear after installation. What should I do?

First, make sure the installation script output shows `[OK]` for all steps. Then restart the DSH desktop app or dsh web service completely. Check that `cordis.patch.yml` contains `balance-widget`. For the web version, force refresh the browser with Ctrl+F5.

Why is there no voice sound from the pet?

You need to click on the pet at least once to unlock the AudioContext (browser autoplay policy). Also check the volume sliders in the right-click menu – make sure total volume, voice, and sound effects are all above zero. For the web version, ensure iframe is not blocked by ad blockers.

Can I customize the pet's voice lines?

Yes. You need Python 3.9+ and Node.js. Edit the `LINES` list in `tools/synth_all.py`, then run `python tools/synth_all.py` and `node tools/build-pet.mjs`. Finally reinstall the plugin with `install.ps1`. The voice uses Xiaoyi (edge-tts) by default, but you can change the voice via the `PET_VOICE` environment variable.