DSH Marketplace

whale-girl

vlln/whale-girl

Desktop pet (QQ-pet style): floats in the corner, draggable, feedable, playable.

37720JavaScriptMITSource

Install

Add whale-girl to DeepSeek Harness

Install into

via npm

Resolves a published tarball rather than cloning the repository, and installs without any extra setup. Swap `web` for your profile name if you run another one.

via GitHub · npm package

Installing from GitHub runs the project's build script, which pnpm blocks until you allowlist it — run the command once and pnpm prints the exact key to add under `allowBuilds` in ~/.dsh/profiles/web/pnpm-workspace.yaml.

What happened when we ran it

Installed cleanly when we ran it

Every command here is run in a throwaway container against a clean profile, and the result is whatever the harness recorded — not a guess from the source. Last run 11d agoon DeepSeek Harness 0.2.2-rc.1.

Show it in your README

install verified — dshmarketplace

For maintainers: the badge serves this listing's latest sandbox verdict, so a re-run updates it on its own — and it links readers to the full result here.

Due diligence

Before you install whale-girl

  • Source of record: vlln/whale-girl — present in the community registry that DSH's own plugin market installs from.
  • Licensed under MIT.

Security

What installing whale-girl runs

Build scripts

No build script was blocked in our run.

Source: our sandbox install on DeepSeek Harness 0.2.2-rc.1, 11d ago.

Install hooks

package.json declares no preinstall, install or postinstall script.

Source: package.json on GitHub, read at our last sync. prepare is not recorded; it runs only on a GitHub install, and shows up under build scripts when pnpm blocks it.

README mentions

shell commands (bash, exec, spawn …)

Source: a keyword match on the README — a hint about what the plugin touches, not an analysis of its code.

Not an audit. These are the record of one install and two text scans; nobody has read this plugin's code on your behalf. Plugins run with your agent's permissions.

The AI take

What it is — This is a QQ-pet style desktop companion plugin running in the DeepSeek Harness Web GUI. It floats in the bottom-right corner, supports dragging, feeding via menu, playing, and updates status based on tasks and sessions.

Who it is for — If you work in the DeepSeek Harness web interface and need a floating pet companion to track task progress, this plugin suits you. It is not for developers who prefer standalone local desktop apps.

Watch out — It executes shell commands during installation. Sandbox testing passed, registering successfully in a fresh profile. No obvious compatibility issues found.

The verdict — I would install it if you are already using the DeepSeek Harness web GUI, because it provides an interactive way to record progress.

Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.

What whale-girl does

A floating figure flows through event states into interaction, growth, and desktop-rendering paths.

whale-girl is a DeepSeek Harness plugin that adds a draggable desktop pet to the DSH web interface.

It is delivered as an official bundle through the web profile and appears in the lower-right corner after the web interface restarts. The pet reacts to harness activity: it welcomes new sessions, accompanies thinking and running sessions, waits for approval, celebrates completed tasks and rounds, and shows error or disappointed states after failures. It also tracks accumulated experience from tasks, sessions and active companion time, exposing levels, titles and recent shared memories. Clicking the pet opens feeding and play actions; hovering shows its status, and dragging moves it. The host settings section whale-girl: controls the web rendering, size, opacity, walking and sleep timing.

This is intended for developers who want an in-interface companion and a visible, persistent progress layer around agent work. It is the wrong choice when an unobtrusive workspace is required, or when a separate desktop pet is already running: the optional desktop/ companion renders the same character outside the web interface and can otherwise result in two pets. That companion is not installed by dsh plugin; it uses a Node engine with a Tauri rendering shell and consumes the plugin’s public endpoints. The web pet is initially hidden during onboarding.

whale-girl documentation

How it behaves

The web pet is hidden during initial configuration and onboarding. Once visible, it uses activity from the harness interface to change state:

Event State
New session welcome
Session running or thinking think, occasionally working
Waiting for approval wait
Task, upgrade, title or round completion celebrate
Task failure or request error error, then disappointed
No activity for at least 60000 ms sleep
Interaction while sleeping wake
Feeding or playing eat or play, then joy

