yuxino/dsh-blue-whale-maid
31Last commit Aug 15, 2026
dsh-blue-whale-maid DSH plugin
dsh-blue-whale-maid brings the Blue Whale Maid character into your DSH web interface. It accompanies tasks, alerts you on completion, failure, or pending confirmation using animated bubbles and gestures. The pet remembers its position and can be clicked, double-clicked, or dragged around.
How to install the dsh-blue-whale-maid DSH plugin
dsh plugin --profile web add github:yuxino/dsh-blue-whale-maidCopying does not run this command. Review the repository and version before installing the dsh-blue-whale-maid DSH plugin.
dsh-blue-whale-maid DSH plugin data source
dsh-blue-whale-maid DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-blue-whale-maid DSH plugin can do
- Displays animated alerts for task completion, failure, and pending confirmation
- Occasionally announces current task and command
- Responds to click (wave), double-click (jump), and drag (move) with position memory
- Allows jump-to-session from completion notifications
Where the dsh-blue-whale-maid DSH plugin fits
- Get visual feedback when a long-running task finishes
- Receive immediate attention on task failure without refreshing the page
- Use the pet as a fun, interactive status indicator during work
- Quickly navigate to the relevant session by clicking the notification
Who the dsh-blue-whale-maid DSH plugin is for
- DSH web users who want a more engaging task monitoring experience
- Users who enjoy customizable desktop pets in their development tools
dsh-blue-whale-maid DSH plugin limitations
- Only works in the DSH web profile (dsh web), not in terminal mode
- Requires a restart of dsh web after installation to take effect
- Pet visibility depends on browser support for CSS animations and notifications
dsh-blue-whale-maid DSH plugin: from the repository README
Quoted from the yuxino/dsh-blue-whale-maid README, the upstream source of the dsh-blue-whale-maid DSH plugin. Copyright remains with the original authors.
- 任务完成 / 失败 / 等待确认时，用动画和气泡提醒 - 工作中偶尔播报当前任务和命令 - 单击挥手、双击跳跃、拖动移动，位置会记住 - 完成提醒可直接跳到对应会话 ## 安装 ```sh dsh plugin --profile web add github:yuxino/dsh-blue-whale-maid ``` 重启 `dsh web` 后刷新页面即可。 悬停宠物可临时隐藏；卸载： ```sh dsh plugin --profile web remove dsh-blue-whale-maid ``` ## 开发 ```sh node tools/embed.mjs ``` `src/client.template.js` 是源码模板，命令会把精灵图内联到 `lib/client.js`。 ## Credits 蓝鲸女仆美术与元数据来自 [codex-pets.net](https://codex-pets.net/#/pets/blue-whale-maid)，原作者 **simashui**。代码使用 MIT；素材不属于 MIT 范围。详见 [CREDITS.md](./CREDITS.md)。
Read the full READMERepository license: NOASSERTION
dsh-blue-whale-maid DSH plugin questions
How do I install the Blue Whale Maid plugin?
Run the command `dsh plugin --profile web add github:yuxino/dsh-blue-whale-maid` in your terminal. After installation, restart `dsh web` and refresh the browser page to see the pet.
How do I uninstall the Blue Whale Maid?
Use the command `dsh plugin --profile web remove dsh-blue-whale-maid` to remove the plugin. Then restart `dsh web` to fully clear it from the interface.
Can I temporarily hide the pet without uninstalling?
Yes, hovering over the pet will temporarily hide it. It will reappear when you move the mouse away. This is a convenient way to get it out of the way without removing the plugin.
Why isn't the pet showing up after installation?
Make sure you restarted `dsh web` after adding the plugin. Also, the pet only works in the web profile, not in the terminal. If it still doesn't appear, refresh the browser page or check for any JavaScript errors in the console.
Does the pet remember its position across sessions?
Yes, the plugin remembers the position you dragged the pet to. It will appear at the same location the next time you open the DSH web interface. This is stored in the browser's local storage.