dsh-whale-pet: A Blue Whale Pet Living in the DeepSeek Harness Web UI

What Does It Do?

Whale pet is a DSH plugin for DeepSeek Harness that puts an animated blue whale in the bottom-right corner of the Web UI. It solves the problem of not knowing what the agent is doing: the whale's motion and sounds show in real time whether the harness is working and which session it is handling, and clicking it opens a token and cost panel. Maintained by yzmin, it is written in plain JavaScript with no runtime dependencies and no build step.

Core Features

• Live status animation: the whale floats gently when idle and swims faster with rising bubbles, a pulsing halo and a spinning outer ring while working.
• Completion chime: a sound plays when work finishes, a descending synthesized variant plays on failure, and a soft cue marks the start; if the audio asset is missing or cannot be decoded, it falls back to synthesized sound.
• Usage and cost panel: clicking the whale shows the session's token breakdown (cache hits, misses, cache writes, output), the amount computed from official rates, session duration and account balance.
• Interaction log: each entry includes the prompt, a reply summary, tool, turn and step counts, elapsed time and cost.
• Selectable tones: the panel offers five tones — bright bell, soft xylophone, marimba, click and long bell — with the completion sound coming either from an audio file or from live synthesis.
• Theme aware: the panel uses theme tokens only, so it adapts to light and dark themes automatically.

How to Use This Plugin?

Once enabled in the DSH web profile, the whale appears in the bottom-right corner and shows work status without any extra action. Click the whale to open the panel with the session's token breakdown, cost, duration and per-interaction records. To change the completion sound, replace the audio asset in the plugin folder and restart DSH, or pick another tone from the panel dropdown. Edits to the client script take effect after a page refresh, while edits to the host script require a DSH restart.

How to Troubleshoot This Plugin?

If the whale does not appear or the panel has no data, first check that the profile provides a web server, since the panel cannot fetch data without it, then confirm the bundle is enabled and its slot occupant is active. An empty balance row usually means the optional account capability is absent, and the rest of the features keep working. If a replaced sound does not change, the asset format or extension likely does not match the constant in the code; fix it as described in the official instructions and restart DSH.