Foreword

In the “everything is a plugin” scenario of DSH, the background of the web interface typically relies on default themes or manual replacement of static files. If you have already downloaded a batch of wallpapers through Wallpaper Engine on your local machine and wish to directly select image or video backgrounds in the DeepSeek Harness Web, dsh-wallpaper-engine provides this pathway.

The DSH community directory is an independent site and has no official affiliation with DeepSeek /幻方. Below, we introduce the capabilities, installation, and configuration of this plugin.

What is this

dsh-wallpaper-engine is maintained by sakuraaa667, licensed under MIT. Its purpose is to integrate wallpapers already downloaded in your local Wallpaper Engine into the DeepSeek Harness Web interface, serving as the page background.

Core Features

The following describes its supported content based on usage paths.

Automatic Discovery of Downloaded Wallpapers

  • Steam Workshop wallpapers: Corresponds to app 431960, automatically reads libraryfolders.vdf, and supports multiple Steam libraries.
  • Wallpaper Engine local projects: Covers projects/myprojects and projects/defaultprojects.

Browsing and Synchronization

  • Browse thumbnails, search, and apply wallpapers with one click in “Settings → Wallpaper Wallpaper Engine”.
  • When the wallpaper page is open, it silently rescans the disk every 30 seconds, and newly downloaded wallpapers will appear automatically.
  • You can also click “Refresh” to update immediately.

Display and Readability

  • Video wallpapers are played using <video> with muted + loop.
  • Image wallpapers prioritize the highest resolution original image within the directory and support two adaptation modes: “Fill” and “Fit”.
  • Provides “Panel Dimming (0–100%)” and “Background Dimming (0–50%)” sliders to control readability.

Persistence

  • The selected wallpaper is persisted to $DSH_HOME/dsh-wallpaper.json.
  • It automatically restores after restart or refresh.

Installation and Enablement

For the runtime environment, package.json declares:

  • engines.node requires >=22
  • peerDependencies includes @deepseek-ai/cordis ^4.0.1

Execute the installation command in the DSH installation directory or any directory, replacing the path after file: with your local plugin directory:

dsh plugin --profile web add file:C:\path\to\dsh-wallpaper-engine

Before installation, you should review the source code and the MIT license. The plugin will run with the current dsh process permissions.

Typical Usage

  1. Open the DeepSeek Harness Web interface.
  2. Go to “Settings → Wallpaper Wallpaper Engine”.
  3. Click any wallpaper card to set it as the background.
  4. Click “Clear Background” again to restore the default.

If you add new wallpapers in Wallpaper Engine, they will be automatically rescanned when you open the wallpaper page; you can also click “Refresh” to update immediately.

Configuration

The plugin supports overriding directory configurations by id in the profile’s cordis.patch.yml:

- id: dsh-wallpaper-engine
  config:
    workshopDir: "<workshop directory>"
    projectsDir: "<projects directory>"

Here, workshopDir specifies the Workshop wallpapers directory, and projectsDir specifies the local projects directory.

Environment variables are also supported:

  • DSH_WALLPAPER_WORKSHOP_DIR
  • DSH_WALLPAPER_STEAM_DIR

HTTP Routes

The plugin provides the following routes for wallpaper lists, current selections, thumbnails, and media file access:

/dsh-wallpaper/list
/dsh-wallpaper/config
/dsh-wallpaper/preview/<id>
/dsh-wallpaper/file/<id>

All ids are looked up through mappings generated by scanning and are not used in path concatenation to avoid path traversal.

Use Cases and Notes

Suitable for scenarios where you use Wallpaper Engine locally and wish to directly apply downloaded wallpapers as backgrounds for the DeepSeek Harness Web.

Please note:

  • Scene-type and web-type wallpapers cannot be rendered in real-time in browser backgrounds and will fall back to preview images.
  • Videos are streamed via local HTTP, accessible only locally, defaulting to loopback.
  • The path in the installation command is a placeholder example and must be replaced with the actual plugin path.
  • It is recommended to read the source code before installation and confirm that the MIT license meets your usage requirements.

Links

  • GitHub: https://github.com/sakuraaa667/dsh-wallpaper-engine
  • Directory page: This material does not provide a verifiable URL. You can search for the plugin by name dsh-wallpaper-engine in the DSH community directory.