Introduction

The DeepSeek Harness (DSH) web interface can be extended with plugins. dsh-blue-sea-player is a persistent whale girl music player widget. It appears automatically when you open the DSH page, does not interfere with the main interface, and provides complete playback functionality along with visual customization options.

Core Features

This plugin mainly provides the following capabilities:

  • Automatic persistence: Every time you open the DSH web page, the player is automatically injected and displayed.
  • Freely draggable: You can drag it anywhere on the screen; its position is remembered (saved in localStorage).
  • CD player and rhythm lines: During playback, the circular CD cover rotates (the cover is automatically cropped to 1:1). Below it, the song title scrolls centered when long, along with white five-segment rhythm lines, where each segment animates independently.
  • Playback controls: Supports single-track loop, list loop, and shuffle modes. Includes progress bar dragging, volume adjustment, and previous/next tracks.
  • Playlist: Click a track in the list to play it; the current track is highlighted in gold.
  • Stow and hide: “Stow” and “Hide” buttons are provided in the top-right corner. “Stow” collapses the panel into a strip; “Hide” shrinks it into a whale girl avatar ball, which can be moved by dragging and expanded by clicking.
  • Asset management: Supports adding new songs (with automatic title filling), batch deletion, card menus (edit/delete require confirmation), and cover processing.
  • Skin management: Built-in 12 skins, one-click switching, and skin carousel (select multiple skins and set an interval for automatic rotation).

Installation and Activation

Before installing, prepare the directory path of the plugin.

dsh plugin --profile web add link:<本目录绝对路径>

After installation, restart dsh web and refresh the page. The player will automatically appear in the interface.

Typical Usage

  1. Play music: Click any track in the playlist to start playback. While playing, the CD rotates and the rhythm lines animate.
  2. Move position: Press an empty area of the player panel (excluding buttons, lists, or sliders) and drag it.
  3. Stow panel: Click the “Stow” button in the top-right corner; the panel collapses into a top strip. Drag the strip to the left or right edge, and it will snap into the avatar ball.
  4. Manage resources: Go to ⚙ Settings → Asset Management, then click + to add. Choose a cover image (optional) and a music file (mp3/wav/ogg/m4a), then save.
  5. Change skin: Go to ⚙ Settings → Skin Management, then click any skin to switch and apply it immediately.

The plugin code is released under the MIT License. The assets are derivative works under the CC BY-NC-SA 4.0 license (commercial use is prohibited, and the full attribution chain must be retained).

The whale girl character originates from bilibili @上善无形 @ZipZipPipe (attribution must be retained; do not remove it). For the full attribution chain and licenses, see the NOTICE file.

Data Storage

Your song asset data is stored in the <DSH_HOME>/dsh-blue-sea-player/ directory.