dsh-whale-musume: A Cheerful Whale Girl Desktop Pet Plugin for DeepSeek Harness
sutera-diffusus/dsh-whale-musume
A desktop whale-girl mascot for DeepSeek Harness, keeping you company while coding, with petting, achievements, and local-only operation.
Add a whale girl to your DeepSeek Harness desktop who codes with you, with idle companionship, work linkage, and pet raising, all running locally with no telemetry.
dsh plugin --profile web add github:sutera-diffusus/dsh-whale-musume- Category
- Entertainment
- Platform
- DSH-Plugin
- Author
- sutera-diffusus
- Distribution
- Plugin
dsh-whale-musume Key Features
dsh-whale-musume Repository
dsh-whale-musume Repo Summary
dsh-whale-musume is a desktop mascot plugin (DSH plugin) for DeepSeek Harness, maintained by Sutera-Diffusus under the MIT license, last updated in 2026-08. It solves the lack of companionship and fun while coding: a cheerful whale girl floats on your desktop, quietly accompanying you during idle, and automatically picks up a laptop to work with you when it detects tool activity. You can pet her to raise her, unlock achievements, and drag her around. Core capabilities include 530+ lines of meme chat across all scenarios, time-based greetings and weather companionship (Open-Meteo free, no API key required), work-state linkage, a 4×4 bubble mini-game, 39 achievements, and a bond level system. All resources run locally with no telemetry or external requests.
What core features does the dsh-whale-musume DSH plugin support?
The mascot supports mouse dragging, switching to a "picked up" pose that sways with cursor movement; idle animations include drinking coffee, stretching, and eating. Work-state linkage detects data-running / data-state="ongoing" and switches to "working with laptop" mode with a light blue glow and a "working" label; clicking her triggers reactions like "shyly hugging the computer" or "snacking on memory sticks". Interactions include single-click head pat (blushing pose + heart/star emojis), triple-click (star eyes + particle effects + spin), and a right-click menu (feed, poke, praise, mini-game, reset position, open settings). The mini-game "Bubble Party" is a 4×4 grid with normal/star/bomb bubbles, 30-second rounds with three-tier scoring, supporting both mouse and keyboard controls. The raising system tracks mood, affection, satiety, level, consecutive check-ins, and companionship duration; daily tasks refresh 3 slots automatically, weekly check-ins have milestone rewards at 1/3/7 days, and bond levels Lv3/Lv5/Lv7 unlock new poses, the title "Whale Guardian", and hidden easter eggs.
How to install dsh-whale-musume?
Requirements: Windows 10/11, Node.js 18+, DeepSeek Harness 0.1.0-rc.6 or similar, and latest Edge/Chrome. The recommended way is via the DSH plugin market:
dsh plugin --profile web add github:sutera-diffusus/dsh-whale-musume
Alternatively, download the zip from Releases and extract, or clone the repo and run the install scripts:
git clone https://github.com/Sutera-Diffusus/dsh-whale-musume.git
cd dsh-whale-musume
node scripts/apply-theme.mjs --assets-only --target "<DSH_INSTALL_DIR>"
node scripts/apply-theme.mjs --mascot-settings --target "<DSH_INSTALL_DIR>"
The install script modifies DSH frontend assets with built-in backup; it's recommended to close DSH pages and note the version before installing.
How to configure and use dsh-whale-musume?
Settings are integrated into the DSH settings page, with capsule toggles for mascot, speech bubble, particle effects, mini-game, keyword awareness, slacking reminder, night mode, and weather effects. Weather companionship requires entering a city in settings (optional API key); Open-Meteo is free without a key, and leaving the city blank means zero network usage. Raising data is displayed as horizontal cards; today's tasks, weekly check-in, and title cards are managed alongside the achievement wall. All changes are backup-able and rollback-able; resource files are versioned and cache is force-refreshed after upgrades.
How does dsh-whale-musume ensure data and privacy?
The plugin is pure frontend injection, does not modify DSH business DOM, and all resources run locally with no telemetry or external requests. Weather only connects when a city is filled, using the free Open-Meteo service. The core state machine is separated from the presentation layer for easy secondary development.
Which DeepSeek Harness versions and platforms are compatible with dsh-whale-musume?
The plugin targets DeepSeek Harness 0.1.0-rc.6 or similar versions, supports Windows 10/11, and requires the latest Edge/Chrome. It is maintained by Sutera-Diffusus under the MIT license, last updated in 2026-08.