deepseekplugins

DeepSeek Harness plugin

dsh-webui-background

Standalone DeepSeek Harness plugin for a configurable Web UI background

UI Enhancements
Jump to install

Source facts

Repository
lx963/dsh-webui-background
Latest update
Aug 14, 2026
Category
UI Enhancements
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/lx963/dsh-webui-background
Plugin: dsh-webui-background
Author: lx963

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.en.mdSource · read only
README language

dsh-webui-background

简体中文

dsh-webui-background is a standalone DeepSeek Harness plugin that adds a configurable background to the Web UI. It installs through the Harness bundle and client-plugin extension points; it does not modify or replace files under website/public or apps/web/public.

Features

  • An embedded “Web UI background” settings tab with upload, drag-and-drop, and preview.
  • PNG, JPEG, GIF, and WebP support, detected from file bytes, with a 20 MiB limit.
  • Separate light- and dark-theme readability masks, applied immediately after saving.
  • Disable the background without deleting it, or reset to remove it and restore the stock UI.
  • Per-profile image and settings storage.
  • Read-only settings over remote connections; mutations require a loopback Web UI connection.

Install

This plugin requires a DeepSeek Harness release with external bundles and browser client plugins (0.1.0-rc.5 or newer).

pnpm dsh plugin --profile web add dsh-webui-background@next
pnpm dsh web

Run these commands from the DeepSeek Harness repository root. If dsh is globally installed and available on PATH, you can omit the leading pnpm. When PowerShell reports that dsh is not recognized, use pnpm dsh; npm dsh is not a valid npm command.

Restart an already-running Web UI. Then open “Settings → Plugins → Web UI background”, choose an image, and save.

To uninstall:

pnpm dsh plugin --profile web remove dsh-webui-background

Uninstalling does not remove profile data. Use “Reset to defaults” in the plugin first if you also want to remove the stored image.

File names

The uploaded source may have a normal .webp, .png, or other supported extension. The plugin detects the format from its contents. Its private profile copy uses an extensionless content-hash name by design. The browser receives it from /webui-background with the detected Content-Type, so the stored file does not need an extension.

Each profile stores data under its own data/webui-background/ directory. state.json contains the switch, masks, and revision; the image is named background-<sha256>.

Develop from source

git clone https://github.com/lx963/dsh-webui-background.git
cd dsh-webui-background
pnpm install
pnpm test
pnpm build

# Switch to the DeepSeek Harness repository root and pass the plugin's absolute path.
cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add /path/to/dsh-webui-background

prepack emits the Host ESM bundle, browser CJS bundle, and declarations. Development requires Node.js ^22.19.0 || >=24 and pnpm 10.

Security and limits

  • SVG is excluded because it may contain active content.
  • Image magic bytes are authoritative; the extension and browser-provided MIME type are not trusted.
  • Image responses use no-store and nosniff; the URL revision only refreshes the current image in the page.
  • A profile retains one current image, and optimistic revisions prevent browser tabs from silently overwriting one another.

License

[MIT](LICENSE)

Back to searchOpen GitHub repository

More related plugins

View category