Introduction

Within the DSH plugin ecosystem, the visual status indicators on the Web interface can be made more specific. dsh-whale-animation adds six sets of original whale loop animations for DeepSeek Harness Web’s turn status, and uses a lightweight animation director to switch between timed playback and keyword overrides. Below, we introduce its verified capabilities, installation methods, and usage notes.

What This Is

LeemanCheung/dsh-whale-animation is maintained by LeemanCheung and licensed under MIT.

It adds visual states to DSH Web’s turn status: six original whale loop animations and a lightweight animation director. Verified facts state its scope is strictly visual: no accounts, model tools, storage, workspace reads, networking, or user-content processing.

Core Capabilities

The following are the verified capabilities provided by the plugin:

  1. Six animation states: Deep Dive, Sonar, Tool Run, Stream, Calm, Retry.
  2. Timed playback: Rotates the playlist every 9 seconds.
  3. Keyword overrides: When recognizable search, tool, writing, waiting, or error text appears, keyword detection overrides the timed playlist; includes English and Chinese keywords.
  4. Reduced motion fallback: Uses matching PNG frames per state; when the system has reduced motion enabled, stops playlist rotation and uses the matching PNG frame.
  5. Theme and viewport support: Supports dark theme and adapts to display sizes of 84 / 72 / 60 px.
  6. Self-contained resources: Built-in WebP and PNG assets; zero runtime external requests; activation makes no external request.
  7. Strictly visual scope: Does not include accounts, model tools, storage, workspace reads, networking, or user-content processing.

Installation & Enabling

The following command installs a fixed version v0.4.0 to the DSH Web profile:

dsh plugin --profile web add github:LeemanCheung/dsh-whale-animation#v0.4.0

If you prefer to follow the main branch, you can use:

dsh plugin --profile web add github:LeemanCheung/dsh-whale-animation

After installation, you need to perform a hard-refresh on DSH Web. If the current profile has cached the client bundle, restart DSH.

Upgrading & Uninstalling

To upgrade, first remove, then reinstall:

dsh plugin --profile web remove dsh-whale-animation
dsh plugin --profile web add github:LeemanCheung/dsh-whale-animation#v0.4.0

The uninstall command is:

dsh plugin --profile web remove dsh-whale-animation

Development & Verification Dependencies

Development and verification require Node.js 20+.

Regenerating animation and documentation assets also requires Python 3 and Pillow.

The peerDependencies declared in package.json are:

{
  "@deepseek-ai/cordis": "^4.0.1",
  "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6"
}

Use Cases & Notes

Suitable for:

  • You want to add more intuitive visual feedback to DSH Web’s turn status.
  • You want the plugin to remain readable under reduced motion, dark theme, and different viewports.
  • You want animation resources to be self-contained, with no runtime external resource requests.
  • You only need visual states, without introducing accounts, model tools, storage, workspace reads, networking, or user-content processing.

Important notes:

  • The plugin runs with the current dsh process permissions; check the source code and MIT license before installation.
  • The installation command used in this article is fixed to v0.4.0; to follow the main branch, use the installation command without #v0.4.0.
  • Under reduced motion, the plugin stops playlist rotation and uses the matching PNG frame.
  • Runtime asset requests are zero; activation makes no external requests.

Links & Directory

GitHub repository:

https://github.com/LeemanCheung/dsh-whale-animation

The community directory is an independent site and has no official affiliation with DeepSeek / High-Flyer; it should not be interpreted as an official app store. The directory page entry can be found via the community directory badge in the repository README; unverified directory page URLs are not listed here.