dsh-whale-animation

<strong>A persistent, theme-aware monochrome whale-dive animation beside the DeepSeek Harness turn status.</strong><br /> Closed-loop playback, no runtime network requests, and a static fallback for reduced-motion users.

English · <a href="README.zh-CN.md">简体中文</a>

Preview

The preview has 60 frames at the production 33 ms cadence, with no extra in-between frames. v0.3.0 uses a compact head, lifted snout, eye, mouth, and short fluke while the torso and tail remain articulated frame by frame.

Screenshots

<td width="33%"><img src="docs/screenshots/launch.png" alt="The whale breaching the waterline" /></td>
<td width="33%"><img src="docs/screenshots/apex.png" alt="The whale curling at the leap apex" /></td>
<td width="33%"><img src="docs/screenshots/deep-dive.png" alt="The whale returning below the surface" /></td>
<td align="center"><strong>01 — Breach</strong></td>
<td align="center"><strong>02 — Apex</strong></td>
<td align="center"><strong>03 — Deep dive</strong></td>

Each screenshot is rendered from the committed assets/whale-dive.webp, so the gallery represents the frames users actually receive—not separate concept art. The generated hero, preview, and gallery use shared English captions in both README translations so they remain one reproducible visual artifact; the surrounding descriptions and alt text are localized.

Highlights

	Feature	What it means
🌊	Propagating water surface	Breach and entry produce travelling crests, recoil, and damped settling instead of a frozen waterline.
🐋	Original articulated whale	A compact head, lifted snout, eye, mouth, and short fluke remain legible while the torso and tail flex through the loop.
🌗	Theme aware	The whale uses its normal monochrome treatment in light mode and is inverted for prefers-color-scheme: dark, html.dark, and html[data-theme="dark"].
📦	Self-contained bundle	Animated WebP and PNG fallback are embedded in the built client; no runtime URL or source-frame directory is required.
♿	Reduced-motion aware	prefers-reduced-motion switches the animation to the included static PNG.
⚙️	Zero configuration	Size, offset, selector, and animation assets are fixed at build time; customization means rebuilding lib/client.js.
🎯	Strictly visual scope	Decorates only the Web turn-status surface; it has no settings, model tools, storage, workspace access, network calls, or user-content processing.
♻️	Lifecycle-clean and idempotent	Activation removes an older plugin style before adding one owned by the Cordis client fiber; stop or uninstall removes it completely.
🔌	Web-profile declaration	The dsh.bundle manifest and cordis.patch.yml declare the browser client for automatic Web-profile mounting when DSH loads the bundle.

Install

Install directly from GitHub into the DSH Web profile:

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

Then hard-refresh the DSH Web page. Restart DSH if the running profile has already cached its client bundle.

For the current release, pin #v0.3.0:

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

Uninstall

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

Animation profile

…