Introduction

The default appearance of the DSH Web interface is relatively fixed. If you only wish to change the background, or switch between a few local images, image addresses, and built-in presets, check out dsh-wx-skin. It is a skin plugin for the DSH Web GUI, providing a sidebar “Skin” panel, supporting local images / URLs as full-screen backgrounds, and includes presets, dimming, blur, disabling the skin, and cross-refresh persistence capabilities.

What is it

dsh-wx-skin is maintained by wangxilhy23 under the MIT license. Its positioning is as a DSH Web GUI skin plugin, belonging to an external client plugin, adopting the dsh-web-ui style. It does not modify the DSH repository, nor does it affect the main interface or other plugins, primarily providing background replacement and display parameter adjustment on the browser side.

Core Features

Sidebar Entry

After installation, a “Skin” entry will appear in the sidebar. Clicking this entry opens a settings panel. The documentation describes this panel as a floating layer that does not block chat content.

Background Selection

Supports selecting local images via the browser’s native file dialog. Verified supported bitmap formats are:

  • PNG
  • JPEG
  • WebP
  • GIF
  • BMP

Vector formats like SVG are not supported.

The documentation states that local images are not limited by file size, and oversized images will be automatically scaled.

It also supports pasting an http(s):// image address to apply it directly.

Preset Skins

Built-in presets include:

  • Ink Blue
  • Slate
  • Warm Sand
  • Sunset Gradient
  • Deep Sea Gradient
  • Aurora Gradient

Effect Adjustment

Adjustable items include:

  • Dimming: 0–80%
  • Blur: 0–24px
  • Opacity: 0–100%, default 72%

The panel also provides an enable/disable toggle and a “Restore Defaults” operation.

Persistence and Theme

Settings are persisted to localStorage and mirrored to the host copy:

~/.dsh/dsh-wx-skin.settings.json

The documentation states that it will automatically restore after refresh, restart, or changing the port on the desktop client.

The plugin also supports automatic adaptation to light and dark themes.

Installation and Activation

Prerequisites

The following conditions must be met first:

  • deepseek-harness is installed
  • web profile is initialized
  • Node >=22.19.0 and packageManager pnpm@11.7.0 are declared in package.json

Installation Command

The verified installation command provided by the documentation is:

pnpm dsh plugin --profile web add dsh-wx-skin@0.1.2

This command uses the fixed version 0.1.2.

Restart and Refresh

After installation, restart dsh web, then refresh:

http://127.0.0.1:3080

The “Skin” entry will appear in the sidebar, and it is ready to use.

Verify Mounting

You can execute:

pnpm dsh --profile web --dump-config

You should see the following in the output:

"# == dsh-wx-skin"

Typical Usage

  1. Click the “Skin” in the sidebar.
  2. Select a background: choose a local image, paste an http(s):// image URL, or select a preset.
  3. Adjust “Dimming”, “Blur”, and “Opacity”.
  4. Turn on “Enable Skin”; perform “Restore Defaults” when you need to revert.

If you just want to preview the effect first, you can open the self-contained demo source:

assets/demo.html

The documentation states that this file can be opened directly in a browser for preview.

Uninstallation

The verified uninstallation command is:

pnpm dsh plugin --profile web remove dsh-wx-skin

After restarting dsh web, the sidebar entry disappears, and skin settings are cleared along with it.

Applicable Scenarios and Notes

Suitable for developers using the DSH Web interface who wish to replace the background while maintaining the readability of the main chat interface.

Recommendations before use:

  • The plugin runs with the current dsh process permissions; source code and license should be checked before installation.
  • Only accepts bitmap formats PNG/JPEG/WebP/GIF/BMP; vector formats like SVG are not supported.
  • The sidebar entry depends on the DOM structure of the DSH shell; if a version change causes the entry not to appear, the documentation states it will only log an error and not affect the GUI.
  • The skin relies on the application root #root as the mount point, rendering the background using a z-index: 0 and #root elevation scheme.
  • Local images are stored in localStorage as data URLs and mirrored to ~/.dsh/dsh-wx-skin.settings.json.

Links

GitHub:

https://github.com/wangxilhy23/dsh-wx-skin

Directory page mentioned in the documentation:

https://www.skillhub.cn/plugins/wangxilhy23/dsh-wx-skin

This directory page link comes from a plugin clue and has not been separately verified; it is listed here only as the address appearing in the documentation.