本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

whale-girl

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add whale-girl

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 消费 whale-girl 既有公开端点（/state、/events、/presence、/interact、/config、/assets），不改动插件本体；运行期间网页端宠物自动隐藏（presence 契约），退出或崩溃（TTL 45s 过期）后恢复。
• 渲染壳：Tauri v2（推荐，体积 ~12MB）；Electron 遗留壳保留（npm i -D electron 后可用）。
• 设计与契约见 desktop/DESIGN.md、desktop/BUILD-RUN.md。
• 结构：lib/（入口/纯逻辑/client/素材）与 docs/decisions/scripts 分离，见根 AGENTS.md
• 🐛 遇到问题：提交 issue，附复现步骤、浏览器与 dsh 版本；客户端问题附控制台报错更佳

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装完为什么没看到宠物？

bundle 插件需重启 DSH Web（合成在启动时发生）；首次安装还有 onboarding 欢迎页期间宠物是隐藏的，点完引导即可出现。

能和桌面伴侣同时跑吗？

可以。运行桌面伴侣时，网页端宠物会自动隐藏（presence 心跳契约），伴侣退出或崩溃 45 秒后网页端恢复；若想两处都关/都开，在 settings.yaml 的 whale-girl.enabled 里改。

资历/称号能自己调吗？

不能。XP 阈值、等级曲线、称号集合是代码级封闭的，配置 schema 不暴露；只能调整尺寸/透明度/游走间隔这类体验层参数。

数据存在哪里？卸载会丢吗？

状态存 DSH_HOME/data/whale-girl/state.json（不在插件目录里），所以卸载插件不会删档；重装后资历和回忆会续上。

安装命令是什么？

dsh plugin --profile web add github:vlln/whale-girl ；更新用 dsh plugin --profile web update whale-girl 后重启 web 生效。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: 未声明
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则