Introduction

In the DeepSeek Harness (DSH) Web interface, the background is usually fixed. For those who wish to temporarily change the background based on a project, a demo, or a local workspace, DSH’s plugin mechanism provides a way to extend it. dsh-bgwall-plugin is used to change the Web interface background to any image, which can be from a remote URL or a local server file, and provides adjustments for opacity, blur, and tiling mode.

Below introduces what this plugin can do, how to install, how to use it, and precautions to take when using it.

What is this

dsh-bgwall-plugin is a DSH plugin used to modify the DeepSeek Harness Web interface background. It is maintained by hubo980205, licensed under MIT, and implemented using pure JavaScript without a build step.

After installation and enabling, a “Background Image” page will be added to the “Settings” in DSH Web. The control panel is located at:

Settings → Background Image

This plugin primarily solves the problem of the Web interface background being non-customizable. You can use remote image URLs or local file paths on the server, and adjust the display effect in real-time in the interface.

Core Features

Verified plugin capabilities include:

  • Background image source:
  • Remote image URL
  • Server local file path
  • Relative path resolved based on workspace root directory
  • Opacity: Real-time adjustment from 0–100%, smoothly blending the image with the original interface background color without causing a black screen
  • Blur: 0–40px
  • Tiling mode: Fill / Fit / Stretch
  • “Sidebar background also transparent” toggle
  • One-click “Clear Background”
  • Local images are loaded via Host HTTP route with same-origin, avoiding the issue of long data URLs failing in CSS
  • Local image single-file limit: 15MB

Installation and Enablement

Use the dsh plugin command to install from GitHub:

dsh plugin --profile web add github:hubo980205/dsh-bgwall-plugin

After installation is complete, restart the dsh web profile and refresh the browser:

dsh --profile web

This step is necessary because Host lines and client lists are scanned at startup. After refreshing, the “Background Image” page will appear in “Settings” in the bottom left corner.

If manual installation is required, you can place this package into:

$DSH_HOME/profiles/node_modules

Then append to cordis.patch.yml in that profile:

- insert: [{ id: bgwall, name: dsh-bgwall-plugin }]

To uninstall, use:

dsh plugin --profile web remove dsh-bgwall-plugin

Typical Usage

After installation and restart, open “Settings” in the bottom left corner and enter the newly added “Background Image” page.

1. Using a Remote Image URL

Paste the image URL in the “Image Source” area, for example:

https://example.com/wallpaper.jpg

Then click “Apply”.

2. Using a Server Local File

Fill in the server local path in the “Image Source” area, for example:

dog.jpg

or:

/root/pic.png

Then click “Load”.

Relative paths will be resolved based on the workspace root directory. Local images are loaded via Host HTTP route with same-origin, with a single file limit of 15MB.

3. Adjusting Display Effects

After applying or loading the image, you can:

  • Drag the “Opacity” slider
  • Drag the “Blur” slider
  • Select “Tiling Mode”: Fill / Fit / Stretch
  • Turn on or off “Sidebar background also transparent”

These adjustments will be previewed in real-time on the page.

4. Restoring Default Background

If you need to cancel the current background, simply click “Clear Background” for one-click restoration.

Use Cases and Notes

This plugin is suitable for the following use cases:

  • Using the DSH Web interface and wanting to temporarily change the background
  • Wanting to use remote image URLs or server local files
  • Needing to adjust opacity, blur, and tiling mode
  • Not wanting to introduce build steps, only needing a pure JavaScript plugin

Precautions before use:

  • The plugin will be loaded in the current DSH process, so you should check the source code and license before installing.
  • This plugin’s license is MIT.
  • The background state is session memory state and is not persistent; the background will return to default after the page is refreshed.
  • The local image single-file limit is 15MB.
  • Relative paths are resolved based on the workspace root directory.
  • After installation or manual installation, you need to restart dsh --profile web and refresh the browser.

Links

GitHub Repository:

https://github.com/hubo980205/dsh-bgwall-plugin

The verified data does not include a community directory page URL, so this article does not list a specific directory page address. The DSH community directory is an independent site and has no official affiliation with DeepSeek / FanHuan.