Introduction

The philosophy of DeepSeek Harness (DSH) is “Everything is a plugin”. When customizing the interface in dsh web, common issues arise: a background that is too obvious affects readability, while a panel that is too transparent makes the interface unclear. HaoyueQin/deepseek-harness-background addresses this scenario by providing a custom background image for DeepSeek Harness Web GUI (dsh web): you can upload local images, paste image URLs, and adjust opacity, readability masks, panel transparency, and frosted glass blur.

The community plugin directory is an independent site with no official affiliation to DeepSeek / FlowState. Below is an introduction to the positioning, capabilities, usage, and notes of this plugin.

What is this

  • Plugin: HaoyueQin/deepseek-harness-background
  • Maintainer: HaoyueQin
  • Target Interface: DeepSeek Harness Web GUI (dsh web)
  • License: MIT
  • Repository: https://github.com/HaoyueQin/deepseek-harness-background

It renders the custom background behind the application surface and provides a real-time preview within the settings panel. Local images are stored under harness home and provided via same-origin routing; remote images support http(s) links.

Core Features

Image Sources

Two types of sources are supported:

  1. Upload local JPG / PNG / WebP / GIF images.
  2. Paste http(s) image links.

Local upload is only accepted when the declared MIME type, detected signature, and extension are consistent.

Preview & Submission

  • Real-time preview of the image, mask, and frosted glass effects within the settings panel.
  • Slider steps by 5%.
  • Blur radius steps by 1/2px.
  • Redraws only while dragging the slider; submits on release.

Five Controls

The plugin provides the following controls:

  1. Background Opacity
  2. Readability Mask
  3. Panel Opacity
  4. Frosted Glass Blur
  5. Background Blur

Adaptation modes support:

cover
contain

Where cover is fill crop and contain is full display.

Mask

The plugin automatically uses a white or black mask based on the light/dark theme.

Frosted Glass

The plugin enables the frosted glass effect on the specified surface while preserving the official opaque drawing on the reading surface.

If you need to restore the official opaque drawing on whitelisted surfaces, you can set panelOpacity to 100%:

panelOpacity = 100%

Third-party Glass Registration

The plugin provides a third-party glass registration interface:

window.__DSH_BACKGROUND_GLASS__

And the event:

dsh-background-glass:ready

Third-party plugins can register their own glass panels. This registration interface gracefully degrades if this plugin is missing.

Session Timeline Enhancement

The plugin provides session timeline enhancement for dsh ≥ 0.1.2, such as smooth scrolling for loaded nodes. This behavior is limited by capability checks rather than version comparison.

Dependency Declaration

peerDependencies declared in package.json include:

@deepseek-ai/cordis ^4.0.1
react ^18.2.0

And specific @deepseek-ai/dsh-client-* version ranges.

Installation and Enablement

No official installation command was provided in the verified materials, so commands in the form of dsh plugin add ... are not provided here, nor are installation commands constructed based on the repository name. Please refer to the repository documentation or instructions in the plugin directory before enabling.

The plugin will run with the permissions of the current dsh process. It is recommended to check the source code, license, and dependency ranges before installing. The license for this plugin is MIT.

Typical Usage

The usage provided in the materials is as follows:

  1. Upload a local JPG / PNG / WebP / GIF image in the settings panel.
  2. Paste an http(s) image link and press Enter.
  3. Drag the sliders to preview in real-time, and it will automatically submit upon release.
  4. Select the adaptation mode cover (fill crop) or contain (full display).
  5. Set panelOpacity to 100% to restore the official opaque drawing on whitelisted surfaces.
  6. Register third-party glass panels via window.__DSH_BACKGROUND_GLASS__ and the dsh-background-glass:ready event.

Suitable Scenarios and Notes

Suitable for:

  • Users who want to add a custom background to dsh web while maintaining text readability.
  • Developers who need to adjust background, mask, panel transparency, and blur effects.
  • Third-party plugin authors who need to integrate custom panels into a unified glass effect.
  • Users on the dsh ≥ 0.1.2 session timeline who want smooth scrolling for loaded nodes.

Notes:

  • Local upload is only accepted when the declared MIME type, detected signature, and extension are consistent.
  • Uploaded images are stored under harness home and provided via same-origin routing.
  • The plugin runs with the permissions of the current dsh process; you should check the source code and license before installing.
  • Setting panelOpacity to 100% restores the official opaque drawing on whitelisted surfaces.
  • The third-party glass registration interface gracefully degrades if this plugin is missing.
  • Session timeline enhancement targets dsh ≥ 0.1.2 and limits behavior through capability checks rather than version comparison.
  • This article does not provide unverified installation commands; the star count and directory page content were not verified in the data fetched for this article.

Links

  • GitHub: https://github.com/HaoyueQin/deepseek-harness-background
  • Plugin Directory Clue: https://www.skillhub.cn/plugins/HaoyueQin/deepseek-harness-background (This URL comes from a plugin clue and was not verified in the data fetched for this article)