DSH’s plugin-based architecture allows developers to extend functionality, and visual customization usually requires modifying code or using complex theme configurations. sz1698/dsh-bg-new focuses on solving the background customization problem in the web interface. It does not rely on cloud services; instead, it uses local media serving and instant rendering to let users quickly switch the background among system presets, solid colors, gradients, images, or videos.

This is a plugin for changing the background of the DeepSeek Harness web interface. The author is sz1698, and the open-source license is MIT. It provides a sidebar entry and a drawer-style UI, supports five background modes—system preset, solid color, gradient, image, and video—and includes local media serving, a frosted glass effect, and a model instruction tool.

Core Features

  1. Five background modes: Supports system presets, solid colors, gradients, and images or videos (local files or remote links).
  2. Drawer-style interaction: Click the “Wallpaper” button in the sidebar (above Settings) to open a right-side drawer. While the drawer is open, the left sidebar and chat area automatically collapse and reduce in opacity to focus on background adjustment; click outside the drawer to close it.
  3. Zoom and positioning: For small images, supports mouse-wheel zooming and drag positioning. If the pointer is dragged outside the image, a 2-second grace period is applied before releasing.
  4. Fit and focus: Provides five fit modes, including fill / cover / contain, and supports horizontal and vertical focus adjustment, along with free zoom and zoom-in focus options.
  5. Frosted glass effect: Lets panels, chat bubbles, and the input box display translucent, frosted surfaces.
  6. Dynamic wallpaper: Supports local MP4 loop playback, with muting or volume adjustment; video file size is unlimited.
  7. Model instruction tool: Provides the bg_apply tool, allowing the model to change the background directly through instructions (for example, “change the background to deep blue” or “use this image as the wallpaper”).
  8. Text theme: Supports automatically inferring text color based on background brightness, or manually specifying a light or dark theme.
  9. Local storage: Uploaded images and videos are stored only in the local data directory and served through the plugin’s own routes; they are never uploaded to any cloud service.

Installation and Enabling

Prerequisites: DSH is installed and dsh web runs normally.

Method 1: git channel

dsh plugin --profile web add github:sz1698/dsh-bg-new

If the dsh command is not in PATH:

npx -y --package @deepseek-ai/dsh dsh plugin --profile web add github:sz1698/dsh-bg-new

After installation, restart the application or dsh web, then refresh the browser to apply the changes.

Method 2: local clone (development / personal use)

git clone https://github.com/sz1698/dsh-bg-new.git
cd dsh-bg-new
npm install && npm run build
dsh plugin --profile web add .

Typical Usage

Via the interface:
Click the “Wallpaper” button in the sidebar, then select a background type in the right-side drawer for configuration. You can use the mouse wheel to zoom images and drag to adjust their position.

Via a model instruction:
Enter “change the background to deep blue” or “use this image as the wallpaper” in the dialog. The bg_apply tool executes the request.

bg_apply tool parameters:
Supports color, gradient, image, video, local file, and close.

Notes

  • This is an unofficial community plugin. Evaluate compatibility and security before use.
  • All media files are stored locally and are never uploaded to cloud services.
  • The plugin version is 0.7.0.

Summary

This plugin provides flexible background customization through a sidebar drawer and local media serving, without relying on cloud services. It is suitable for users who want to deeply customize the visual experience of the DSH web interface.

Related resources:
* Community directory
* GitHub repository