whale-girl

项目详情摘要

中文 | English whale-girl A desktop pet in the DSH Web GUI (QQ-pet style) A persistent companion floating bottom-right: draggable, feedable, playable — completed tasks, sessions, and companionship time accrue into seniority levels, titles, and memories. Installation Official **bundle plugin** (`dsh.bundle` + `dsh.client` in root `package.json`), managed via the official profile: Restart web** after installing (bundle layers compose at startup); the pet appears bottom-right: click for its menu (🍗 feed / 🎾 play), drag to move, hover for the status bar (seniority level / task count / recent shared memories). Hidden on onboarding pages. Update via `dsh plugin --profile web update whale-girl` (or switch the git ref), then restart. Usage You / event | Pet behavior | Drag the pet | Stretched diagonally (`drag`) | Menu 🍗 feed / 🎾 play | Chomping / ball toss (`eat`/`play`) → joy (`joy`) | Idle ≥60s | Naps (`sleep`); wakes on interaction (`wake`) | Task done / level-up / title / round done | Cheers (`celebrate`) | Task failed / request error | Startled (`error`) → disappointed (`disappointed`) | New session | Waves welcome (`welcome`) | Session running / thinking | Pensive company (`think`, occasional `working`) | Awaiting approval | Expectant waiting (`wait`) | Periodic wandering | Walking (`walk`) | Default | Idle standby (`idle`, random blinks / turns) | Full state machine (priorities / transitions / triggers): docs/state-machine.md. Desktop Companion (Optional) `desktop/` is a **standalone companion app** (Node engine + Tauri shell, zero runtime deps) that keeps the whale girl resident on your OS desktop. **Not installed via `dsh plugin`** — enable it yourself: Uses whale-girl's public endpoints (`/state`, `/events`, `/presence`, `/interact`, `/config`, `/assets`) **without tou