It also cycles through idle and walk, and shows random blinking or turning while idle. The state machine’s full priorities and transitions are documented in docs/state-machine.md.

Configuration

Settings are read from the host settings UI or the whale-girl: section in <dshHome>/settings.yaml. Changes take effect without a restart.

Key Default Meaning
enabled true Enables web rendering
size 110 Pet size in px; accepted range is 64–160
opacity 1 Normal opacity; accepted range is 0.2–1
walk.enabled true Enables periodic walking
sleepAfterMs 60000 Idle time before sleeping

The experience and title semantics are not configurable. The character can be changed from the character menu or through localStorage key whale-girl:character.

Commands and desktop companion

dsh plugin --profile web update whale-girl updates the installed plugin; a web restart is required for the bundle change to take effect. The separate desktop/ application is not installed by dsh plugin. From that directory, npm install prepares the application, while cd src-tauri && cargo run starts the recommended Tauri shell. npm run start:headless starts its headless mode.

The companion uses the plugin endpoints /state, /events, /presence, /interact, /config and /assets. When it is active, the web pet hides through the presence contract; after exit or a 45s presence TTL expiry, the web pet returns.

Written from the project's own documentation and kept in sync with it. Where the two disagree, the source is authoritative — read the README on GitHub

Same category

Alternatives to whale-girl

dsh-pet

zhu1090093659

10k

A whale-girl companion for the dsh web GUI: animations follow the agent state, with pat interactions and a feeding mechanic that raises intimacy from a calf to deep-sea bonds.

No one-line install — this plugin lives inside a larger repository and publishes no npm package.

GitHub sourceTypeScript2d ago

AI review

dsh-pet

What it is — dsh-pet is a whale-girl companion plugin for the DeepSeek Harness Web GUI, featuring animations that follow agent state changes with pat interactions and a feeding mechanic that raises intimacy from a calf to deep-sea bonds.

Who it is for — If you execute AI agent tasks in the DeepSeek Harness Web GUI and need a companion that reacts to agent state, dsh-pet is suitable. If you use the DSH Desktop rather than the Web GUI, you do not need to install this plugin.

Watch out — Sandbox testing passed: it was successfully installed in a fresh profile and registered by harness. No obvious issues were found.

The verdict — I would install it because the feeding mechanic raises intimacy from a calf to deep-sea bonds, adding value when agent state visualization is required in your tasks.

Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.Read the source
1Details

dsh-pet

PC2005-cloud

1.9k

Desktop pet for the DSH Web UI on Windows, macOS and Linux: 106 transparent animations in the browser overlay or a transparent always-on-top desktop window, throw-and-bounce drag physics with squash and particle scoring, a work-status bubble driven by live session events, self-talk and chat with persistent memory, balance display, meme-image bubbles, multiple pets on screen, and drop-in custom animations and pet packs.

Installed cleanly when we ran it

npm packageTypeScript29d ago

AI review

dsh-pet

What it is — Desktop pet plugin for DeepSeek Harness providing transparent animations and physics interactions.

Who it is for — When using DeepSeek Harness in live session events, people who need work-status bubble are suitable for installing this plugin. If not running on Windows, macOS and Linux, you can skip installing this plugin.

Watch out — Sandbox test passed. Installed in a new profile and registered by harness. No obvious issues found.

The verdict — I would install it because it supports both browser and desktop display modes.

Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.Read the source
Details
1.5k

Installs, updates, and switches to a separate DSH Tavern profile on official DeepSeek Harness Desktop for Windows and macOS. Forked from 2NF/dsh-profile-bridge (MIT); install this launcher or the upstream plugin, not both — they claim the same /profile-bridge channel.

No one-line install — this plugin lives inside a larger repository and publishes no npm package.

GitHub sourceJavaScript10d ago

AI review

dsh-profile-bridge

