Foreword

The DSH plugin ecosystem emphasizes “everything is a plugin”. For those running the DeepSeek Harness Web GUI locally, changing skins often encounters two problems: first, wanting to change the appearance without touching the source code; second, manual edits to dist make upgrades or rollbacks inconvenient. dataizu/dsh-whale-aqua-theme packages this theme as a DSH plugin, while retaining the traditional dist patch installation method. It primarily provides three things: a macOS style skin, a dynamic whale-in-water background, and a dot-matrix whale send button.

What is this

dataizu/dsh-whale-aqua-theme is an appearance theme package for the DeepSeek Harness Web GUI. It does not modify service logic or source code, focusing instead on Web frontend styles and animations. The repository provides styles and scripts under the MIT License, while clarifying that the DeepSeek whale graphics are official assets owned by DeepSeek; this repository is intended solely for personal theme beautification and must not be used commercially.

Core Features

  • Underwater Whale Background: Provides a dynamic underwater effect for the Web interface.
  • Dot-matrix Whale Send Button: Uses a dot-matrix whale graphic for the send button, running with animations.
  • Apple-style Skin: Provides macOS style interface styles.
  • Low-overhead Animation: Performance parameters are set to DPR 1.25 and 24fps. It automatically pauses when blurred or hidden, and button animations are drawn on demand.
  • DSH Plugin Package Installation: Can be installed, activated, deactivated, and uninstalled as a plugin package with a profile.
  • Plugin Lifecycle Management: In plugin mode, stopping the plugin completely recovers side effects.
  • Traditional dist Patch Installation: Can also copy style files to the Web frontend directory and splice them into index.html.

Installation and Activation

Installation via Plugin

Installing via the plugin method does not modify any dist files, so DSH upgrades are unaffected. Run the following command to install the plugin package from the GitHub repository:

dsh plugin --profile web add https://github.com/dataizu/dsh-whale-aqua-theme

Restart DSH after installation to take effect.

Deactivation

When deactivating the plugin, delete the insert line corresponding to the theme in the profile configuration. The corresponding identifier is:

id: dsh-whale-aqua

The configuration file is cordis.patch.yml. If there is a plugin market entry available in your current environment, you can also handle it via the uninstall or remove operation in the market; this article does not take the market entry as a definitive premise.

AI-Assisted Deployment

If you don’t want to manually modify files, you can copy the AI deployment prompt from the repository README verbatim to an AI and let it automatically complete the locating, backing up, copying, and splicing. After execution, a hard refresh of the page is still required to view the effects and check if the skin is applied.

Traditional dist Patch Installation

If you don’t want to introduce the plugin system, you can use the traditional dist patch method. First, find the target machine’s own DSH Web frontend directory; the directory should contain:

index.html

Then copy the theme style files to that dist directory:

apple-style.css
whale-icon.css

Next, open index.html in that directory and make two modifications. The first is to add style references in <head>:

<link rel="stylesheet" href="/whale-icon.css" />
<link rel="stylesheet" href="/apple-style.css" />

The second is to insert the background animation script before </body>. The script snippet in the repository is located at:

install/background-snippet.html

You need to copy the <script>...</script> block inside it to the target index.html.

After completion, hard refresh the page:

Ctrl+Shift+R

Note: You can only use the target machine’s own index.html here; do not use the whole page file from the repository to directly overwrite builds of different versions.

same-version Whole Page Override

The repository provides same-version/index.html, which is only applicable to DSH builds identical to the development version. Overwriting it to a different version of DSH will cause the interface to fail to load, so it is not recommended by default.

Version Compatibility

This theme consists of two parts with different compatibilities.

  • Background animation + Send button whale: Marked as usable on any DSH version in the README, mainly relying on stable DOM features.
  • apple-style.css: Depends on compiled CSS class names. The class name hashes may differ between different DSH versions, so the skin may partially or fully fail to work.

If the skin is not working, follow these steps:

  1. Open the inspector by pressing F12 on the page;
  2. Check the actual class names of the target elements;
  3. Replace the corresponding hash prefix in apple-style.css while keeping the stable class name suffix unchanged.

Applicable Scenarios and Notes

  • Suitable for scenarios where you run the DSH Web GUI locally and only wish to beautify the interface.
  • Installing via the plugin method does not modify any dist files, so DSH upgrades are unaffected; stopping the plugin completely recovers side effects.
  • DSH plugins run with the permissions of the current dsh process; you should check the source code, dependencies, and license before installing.
  • Styles and scripts are under the MIT License; the copyright for the DeepSeek whale graphics belongs to DeepSeek; this repository is only for personal theme beautification and must not be used commercially.

Links

GitHub repository:

https://github.com/dataizu/dsh-whale-aqua-theme

Plugin directory page (from plugin clue, please verify before visiting):

https://www.skillhub.cn/plugins/dataizu/dsh-whale-aqua-theme