Preface

DSH extends Web interface capabilities via plugins. When using DSH Web daily, the agent’s idle, thinking, tool calling, errors, and completion may not have sufficiently intuitive visual feedback. nzl153/dsh-pet-whale is a Web desktop pet plugin that uses a small whale to switch animations according to the agent’s state, placing the current state in the corner of the page.

What is this

The repository is identified as nzl153/dsh-pet-whale, maintained by nzl153. Its positioning is: a desktop pet whale, a DeepSeek Harness Web desktop pet plugin (official outline version) that switches animations based on agent state. The license is MIT, requiring DSH >=0.1.0-rc.6 (web profile).

Core Features

State Feedback

  • State machine: idle / think / working / celebrate / error / disappointed / wait
  • Turn semantics: working if a tool is displayed, think (diving deep) if no tool is displayed

Interaction and Display

  • Click to poke, double-click to roll 360°, drag and drop with position memory, right-click menu
  • WebAudio synthesizes 6 sound effects, toggleable via right-click
  • 7 preset palettes for skinning: Theme Blue / Terracotta / Deep Sea Blue / Matcha Green / Sakura Pink / Ink Grey / Night Black
  • Follows DSH light/dark theme automatically
  • Chinese / English complete copywriting, automatically follows via DSH official locale service
  • Hide to bottom right and recall, small button changes color with agent state
  • Automatically pauses animation, sound effects, and thinking stream when the page goes to the background
  • Automatically degrades to static display under prefers-reduced-motion

Installation and Enablement

Requirements:

DSH >=0.1.0-rc.6 (web profile)

Local directory installation:

dsh plugin --profile web add link:/path/to/pet-whale

Direct git installation:

dsh plugin --profile web add "github:<user>/pet-whale#main"

The installation commands contain placeholders: link:/path/to/pet-whale needs to be replaced with the actual local path, and github:<user>/pet-whale#main needs to be replaced with the actual GitHub user.

After installation, restart dsh web; hard refresh the client (Ctrl+F5).

Typical Usage

Online preview:

https://nzl153.github.io/dsh-pet-whale/preview.html

Build and test:

pnpm install
pnpm typecheck
pnpm build
pnpm test

Applicable Scenarios and Notes

Suitable for people who want to add visual feedback of agent state to DSH Web pages, for example, understanding what the current agent is doing through small whale animations, sound effects, palettes, hidden recall, and text states.

Notes:

  • The plugin runs with the permissions of the current dsh process; you should check the source code and license before installing.
  • Installation commands contain placeholder paths/users and need to be replaced according to the actual environment.
  • Optional system notifications are off by default and permission is only requested when enabled.
  • The small button’s position, hidden state, and some preferences are remembered using localStorage.
  • The whale outline uses the DeepSeek official FishLogo path (brand material, please cite the source if used).
  • patches/ are personal custom patches for the DSH interface and are not part of this plugin.
  • The community directory is an independent site and has no official affiliation with DeepSeek / Huanfang.

Conclusion

nzl153/dsh-pet-whale puts agent state, interaction, skin changing, hidden recall, multi-language, and accessibility degradation into a lightweight desktop pet, serving as a state feedback extension for DSH Web.

Directory page: https://www.skillhub.cn/plugins/nzl153/dsh-pet-whale

GitHub: https://github.com/nzl153/dsh-pet-whale