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

快速上手

dsh-whale-pet

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-whale-pet

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

— 源: plugins.install

关键要点

• 🖥️ 桌面版：DSH Desktop（Electron）右下角独立透明置顶小窗
• 🌐 Web 版：浏览器访问 dsh --profile web 时，页面右下角悬浮层
• Windows
• 已安装 DeepSeek Harness 桌面客户端 和/或 npx 版 dsh
• ✅ 允许：个人使用、学习、非商业性分享

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后桌宠没出现怎么办？

确认 install.ps1 各步骤输出为 [OK]，然后重启 DSH 桌面应用或 dsh web 服务（插件在启动时加载）；同时检查 cordis.patch.yml 是否包含 balance-widget 行。

余额徽章显示"余额不可用"或一直转圈？

需要在本地配置 DEEPSEEK_API_KEY，服务端通过 @deepseek-ai/dsh-credentials 读取，浏览器无 API Key。如果网络失败，徽章会保留上次余额并标记 stale，不会闪断。

桌宠没有声音怎么办？

浏览器自动播放策略要求首次必须点击一次桌宠解锁 AudioContext；右键帽子打开菜单里有总音量滑块和语音/音效/庆祝独立音量，DSH 桌面版默认走 AudioContext 播放预合成 mp3。

关闭 DSH Desktop 主窗口后桌宠还留在屏幕上？

这是 DSH 原版 main.js 的已知行为。可选运行 apply-main-patch.ps1 给主进程打补丁（备份原文件，可 -Revert 还原），让桌宠随主窗口一起关闭。

这是官方授权的项目吗？

不是。这是一个非官方同人项目，与 DeepSeek 官方无隶属或背书关系，采用"非商业性使用许可"（禁止商用）。角色素材版权归原作者所有（见 README 致谢）。

Web 版桌宠不显示怎么办？

确认访问的是重启后的 dsh web 服务；浏览器强制刷新（Ctrl+F5）；同时检查广告拦截器是否屏蔽了桌宠 iframe。

怎么卸载？

直接运行 install.ps1 -Uninstall；如果是手动安装，也可以从 cordis.patch.yml 删除 balance-widget 行，再重启 dsh web。

余额会泄漏到浏览器吗？

不会。客户端只请求本服务端的 /api/balance 代理接口，DSH API Key 通过 credentialRef 在服务端解析后调用官方接口，从未下发到浏览器。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: >=22

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则