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

快速上手

dsh-whale-musume

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:Sutera-Diffusus/dsh-whale-musume

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

— 源: plugins.install

关键要点

• 效果预览
• 安装要求
• 安装教程
• 使用说明
• 更新 / 回滚 / 卸载

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后为什么没看到鲸鱼娘？

安装后需要重启 dsh web 进程（命令 dsh web 所在的服务）并用 Ctrl+F5 强制刷新页面；首次加载需要从宿主路由下载 CSS/JS/立绘，浏览器控制台可见 fetch 状态。

数据存在哪里？会上传吗？

全部养成数据（心情、好感度、成就、签到、悬浮位置等）都存在浏览器 localStorage，键名以 whale-moe: 开头。除可选天气功能调用 Open-Meteo 免费接口外，不发送任何遥测或外部请求。

想要天气陪伴需要付费 Key 吗？

不需要。天气数据走 Open-Meteo 的免费公共接口，城市名留空时完全不联网；如需更高频刷新可在设置里填入自有 API Key。

工作时她会一直说话打扰我吗？

不会。检测到 DSH 工具运行信号时她切到「抱笔记本」工作姿势，期间不主动弹气泡、不切待机小剧场；聊天命中时只触发固定的「害羞抱电脑」「偷吃内存条」等反应。

怎么彻底关闭看板娘？

在 DSH 设置 → 看板娘里关闭「看板娘」开关，或在浏览器控制台执行 localStorage.setItem("whale-moe:pet", "0") 后刷新页面即可，资源仍保留随时可重开。

卸载会留下残留吗？

走 dsh plugin --profile web add 安装的组合包，卸载时只需 dsh plugin --profile web remove github:Sutera-Diffusus/dsh-whale-musume 重启 dsh web，宿主路由与注入节点会随插件一并移除；localStorage 需要手动清。

拖拽位置会保存吗？

松开鼠标后位置写入 whale-moe:floatX / whale-moe:floatY，下次打开自动复原；右键菜单选「回到原位」会清除这两个键恢复默认右下角。

卸载之后看板娘还在，会占用空间吗？

关闭「看板娘」开关后表现层完全不渲染、动画循环停止，天气画布也会被摘除，仅保留几十 KB 的开关和养成数据；不会持续占用 CPU 或带宽。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则