MIT-licensed DSH desktop pet plugin, installed as an official bundle via `dsh plugin --profile web add` and rendered in the bottom-right corner of the DSH Web GUI.
DSH integration
Compatible
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-21
License
MIT
01What can it help you accomplish?
Add a persistent desktop pet companion to the DeepSeek Harness Web GUI
A draggable, feedable, playable pet floating bottom-right, with animated states that react to sessions, tasks and approvals
DSH Web GUI users who want a fun resident companion while running agent sessions
Grow a companion that accrues seniority across your DSH usage
Seniority levels, titles and memories accumulated from completed tasks, sessions and companionship time
Long-term DeepSeek Harness users who want their usage history reflected in a companion
Keep the whale girl resident on your OS desktop, outside the browser
A standalone companion app (Node engine + Tauri shell) that stays on the desktop, connected to a local or remote DSH
Users who want the pet on their OS desktop instead of the DSH web page
02How to install into DeepSeek Harness
Prerequisites
- DeepSeek Harness (dsh) with the web profile — the plugin is managed via `dsh plugin --profile web`
- Optional desktop companion: Node ≥18 and Rust (cargo) for the Tauri rendering shell
Installation steps
- 01
Run `dsh plugin --profile web add "github:vlln/whale-girl#main"` (single-line git source, build artifacts committed)
$ dsh plugin --profile web add "github:vlln/whale-girl#main"
- 02
Alternative sources: `dsh plugin --profile web add whale-girl@0.1.0` (npm) or `dsh plugin --profile web add <path-to-whale-girl>` (local directory)
$ dsh plugin --profile web add whale-girl@0.1.0
- 03
Restart web — bundle layers compose at startup
- 04
Optional desktop companion: `npm install -g whale-girl-desktop`, run `whale-girl-desktop --headless` or build the Tauri shell via `cargo build --release` in `src-tauri`
$ npm install -g whale-girl-desktop
- 05
Update via `dsh plugin --profile web update whale-girl` (or switch the git ref), then restart
$ dsh plugin --profile web update whale-girl
Verify the integration
- After restarting web, 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)
03DSH integration and capability boundaries
Official DSH bundle plugin installed via the `dsh plugin --profile web` CLI and rendered inside the DSH Web GUI
Event-driven pet state machine
DSH session / task events (task done, failure, approval, new session, idle ≥60s)→15 animated states — celebrate, error, disappointed, joy, eat, play, drag, walk, sleep, wake, welcome, think, working, wait, idle
Accrual-based growth (seniority, titles, memories)
Completed tasks, sessions and companionship time→Seniority levels, titles and shared memories shown in the hover status bar
XP / title thresholds are sealed and not configurable, to protect the accumulation ledgerLive configuration & character switching
`whale-girl:` section in `<dshHome>/settings.yaml` (or the settings UI); `whale-girl:character` in localStorage→Size / opacity / wandering / sleep toggles applied live without restart; cycling between characters
Setting `enabled: false` disables the in-page pet while a desktop companion runsStandalone desktop companion (optional)
whale-girl's public endpoints (`/state`, `/events`, `/presence`, `/interact`, `/config`, `/assets`)→Transparent always-on-top desktop pet connected to a local or remote DSH (Tauri v2 shell ~12MB, legacy Electron shell kept)
Not installed via `dsh plugin` — enabled manually (npm global install + cargo build)The in-page pet hides while the companion runs (presence contract) and returns after exit/crash (TTL 45s)
04Who is it for? When not to use it?
Good for
- DSH Web GUI users who want a fun resident companion while running agent sessions
- Long-term DeepSeek Harness users who want their usage history reflected in a companion
- Users who want the pet on their OS desktop instead of the DSH web page
Not for
- The optional desktop companion requires Node ≥18 plus Rust (cargo), and the first Tauri build takes about 5–15 minutes; it is not installed via `dsh plugin`.
05Compatibility, maintenance and safety notes
- The optional desktop companion requires Node ≥18 plus Rust (cargo), and the first Tauri build takes about 5–15 minutes; it is not installed via `dsh plugin`.
- Growth semantics (XP and title thresholds) are sealed and not configurable — changing them would break the accumulation ledger.
- The in-page pet lives only in the DSH Web GUI and is hidden on onboarding pages; while the desktop companion runs, the in-page pet hides (presence contract).
MIT · actively maintained (last push 2026-08-18)
06Frequently asked questions
How do I install whale-girl into DeepSeek Harness?
It is an official bundle plugin managed via the official profile: run `dsh plugin --profile web add "github:vlln/whale-girl#main"` (or the npm source `whale-girl@0.1.0`, or a local directory), then restart web. The pet appears bottom-right once the bundle layers compose at startup.
Is it a native DSH plugin or an MCP server?
Neither MCP nor an external tool — it ships in the official bundle plugin format (`dsh.bundle` + `dsh.client` in root `package.json`) and renders directly inside the DSH Web GUI.
What do I need for the standalone desktop companion?
It is optional and not installed via `dsh plugin`: you need Node ≥18 and Rust (cargo) for the Tauri shell (first build ~5–15 min). It talks to whale-girl's public endpoints and defaults to local DSH on port 3080, or `WHALE_GIRL_BASE_URL` for a remote DSH.
Where does the growth data come from, and can I tune it?
Seniority levels, titles and memories accrue from completed tasks, sessions and companionship time. The semantic layer (XP / title thresholds) is sealed and not configurable, because changing it would break the accumulation ledger.
How do I configure size, opacity or wandering?
Edit the `whale-girl:` section in `<dshHome>/settings.yaml` (or the settings UI) — changes apply live with no restart. Characters can be cycled with the 🎭 button or `whale-girl:character` in localStorage.
07Related DSH workflows
dsh-pet
by pc2005-cloud
DSH Web 界面桌面宠物：51 个透明 webm 动画随机链播、屏幕漫游、点击/拖拽；附提示词配方+AI 视频素材生成链可自造宠物
dsh-dafeiyu
by qcytsn
Desktop-native BigFish companion for DeepSeek Harness — real Agent status, always on top on Windows.
dsh-tavern
by flizzywine
SillyTavern 类文字游戏 Agent：候选项生成、对话式人物卡编辑、剧本模板。
dsh-kun-like-pet
by liyupi
桌面宠物「小坤宠」：Web 界面右下角随 Agent 工作状态切换 9 种动画，任务完成播放「你干嘛~哎哟」音效；host 状态机 + client shell.overlay 渲染 + 拖动/点击互动。
08Data and sources
Official **bundle plugin** (`dsh.bundle` + `dsh.client` in root `package.json`), managed via the official profile:
dsh plugin --profile web add "github:vlln/whale-girl#main" # single-line git source (build artifacts committed)
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.