What it is — Maintains a separate DSH Tavern profile on official DeepSeek Harness Desktop for Windows and macOS, then flips the app onto it.

Who it is for — You already run agent work inside official DeepSeek Harness Desktop on Windows or macOS, with whatever model you already use, and you need SillyTavern character-card sessions without discarding that Desktop setup. The CLI host keeps its own DSH in a separate directory and never uses this plugin.

Watch out — No paste-ready install command is published; you install a subdirectory plugin from source. Those steps run shell commands. The parent project targets official DeepSeek Harness 0.2.x on Desktop.

The verdict — I would not stack it with the 2NF original; I keep this fork only when I am already tracking the DSH Tavern repo.

Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.Read the source
1Source

dsh-ads

Nagi-ovo

676

Parody ads in 2005-Chinese-web style: sidebar banners, in-chat feeds, corner popups, and a close button whose hit area is smaller than it looks. All fictional.

Installed cleanly when we ran it

npm packageTypeScript1mo ago

AI review

dsh-ads

What it is — Insert fictional 2005 Chinese-web-style ads into DeepSeek Harness profiles.

Who it is for — Users wanting to insert sidebar and in-chat fictional ads into their DeepSeek Harness profile are suitable for installation. Users wanting to keep inference responses smooth are not suitable for installation, because the plugin pauses inference while the model continues to work in the background.

Watch out — Installation succeeds in a fresh profile and the plugin is registered by harness. No obvious issues found. Individual ad positions can be disabled in the settings panel, and the choice is retained for next startup.

The verdict — I would install it because it automatically cycles through other plugins based on dsh-plugin topic.

Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.Read the source
Details
509

Desktop-native BigFish companion for DeepSeek Harness — real Agent status, always on top on Windows.

Installed cleanly when we ran it

npm packageJavaScript22d ago

AI review

dsh-dafeiyu

What it is — DSH dafeiyu is a desktop-native companion plugin for DeepSeek Harness that displays real Agent status always on top on Windows.

Who it is for — On Windows official desktop DeepSeek Harness, people who need the status always on top in desktop layer fit to install it. If you work mainly in browser WebUI, you don't need to install it because status is shared via client.

Watch out — Tested successfully: installed in new profile and registered by harness. No obvious issues found in installation or operation. Status and balance display work as expected.

The verdict — I would install it because desktop native window provides status visibility WebUI cannot achieve, provided you use the official desktop client.

Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.Read the source
Source
477

A Bilibili companion that keeps its own schedule. A 60-second tick in the plugin host wakes a dedicated agent session at a random moment inside the configured time windows (opting out of a day is a configurable chance), then hands it a bundled CLI of 38 subcommands — feed, subtitles, danmaku, comments, ffmpeg frame grabs, and two diaries. Shares at most N items a day by commenting on them and @-mentioning the owner (default 3, enforced from a written quota log, and it stops on rate-limit or captcha signals). Also polls comment replies, direct messages and live-room danmaku; replies to anyone but the owner are queued for approval in Settings. Settings → 养鱼 writes ~/.dsh/bili-whale.config.json; cookies live separately in ~/.bili-ai/credentials.json and are never echoed back. The HTTP routes are loopback-only behind DSH's trust fence. Needs Node 18+ and ffmpeg on PATH for frame extraction.

Installed cleanly when we ran it

GitHub sourceJavaScript23d ago

AI review

dsh-bili-whale

What it is — A DeepSeek Harness Bilibili companion that runs its own schedule for random waking, video processing, diary writing, and sharing.

Who it is for — If you want to use an agent session in DeepSeek Harness to run a Bilibili companion with its own schedule for video reading, diary writing, and sharing, this plugin supports it. If you want to install it in an existing profile, this plugin is not suitable because it requires a new profile and registration with the harness.

Watch out — Requires Node 18+ and ffmpeg on PATH. Sandbox test passed in new profile. Agent session requires full access permissions.

The verdict — I would install it because it uses conservative defaults to protect account security, but the premise is to grant full access to the agent session.

Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.Read the source
1Details