whale-girl: A QQ-Pet-Style Desktop Companion for DeepSeek Harness
vlln/whale-girl
whale-girl is a DSH Web GUI desktop pet plugin in QQ-pet style, floating bottom-right, draggable, feedable, and playable, accruing seniority, titles, and memories from tasks and companionship.
whale-girl is a desktop pet plugin for DeepSeek Harness, appearing as a QQ-pet-style companion floating at the bottom-right of the Web GUI. It turns completed tasks, session time, and companionship into seniority levels, titles, and memories, making long DSH sessions more playful and rewarding. It supports dragging, feeding, playing, and a state-machine-driven animation system with 15 states. An optional standalone desktop companion app keeps the pet resident on your OS desktop, interacting via public endpoints.
How to Install
dsh plugin --profile web add whale-girl- Category
- Entertainment
- Platform
- DSH Plugin
- Author
- vlln
- Distribution
- Plugin
whale-girl Key Features
whale-girl Repo Summary
What Does It Do?
whale-girl is a DSH plugin for DeepSeek Harness that brings a QQ-pet-style desktop companion to the Web GUI, floating at the bottom-right corner. It solves the lack of playful feedback during long DSH sessions by turning completed tasks, sessions, and companionship time into seniority levels, titles, and memories. Core capabilities include dragging, feeding, playing, a state-machine-driven animation system, and an optional standalone desktop companion app.
Core Features
- Persistent companion: tasks, sessions, and companionship time accrue into seniority levels, titles, and memories.
- Rich state machine: 15 states triggered by user actions and events, such as drag, eat, play, sleep, celebrate, error, welcome, think, wait, and more.
- Live configuration: adjust pet size and enable toggle via settings file or UI, changes apply instantly without restart.
- Optional desktop companion: a standalone app (Node + Tauri) keeps the pet on your OS desktop, interacting via public endpoints without touching the plugin.
How to Use This Plugin?
After enabling it in DSH, the pet appears at the bottom-right; click for a menu to feed (🍗) or play (🎾), drag to move, and hover for a status bar showing seniority level, task count, and recent shared memories. Restart the web client after installation for the bundle to take effect. To adjust size or enable state, edit the whale-girl section in settings.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: vlln/whale-girl. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.