Preface

In DSH’s “everything is a plugin” approach, the interface appearance can also be made into replaceable client plugins. If you have been using the DSH Web interface at http://127.0.0.1:3080 for a long time and want to adjust the background based on local images or videos without directly modifying the DSH source code, dsh-client-ui-skins is an optional solution for such scenarios.

It consolidates built-in skins, custom image/video skins, background masks, and input box opacity into the DSH settings. After installation, simply refresh the page to use it.

What is This

This repository is caoyiwei850/dsh-client-ui-skins, positioned as a skinning plugin for the DSH Web interface.

The verified boundaries are as follows:

  • Targets the DSH Web interface.
  • Provides 4 built-in skins and custom image/video skins.
  • A pure client plugin that does not modify the DSH source code.
  • Restores the native appearance after uninstallation.
  • Licensed under MIT.
  • Requires the DSH web profile, located at ~/.dsh/profiles/web.
  • Depends on pnpm.

Core Features

The following are the verified capabilities.

Built-in Skins

Provides 4 built-in skins:

  • Deep Sea Blue
  • Cherry Blossom Pink
  • Mint
  • Amber

These 4 skins are adapted for both dark and light appearances.

Custom Image Wallpapers

Supports any PNG, JPG, WebP images.

After importing, the interface color scheme is automatically derived from the main image, used for the background, accent colors, and interactive highlights.

Video Dynamic Wallpapers

Supports MP4 and WebM videos for looping playback.

Video skins use the first frame to generate the color scheme.

Background Mask Slider

Used to independently adjust the brightness of the wallpaper.

When the background image is complex and text contrast is insufficient, you can use the mask to reduce background interference.

Input Box Opacity Slider

Used to independently adjust the input box background.

The goal is to ensure that the input area remains clear when typing on a custom background.

Body Enhancement Toggle

Used to add a light frosted background to the assistant’s body text.

When the background image has strong highlights, you can enable this toggle to reduce reading interference.

Installation and Activation

One-Click Installation

First, run the installation script:

bash install-dsh-skins.sh

After completion, refresh the page:

http://127.0.0.1:3080

Then go to the bottom left:

Settings → General Settings → Skin

Manual Installation

If you need to perform manual operations, first install the local plugin package under the DSH web profile:

cd ~/.dsh/profiles/web && pnpm add -w ./dsh-client-ui-skins-0.1.13.tgz

Next, edit the registration file:

~/.dsh/profiles/web/cordis.patch.yml

Append the following plugin item:

- insert:
    - id: ui-skins
      name: 'dsh-client-ui-skins'

Finally, restart the DSH Web process:

launchctl kickstart -k gui/$(id -u)/com.deepseek.dsh.web

Uninstallation

Run the uninstallation script:

bash uninstall-dsh-skins.sh

Typical Usage

Below are a set of reproducible usage steps.

  1. Refresh the DSH Web interface:
http://127.0.0.1:3080
  1. Enter the settings:
Settings → General Settings → Skin
  1. Select a built-in skin.

You can directly click on the built-in skin cards to switch, such as Deep Sea Blue, Cherry Blossom Pink, Mint, or Amber.

  1. Select a custom skin.

Click:

Custom (Select Image/Video)

Then select an image or video from your local machine.

  1. Adjust custom skin parameters.

After activating a custom skin, the following controls will appear:

  • Background Mask Slider
  • Input Box Opacity Slider
  • Body Enhancement Toggle

These parameters can be previewed in real-time, and the plugin will remember your preferences.

Applicable Scenarios and Notes

Who is This For

This plugin is more suitable for the following use cases:

  • Working long-term in the DSH Web interface and wanting to adjust the visual background.
  • Wanting to use local images or videos as backgrounds without modifying the DSH source code.
  • Hoping to preserve DSH’s native functionality while extending only the client-side appearance.
  • Needing to restore the native appearance after uninstallation.

Notes Before Use

  • The plugin is a pure client plugin that does not modify the DSH source code.
  • Restores the native appearance after uninstallation.
  • Custom images/videos are only processed locally: images are stored in localStorage, videos in IndexedDB, and are not uploaded to any server.
  • Requires the DSH web profile:
~/.dsh/profiles/web
  • Depends on pnpm.
  • The plugin runs with the current DSH process permissions. Before installation, it is recommended to review the repository source code, installation scripts, and license; the current information indicates the license is MIT.
  • Note: There is a version inconsistency in the collected materials: the README and installation package examples use 0.1.13, while the package.json example shows 0.1.14. This article uses the 0.1.13 package name from the verified usage for manual installation commands. Please refer to the actual files in the repository before installation.

Links

  • GitHub:
https://github.com/caoyiwei850/dsh-client-ui-skins
  • Community Directory Page:
https://www.skillhub.cn/plugins/caoyiwei850/dsh-client-ui-skins

If you just want to change the background of the DSH Web interface while maintaining the “no source code modification, uninstallable” boundary, this plugin provides a straightforward path: run the installation script first, then select a skin in the settings; when personalization is needed, import local images or videos and adjust the mask and input box opacity.