Introduction

When working with DSH (DeepSeek Harness), the vast majority of the time you are facing its Web interface. To make this interface look better, you usually need to handle several things separately: a theme scheme, a cursor scheme, the desire to intuitively see the start and exit of sub-agents, and the desire to view the consumption of each dialogue round directly on the interface. These are independent needs. dsh-beautify puts all of these into a single package: 29 themes, 10 whale cursors, a small whale widget that appears and leaves with the sub-agents, plus a balance bubble and sound effects. Below is an introduction in the order of functions, installation, local development, and notes.

What is it

dsh-beautify is a DSH community plugin positioned as a “one-stop beautification package”. The npm package name is @nlqh/dsh-beautify, the GitHub repository is nlqh7/dsh-beautify, and it is created and maintained by DSH community member @nlqh7. It covers five areas: Whale Cursor, Sub-agent Little Whale, 29 Themes, Custom Skins, and Sound & Settings, with no configuration required after installation.

In terms of size, the README badges indicate a bundle size of 4.6MB, with embedded wallpapers trimmed down to approximately 1.7MB.

In terms of implementation, it stands on top of several upstream projects: the balance display and whale UI are inspired by MeteorNOX/DeepSeek-Balance-Whale-Widget; the default theme “Deep Sea Maid Workshop” comes from zhu1090093659/dsh-web-ui (vendored, CC BY-NC-SA); and the reaction GIF playback mechanism references Aibie07/whale-girl-desktop-pet.

Core Features

Whale Cursor: 10 States with Independent Control

The cursor covers 10 states: Default Arrow, Link Hand, Text, Busy, No Entry, Crosshair, Background, Brush, Help, and Drag. Each state can be controlled independently; to switch to your own skin, you can upload 10 images to cover each state. By default, the Drag state uses the system default cursor.

Sub-agent Little Whale

Each sub-agent corresponds to a little whale, with a 1:1 lifecycle linkage: when a sub-agent enters, the little whale appears; when a sub-agent leaves, the little whale leaves. When multiple sub-agents arrive at the same time, they announce their arrival one by one, with an interval of approximately 170ms.

Interaction details:

  • Click Bounce: Bounces slightly when pressed.
  • Angry Easter Egg: Triggers after pressing 8 times within 10 seconds.
  • Individually Draggable: Automatically snaps to walls after being dragged to any position on the screen.
  • Collision Volume: When released, if overlapping with the main whale or other little whales, it automatically bounces off and will not stack together.
  • Independent Sound Switch: The sub-agent’s call can be turned off independently without affecting the main whale’s sound effects.

29 Themes and Wallpaper Engine Bridge

Built-in 29 themes, with both Dark and Light modes; it also supports custom themes: upload a wallpaper and then adjust 7 parameters.

If Wallpaper Engine (WE) is installed on this machine, you can bridge local wallpapers: the plugin scans the wallpapers in WE, supporting both web HTML/JS animations and video categories. The switching path is Settings → Appearance → Wallpaper Engine One-Click Switch, with real-time refresh. First, switch into wallpaper mode, and the current theme will be automatically suspended; then use the 4 sliders (dimming, blur, border, glass) to fine-tune the look. After closing the wallpaper, the theme is fully restored.

Default Theme: Deep Sea Maid Workshop

“Deep Sea Maid Workshop” is the default theme and is enabled directly when newly installed or when no theme has been set. It uses a Navy Blue + Gold color palette, providing Dark and Light skins. The maid illustration in the chat interface is displayed as a large 96vh image; the Trajectory View does not show the maid.

Widget Menu and Bubble

The main whale widget comes with a menu and a bubble. Main capabilities:

  • Random Lines: Click the bubble to switch lines. Sources include peak and valley periods, today’s usage, cute roasts, and rua GIFs. Click again to close.
  • Consumption per Round: Automatically pops up the consumption amount of the current round at the end of each dialogue, calculated based on real usage; when the main session and sub-agents run in parallel, statistics are bucketed by session.
  • Three Peak/Valley Text Options: Available; v4-pro converts at a 3x price.
  • Scrollbar Avoidance: The widget can avoid the scrollbar based on set pixels.
  • Anchor Position Memory: Remembers the distance of the widget relative to the border; after the window size changes, it returns to the original position.
  • Multi-currency: When the balance interface returns multiple currencies with an indefinite order, the CNY positive balance is prioritized.

Sound System

  • Main Whale Click/Drag Sound Effects: Master sound effect switch + volume.
  • Sub-agent Sounds: Independent switch.
  • Usage Bubble: Usage mode switch.
  • Sound Packs: 4 options, including Rubber Duck and fx1.

Settings Experience

  • Settings Popup Follows Theme: The settings popup follows the theme’s own light/darkness, not the host’s preference: under a dark theme, the popup is also dark.
  • Mouse Cursor Switch Fix: After closing and opening again, the skin is definitely visible (automatically restores the default state).
  • Drag Cursor Size: Can be adjusted between 24–64px.

Installation and Enablement

Installation is done via DSH Hub. The official description is one step complete:

DSH Hub search @nlqh/dsh-beautify → Install and use, no configuration needed

After installation:

  1. The main whale appears in the bottom right corner of the screen;
  2. Start a sub-agent, and the corresponding little whale appears automatically;
  3. Open Settings → Appearance to adjust the theme, cursor, and sound separately.

Local Development

If you want to modify code or build it yourself, follow the flow in the repository README:

git clone https://github.com/nlqh7/dsh-beautify.git
cd dsh-beautify
pnpm install
pnpm dsh web

The last command needs to be executed inside the DSH harness monorepo.

The README also provides an environment tip: under the WorkBuddy environment, git push gets stuck by helper-selector. The workaround is to use GITHUB_TOKEN with an embedded URL:

git -c credential.helper= push "https://x-access-token:${GITHUB_TOKEN}@github.com/nlqh7/dsh-beautify.git" master

Applicable Scenarios and Notes

Suitable for: People who use the DSH Web interface daily and want to personalize the interface; people who want to intuitively see when sub-agents start and stop; people who want to see the consumption of each round directly in the widget bubble.

Three suggestions before installation:

  1. Confirm Permission Boundaries. The plugin runs with the permissions of the current dsh process. Before installing, browse through the repository source code to confirm that the behavior matches your expectations.
  2. Check the License. The README badges and License section state CC BY-NC-SA 4.0, but the license field in package.json is MIT. They are inconsistent. You need to confirm which one takes precedence before secondary redistribution or commercial use.
  3. Watch out for Material Copyright. The character illustration DSniang1.png (CC BY-NC-SA) and assets/reactions/*.gif (Bilibili UP ‘Chi Feng RED’s ‘Blue Big Fat Fish’ sticker pack) are copyrighted by the original authors and are only for non-commercial display with the plugin. Separate use requires prior authorization.

There is another inconsistency: regarding version, the README badge is 0.2.1, while package.json is 0.3.0; the actual code in the repository takes precedence.

Summary

dsh-beautify puts scattered tasks in the DSH interface beautification—theme, cursor, sub-agent widget, consumption display, and sound—into one package. It is installable and usable on DSH Hub with no configuration. The plugin is maintained by community member @nlqh7. Links are below:

  • GitHub Repository: https://github.com/nlqh7/dsh-beautify
  • Community Directory Page: https://www.skillhub.cn/plugins/nlqh7/dsh-beautify

Final Note: The DSH Community Directory is an independent site and has no official affiliation with DeepSeek / Quant (Fangfang), nor is it an official app store.