dsh-wallpaper

August 20, 2026 · View on GitHub

A wallpaper / background plugin for the DeepSeek Harness Web UI. Add a background image to the harness window that auto-adapts to any screen: the image is scaled with CSS cover, so it looks right on 1080p, 2K, 4K, or any display scaling, and the translucent surface colors follow light/dark theme automatically.

Built-in preset enabled by default, custom image URL support, and an opacity slider — all from the Settings → General → Wallpaper row, with no Host restart and no plugin configuration.

Features

🌄 Built-in preset on by default — the bundled "Origami" wallpaper (2560×1440) is applied immediately on a fresh profile
🖼️ Custom image URLs — paste any same-origin path (/wallpapers/xxx.jpg) or full https://… URL and hit Apply
🔄 On/off switch — one click to toggle the background
🎚️ Opacity slider — 30%–100% surface translucency, with separate values for light and dark themes
📐 Any screen — CSS cover scales and centers the image regardless of resolution, window size, or display scaling
⚡ Pure client-side — persists via localStorage, no Host schema registration, no dsh web restart, HMR-friendly

Install

From this repository:

dsh plugin add https://github.com/fubao885522/dsh-wallpaper

From this checkout (development):

pnpm install
pnpm build
cd ..
dsh plugin add ./dsh-wallpaper

Remove:

dsh plugin remove dsh-wallpaper

Usage

Open Settings → General.
Find the Wallpaper row (below Appearance).
Click Origami to apply the built-in preset, or paste an image URL and click Apply.
Use the toggle to turn the background on/off and the slider to adjust translucency.

The setting is stored per browser (localStorage), so it survives page reloads and HMR reloads.

How it adapts to any machine

The image is rendered with background-size: cover; background-position: center, so any resolution, aspect ratio, or DPI scaling is handled automatically.
Surface colors are written as the same --dsw-alias-* tokens the harness frame uses, made translucent; body[data-ds-dark-theme] selects the dark palette values, so readability holds in both themes.
Opacity is clamped to a readable range (0.3–1.0) and stored as a plain number.

Compatibility

Plugin	DeepSeek Harness
`0.1.x`	`0.1.0-rc.5` / `0.1.0-rc.6` (Web GUI)

License

MIT