Skip to main content

How to use dsh-whale-pet

Place a blue-haired whale girl desktop pet on the DSH desktop. It switches expressions and voice based on conversation state, and includes a balance badge and recharge option in the conversation header.

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

dsh-whale-pet

— source: plugin_wiki.wiki_content

Install & verify

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

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

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

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

What if the desktop pet doesn't appear after installation?

Confirm each step of install.ps1 outputs [OK], then restart DSH desktop app or dsh web service (plugins load at startup); also check if cordis.patch.yml contains the balance-widget line.

The balance badge shows 'balance unavailable' or keeps spinning?

Need to configure DEEPSEEK_API_KEY locally, server reads via @deepseek-ai/dsh-credentials, browser has no API Key. If network fails, badge keeps last balance and marks stale, won't flash off.

What if the desktop pet has no sound?

Browser autoplay policy requires first click on desktop pet to unlock AudioContext; right-click hat to open menu has master volume slider and separate voice/SFX/celebration volumes, DSH desktop version uses AudioContext to play pre-rendered mp3 by default.

The desktop pet stays on screen after closing DSH Desktop main window?

This is known behavior of DSH vanilla main.js. Optional to run apply-main-patch.ps1 to patch main process (backs up original, can -Revert to restore), lets desktop pet close with main window.

Is this an officially licensed project?

No. This is an unofficial fan project, with no affiliation or endorsement from DeepSeek官方, using 'Non-Commercial Use License' (commercial use prohibited). Character materials copyright belongs to original authors (see README acknowledgments).

What if the web version desktop pet doesn't display?

Confirm accessing restarted dsh web service; force browser refresh (Ctrl+F5); also check if ad blocker is blocking the desktop pet iframe.

How to uninstall?

Simply run install.ps1 -Uninstall; if manually installed, can also delete balance-widget line from cordis.patch.yml, then restart dsh web.

Will the balance leak to the browser?

No. Client only requests local server's /api/balance proxy interface, DSH API Key is resolved on server side via credentialRef and calls official interface, never sent to browser.

— source: plugin_wiki.faq_json

Compatibility

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

— 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