The core philosophy of DeepSeek Harness (DSH) is “everything is a plugin.” Developers can extend the functionality and appearance of the Web UI through plugins. Among the many available plugins, deepseek-whale-wallpaper, developed by heshen-1, provides an immersive visual enhancement solution. It reinterprets DeepSeek’s classic dot-matrix whale illustration as a dynamic particle system, making it suitable for developers who want to incorporate a distinctive visual style into their interface.

Plugin Overview

This is a real-time light dot-matrix whale wallpaper plugin designed for the DeepSeek Harness Web UI.

The plugin is maintained by HeShen-1 and is licensed under the MIT License. It uses WebGL2 to render approximately 1,750 breathing particles to simulate the form of a whale, and supports light and dark themes. The plugin does not include branding, nor does it render particle connection lines, aiming to provide a clean visual background.

Core Features

  • Real-Time Rendering: Renders approximately 1,750 breathing particles using WebGL2 to simulate the whale’s form and movement.
  • Interactive Feedback: When moving the mouse, particles near the pointer form a vortex and slowly recover.
  • Theme Adaptation: Built-in light and dark themes automatically follow Harness’s appearance settings.
  • Clean Design: No branding, no connection lines, and no cluttered elements.

Installation and Configuration

Installation Steps

  1. Download the release package: Download dsh-plugin-harness-whale-<version>.tgz from GitHub Releases.
  2. Extract and place it: Place the extracted package/ directory at ~/.dsh/profiles/node_modules/dsh-plugin-harness-whale.
  3. Register the plugin: Edit ~/.dsh/profiles/web/cordis.patch.yml and add the plugin configuration to the insert list.
  4. Restart the service: Restart the DeepSeek Harness Web process and refresh the page to see the wallpaper.

Configuration Parameters

The plugin supports overriding configurations through cordis.patch.yml. The main parameters include:

  • enabled: Whether to enable the wallpaper (default true).
  • quality: Quality level; supports auto, low, medium, and high (default auto).
  • brightness: Brightness (0.35–1.4, default 0.9).
  • scale: Whale size (0.72–1.25, default 1).
  • interactionStrength: Interaction strength (0–1.5, default 1).
  • activeDimming: Dimming level during input or task execution (0.12–0.6, default 0.22).

Notes

  • Environment Requirements: Requires DeepSeek Harness dev-preview (@deepseek-ai/dsh) and its Web Profile.
  • Performance and Compatibility: The DPR (device pixel ratio) cap is 1.5. If the frame rate drops, it automatically degrades (high -> medium -> low). If the browser does not support WebGL2, it automatically falls back to static Canvas2D rendering.
  • Ecosystem: This plugin is listed in the awesome-dsh-plugin collection.

Conclusion

This plugin provides high-quality visual customization for the DSH Web UI and is suitable for developers who value interface aesthetics. The source code and documentation are available on GitHub.