How to use whale-girl
A whale girl desktop pet floats in the bottom right corner of the DSH webpage. It accompanies tasks and conversations, accumulating experience and memories. Users can feed, play with, and drag the pet.
This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.
This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.
Quick start
whale-girl
— source: plugin_wiki.wiki_content
Install & verify
dsh plugin --profile web add whale-girl
Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.
— source: plugins.install
Key points
- Shell: Tauri v2 (recommended, ~12MB); legacy Electron shell kept (
npm i -D electron). - Design & contracts:
desktop/DESIGN.md,desktop/BUILD-RUN.md. - Structure:
lib/(entry / logic / client / assets) separate from docs, decisions, scripts — root AGENTS.md - 🐛 Bug: file an issue with repro steps, browser & dsh versions; console errors for client issues
- 💡 Feature ideas: see docs/state-machine.md and docs/growth-system.md, describe the expected effect
— source: plugin_wiki.readme_en (fallback readme_raw)
FAQ
Why don't I see the pet after installing?
The bundle plugin requires restarting DSH Web (the plugin loads at startup); on first install, the pet is also hidden during the onboarding welcome page and will appear after completing the guide.
Can it run simultaneously with the desktop companion?
Yes. When the desktop companion is running, the web pet will automatically hide (presence heartbeat contract), and will restore on the web 45 seconds after the companion exits or crashes; if you want both to be off/on, change it in settings.yaml under whale-girl.enabled.
Can I adjust the seniority/titles myself?
No. XP thresholds, level curves, and title sets are code-level closed, the config schema doesn't expose them; only experiential parameters like size/transparency/wander interval can be adjusted.
Where is the data stored? Will it be lost after uninstall?
The data is stored in DSH_HOME/data/whale-girl/state.json (not in the plugin directory), so uninstalling the plugin won't delete the save; after reinstalling, seniority and memories will continue.
What is the installation command?
dsh plugin --profile web add github:vlln/whale-girl ; update with dsh plugin --profile web update whale-girl then restart web to take effect.
— source: plugin_wiki.faq_json
Compatibility
- DSH: 未声明
- Node: 未声明
- Platforms: 跨平台
— source: plugin_wiki.compatibility_json
Pitfalls
Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.
— source: general rule