dsh-whale-girl-live2d: A Live2D Desktop Pet That Follows the Agent in DeepSeek Harness

What Does It Do?

Whale Girl Live2D is a DSH plugin for DeepSeek Harness that puts an animated Live2D desktop pet in the bottom-right corner of the DSH Web UI and makes her react to what the agent is actually doing. It solves the problem of not being able to see agent status or speak to the agent without leaving the page. One plugin serves both the web version and the optional macOS desktop shell, sharing the same model, motions, expressions and agent linkage, maintained by Andersen216 under the MIT license.

Core Features

• State linkage: expressions and motions follow the agent's real runtime state, so you do not have to read logs to guess progress.
• Click to talk: a single click lets you speak to the agent directly, skipping the usual input-box switching.
• Right-click wallet: a right click opens the wallet panel, keeping usage and cost within reach.
• Four-page menu: expressions, decorations, scenes and motions are managed on separate pages, and she can be dragged to a new position.
• Desktop shell (macOS 13+ only): transparent, borderless and always on top, with click-through, drag-her-to-drag-the-window, an edge-docked floating ball and a menu bar icon.
• Cross-platform web version: works on Windows, macOS and Linux with the same features as the desktop shell, she simply lives inside a browser tab.

How to Use This Plugin?

Enable this DSH plugin in your DSH web profile and restart DSH, then refresh the page and she appears in the bottom-right corner; the host plugin only loads at startup, so the restart step is required. The desktop version is a separate macOS shell app that carries no model or linkage of its own and must be paired with the plugin; once the plugin is in place the app retries every 5 seconds and she shows up without restarting the app. In daily use, click her to talk to the agent, right-click for the wallet, drag to reposition, and let expressions and motions follow the agent state automatically. Windows and Linux users can simply use the web version while the cross-platform shell is still planned.

How to Troubleshoot This Plugin?

• The desktop app keeps showing that it is looking for DSH: usually the plugin is not installed, DSH is not running, or the plugin is disabled; first confirm the self-check endpoint returns 401 rather than 404.
• The self-check endpoint returns 404: the plugin is not registered or has been disabled in plugin settings; follow the official instructions to check the profile dependencies and bundles configuration, and make sure the patch file does not mark the plugin as disabled.
• Nothing appears after refreshing the web page: the host plugin only loads when DSH restarts, so restart DSH and then hard-refresh the page.
• Double-clicking the app seems to do nothing: it is a background app without a Dock icon, so check the whale icon in the menu bar, double-click again to bring the window forward, and keep only one copy of the app installed.
• An update produced no change: the package manager pinned the old commit via its lockfile, so pull the update again as described in the official instructions.