Introduction

The DSH community ecosystem emphasizes the philosophy that “everything is a plugin.” The community directory is an independent site with no official affiliation to DeepSeek / Huaquan; plugins are maintained by the community, and users need to judge for themselves whether they are suitable for the current environment.

dsh-wallpaper is a DSH Web wallpaper plugin used to change background images in the DSH Web interface and further adjust display effects such as blur, surface opacity, text color scheme, fill, and position on the wallpaper. It supports configuring wallpapers separately for the main interface and the trajectory page, and also supports no wallpaper, built-in gradients, uploading images, importing folders, and cropping images.

About This Plugin

dsh-wallpaper is a DSH Web wallpaper plugin maintained by RNlao. The repository address is:

https://github.com/RNlao/dsh-wallpaper

The currently verified version is v0.1.0 with an MIT license. The package metadata declares peerDependencies: react ^18.2.0.

This plugin addresses the issue of customizing the DSH Web appearance: if you want to use different backgrounds for the main interface and the trajectory page, or want to adjust the transparency and text readability of panels on the background, you can configure it directly in the DSH Web settings page instead of modifying DSH itself.

Core Features

The verified features include:

  • Change background images in the DSH Web interface.
  • Independent wallpapers for the main interface / trajectory page.
  • Sidebar automatically follows the current page’s wallpaper.
  • No wallpaper.
  • Preset gradients: 8 built-in gradients.
  • Upload images / Import folders / Crop images into the image library.
  • Crop: Drag to select the area to keep and output a new image.
  • Blur 0–50px.
  • Surface opacity 0–1.0.
  • Semi-transparent panels.
  • Main interface text color: Auto / Light / Dark / Custom color picker.
  • Fill and position adjustment: Crop fill / Fit / Stretch, horizontal / vertical position.
  • Interface language: Chinese / English.
  • Trajectory page color scheme: DSH Native / Clear / Jade.
  • Original image bytes stored in browser IndexedDB.
  • Current selection + effect parameters stored in localStorage.
  • Closing the master switch restores the original DSH appearance.

The “independent wallpapers” here refer to the ability to configure backgrounds separately for the main interface and the trajectory page. The trajectory page also provides three color schemes: DSH Native, Clear, and Jade.

Storage

The storage of dsh-wallpaper is divided into two parts:

  • Original image bytes: Stored in browser IndexedDB.
  • Current selection + effect parameters: Stored in localStorage, saving only metadata, which is very small.

Images are not compressed or converted to Base64, so the capacity is not limited by the localStorage 5MB limit.

It should be noted that images are stored on the browser side. When the browser clears site data, clears cache, or uses privacy mode, related image data may be cleared together; switching to another browser will not automatically share the data.

Installation

Below are several installation methods. Before installing, confirm whether the web profile has been initialized; if not, run it once:

dsh web

The plugin runs with the permissions available to the current dsh process. It is recommended to check the source code and license before installing.

Install from GitHub

It is recommended to install v0.1.0 from GitHub:

dsh plugin --profile web add github:RNlao/dsh-wallpaper#v0.1.0

Install from Release

Download dsh-wallpaper-0.1.0.tgz from a Release, then execute locally:

dsh plugin --profile web add /path/to/dsh-wallpaper-0.1.0.tgz

The /path/to/dsh-wallpaper-0.1.0.tgz here needs to be replaced with the actual file path you downloaded.

When installing from source, clone the repository first:

git clone https://github.com/RNlao/dsh-wallpaper.git

Then execute:

dsh plugin --profile web add link:./dsh-wallpaper

You can also download the ZIP, extract it, and execute from the parent directory:

dsh plugin --profile web add link:./dsh-wallpaper-main

link: is a development link, not a permanent installation. The plugin will continuously rely on that source code directory; if the directory is moved or deleted, the plugin will become invalid.

If you modify lib/client.js, you do not need to relink or restart the service; the DSH client HMR will automatically reload. If it does not immediately reflect in the browser, force refresh the browser.

Uninstallation

The uninstallation command is:

dsh plugin --profile web remove dsh-wallpaper

Enable and Refresh

After installation, open:

Settings → Wallpaper / Wallpaper

If dsh web is running, the process needs to be restarted after the first installation or uninstallation, and the browser needs to be force refreshed for the new profile bundle list to take effect.

Browser force refresh shortcuts:

  • macOS: Cmd+Shift+R
  • Windows / Linux: Ctrl+Shift+R

If the host or mount configuration changes, dsh web needs to be restarted. This plugin is a pure browser implementation; the host is a mostly empty plugin with no operating system-specific code.

Typical Usage

The following is a reproducible usage workflow:

  1. Install the plugin from GitHub:
dsh plugin --profile web add github:RNlao/dsh-wallpaper#v0.1.0
  1. If the web profile has not been initialized, run it first:
dsh web
  1. Open the DSH Web interface and go to:
Settings → Wallpaper / Wallpaper
  1. Select the wallpaper source:
  • No wallpaper
  • One of the 8 built-in gradients
  • Upload image
  • Import folder
  • Crop image
  1. Adjust display effects:
  • Blur: 0–50px
  • Surface opacity: 0–1.0
  • Main interface text color: Auto / Light / Dark / Custom color picker
  • Fill and position: Crop fill / Fit / Stretch, horizontal / vertical position
  • Trajectory page color scheme: DSH Native / Clear / Jade
  1. If you want to restore the original DSH appearance, simply turn off the master wallpaper switch.

Platform and Browser Notes

dsh-wallpaper is cross-platform, with consistent functionality on Windows / macOS / Linux. Differences are mainly in paths and browser shortcuts:

  • Data directory:
  • macOS / Linux defaults to ~/.dsh
  • Windows defaults to %USERPROFILE%\.dsh
  • Installation commands: GitHub, Release, and source code link:./dsh-wallpaper are the same across platforms.
  • Browser force refresh:
  • macOS: Cmd+Shift+R
  • Windows / Linux: Ctrl+Shift+R

Importing folders depends on webkitdirectory: supported by Chrome / Edge / Safari, but not Firefox; single image upload does not depend on it, so single image upload is more universal on the browser side.

The background color channel for semi-transparent panels is taken from the current DSH design-platform.css. If the token color values are adjusted in the future, the transparency appearance may change slightly; this is a visual difference, not changing the basic functionality of the plugin.

Applicable Scenarios and Notes

dsh-wallpaper is suitable for users who need to customize backgrounds in DSH Web, adjust panel transparency, configure trajectory page color schemes, or want to manage multiple wallpapers using an image library.

Notes before use:

  • The plugin is maintained by the community, the current version is v0.1.0, and the license is MIT.
  • The plugin runs with the permissions available to the current dsh process; check the source code and license before installing.
  • Images are stored in browser IndexedDB; clearing site data or using privacy mode may cause image loss.
  • link: installation depends on the source code directory; the plugin becomes invalid after the directory is moved or deleted.
  • Importing folders is affected by browser webkitdirectory support; Firefox does not support it.
  • After the first installation or uninstallation, if dsh web is running, the process needs to be restarted and the browser force refreshed.

Related Links

Verified repository address:

https://github.com/RNlao/dsh-wallpaper

The community directory page address is not listed in this article because there is no confirmed directory page URL in the verified information.