dsh-ads
Nagi-ovo
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
GitHub sourceTypeScriptyesterday
whale-girl
vlln/whale-girl
Desktop pet (QQ-pet style): floats in the corner, draggable, feedable, playable.
Install
Add whale-girl to DeepSeek Harness
via GitHub · GitHub source
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 yesterday.
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.
- A listing here is not a security review. Plugins run with your agent's permissions.
The AI take
What it is — DSH Web GUI right-bottom floating desktop pet, draggable, feedable, playable and accumulates task experience into ranks.
Who it is for — Users doing tasks in DSH Web GUI are suitable to install it to accumulate ranks. Users not wanting to add desktop companions can skip it.
Watch out — No obvious pitfalls found. Sandbox test passed in new profile. Configuration changes like size and walk are hot-reload without restart.
The verdict — I would install it because it accumulates ranks from tasks but only for DSH Web GUI users.
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
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
481
dsh-dafeiyu
QCYTSN
Desktop-native BigFish companion for DeepSeek Harness — real Agent status, always on top on Windows.
Installed cleanly when we ran it
npm packageJavaScriptyesterday
dsh-pet
PC2005-cloud
Desktop pet for the DSH Web UI with 25 transparent animations, screen wandering, click reactions and drag, plus a reproducible asset-generation pipeline.
No one-line install — this plugin lives inside a larger repository and publishes no npm package.
GitHub sourceJavaScript2d ago
dsh-stock-watch
Awu12277
A-share watchlist real-time market monitoring plugin: a collapsible popup in the top-right corner of the DeepSeek Harness (DSH) web interface for real-time quote monitoring, group switching, intraday and candlestick (K-line) charts, and buy/sell target price settings.
Installed cleanly when we ran it
npm packageJavaScriptyesterday
GitHub sourceJavaScriptyesterday
npm packageTypeScriptyesterday