dsh-whale-pet: A Whale Girl Mascot for DeepSeek Harness Web GUI
zuishi2006-pixel/dsh-whale-pet
Adds a whale-girl desktop pet to the DeepSeek Harness Web GUI, reacting to Agent states and playing voice on task completion.
dsh-whale-pet is a desktop pet plugin for the DeepSeek Harness Web GUI, placing a Whale Girl in the bottom-right corner that switches animations based on Agent state. Driven by a state machine, it gives users visual feedback on task progress, waiting, and completion, with a celebration voice on task completion. The plugin supports dragging, muting, and respects reduced-motion settings, with all assets loaded locally and no external requests. Ideal for developers who want to add fun and visual feedback to their DSH workflow.
How to Install
dsh plugin --profile web add github:zuishi2006-pixel/dsh-whale-pet- Category
- Entertainment
- Platform
- DSH Plugin
- Author
- zuishi2006-pixel
- Distribution
- Plugin
dsh-whale-pet Key Features
dsh-whale-pet Repo Summary
What Does It Do?
Whale Girl Desktop Pet is a DSH plugin for DeepSeek Harness that adds a mascot to the bottom-right corner of the Web GUI, reacting to the Agent's working state. It solves the lack of visual feedback during Agent runs, letting users intuitively see task progress, waiting, and completion. Core capabilities include state-machine-driven animations, celebration voice on task completion, draggable and mute controls, all assets loaded locally with no external requests.
Core Features
- State-machine driven: switches Whale Girl animations (working, waiting, celebrating, success, idle) based on Agent's running, pendingInteraction, completed states.
- Task completion celebration: edge detection plays a random celebration voice (10 lines) only once, no repeated spamming.
- Voice interaction: greets on first appearance, random coquetry voice on click, mute toggle via the speaker icon.
- Draggable and reduced-motion aware: the pet can be dragged, and respects prefers-reduced-motion to reduce animations.
- Non-invasive integration: injected via the official shell.overlay slot, no business DOM changes, assets loaded locally with no telemetry.
How to Use This Plugin?
After enabling it in DSH, refresh the web page to see the Whale Girl at the bottom-right corner. It will automatically switch animations based on Agent state and play a celebration voice when tasks complete. To adjust animations or sprites, modify IMAGES and deriveState in lib/client.js; to replace voices, simply replace the assets/voice-*.mp3 files.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: zuishi2006-pixel/dsh-whale-pet. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.
DSH Plugin FAQ
