Introduction

The default theme of the DeepSeek Harness (DSH) web interface is relatively fixed. If you spend long hours debugging agents and viewing conversation trajectories in the Harness, the solid background and uniform control styles can easily appear monotonous and make it difficult to distinguish different areas like the sidebar, conversation cards, and input fields.

There are many “theming” approaches within the community, but most can only change a single background image or overall color tone, making it challenging to finely control the transparency and blur of various UI elements. The dsh-any-background plugin introduced below is a DSH appearance plugin maintained by Tkingxiao (SkillHub category: Fun Customization; approximately 16 stars on GitHub). It targets the web interface, managing the theme color, wallpaper, and per-element transparency/blur within a unified settings panel.

What This Is

dsh-any-background is a DeepSeek Harness appearance plugin, currently at version 0.2.1, licensed under MIT. Its core purpose is to allow customization of the Web UI’s theme color, background wallpaper (image or video), and the individual adjustment of transparency and frosted glass blur for the main background, sidebar, card panels, input fields and controls, settings panel, and other areas, all without modifying the Harness source code.

Configuration is written to the file system at ~/.dsh/.dsh-any-background-data/, avoiding reliance on localStorage. The interface supports automatic switching between Chinese and English. The plugin also includes a theme guardian mechanism that reactivates custom styles after the host resets the theme.

Core Features

Theme Color

  • PS-Style Color Wheel: Select a hue on the color wheel and adjust saturation and brightness in the embedded square to generate over 30 CSS design tokens in real-time.
  • Precise HSL / RGB Input: Values and the color wheel are bidirectionally synchronized.
  • Smart Color Picking: One-click sampling and quantization of pixels from the visible area of the wallpaper, filtering out grays/near-black/near-white to select a vibrant color as the theme color. For video wallpapers, frames are automatically extracted for this process. All done client-side.
  • Eyedropper Tool: Hover over the wallpaper to preview and click to set the theme color.

Background Wallpaper

  • Image Wallpaper: Upload any image and use the viewport-ratio editor to drag, pan, and zoom with the scroll wheel.
  • Video Wallpaper: Muted looping playback that persists across refreshes (disk persistence + HTTP streaming playback, supporting Range seeks). Frames are automatically extracted for preview, color picking, and position editing.
  • Position Editor: Images and videos share drag/zoom/reset operations, but their position states are saved independently.
  • Layout Modes: Five modes – Adapt, Fill, Stretch, Tile, Center – apply to both images and videos.
  • Dynamically Generated Backgrounds: Grid gradients, shaders, and geometric patterns, with adjustable spread range, color intensity, and seed locking.

Interface Transparency and Blur

  • Per-Element Transparency: Individual sliders for the main background, sidebar, card panels (including dropdown menus and pop-ups around conversation windows), input fields and controls (send box, Cordis plugin panel), settings panel, and wallpaper.
  • Per-Element Blur: Each element can have a 0–60 px backdrop-filter frosted glass effect applied. The send box and Cordis panel achieve true background blur via stable host selectors (e.g., [data-composer-card], [data-cordis-panel]).
  • Conversation View Cards: Message lists are automatically wrapped in semi-transparent cards. On the trajectory page, transparency and blur can be adjusted for the entire page, allowing the wallpaper to show through from behind the content.

Configuration Sharing and Persistence

  • Export / Import: One-click export to a self-contained dsh-any-theme.json (configuration + wallpaper, with videos embedded as data URLs), which can be imported and restored in other environments.
  • Large Video Upload: Uses HTTP binary POST streaming to disk, bypassing base64 and RPC channel body limits.

Installation and Activation

It is recommended to install via the DSH plugin command (source: GitHub README and SkillHub directory page):

dsh plugin --profile web add github:Tkingxiao/dsh-any-background

If the plugin has been published to the npm registry, you can also use:

dsh plugin --profile web add dsh-any-background

After installation, start the web interface:

dsh web

The plugin will appear under the “Theme” category in the settings panel.

If DSH is not installed globally, you can use npx:

npx @deepseek-ai/dsh plugin --profile web add github:Tkingxiao/dsh-any-background
npx @deepseek-ai/dsh web

For local development and building (lib/ is committed, so building is generally unnecessary; re-bundling is required after modifying src/):

git clone https://github.com/Tkingxiao/dsh-any-background.git
cd dsh-any-background
pnpm install
pnpm run bundle
pnpm dsh plugin --profile web add "dsh-any-background"
pnpm dsh web

Typical Usage

After the installation steps above, open dsh web and navigate to the “Theme” section in the settings panel to operate. The common workflow is as follows:

  1. Set Wallpaper: Upload an image or video, or select a grid gradient/shader/geometric pattern from “Dynamically Generated Background”. Use the position editor to drag, pan, and zoom with the scroll wheel, and choose one of the layout modes: Adapt, Fill, Stretch, Tile, or Center.
  2. Define Theme Color: Use the color wheel or HSL/RGB input to set a precise color; alternatively, click “Smart Color Picking” to extract a color from the wallpaper, or use the eyedropper to pick directly on the wallpaper.
  3. Adjust Interface Layers: Individually drag the transparency sliders for the main background, sidebar, card panels, input fields and controls, settings panel, etc. As needed, add 0–60 px blur to each element to create a frosted glass effect.
  4. Backup and Migration: Once satisfied, export dsh-any-theme.json. In a new environment, import it to restore the entire configuration (including the wallpaper and embedded video).

The exported file is a self-contained JSON, ideal for sharing a consistent visual setup across multiple machines or team members.

Applicable Scenarios and Notes

Who It’s For

  • Developers who spend long periods developing and debugging agents on the DSH web interface and want a clearer visual distinction between areas to reduce eye strain.
  • Scenarios where a team needs to standardize the Harness interface style and share configurations via JSON export/import.
  • Users who want to use video or dynamically generated backgrounds without manually editing CSS.

Compatibility

  • dsh web: Fully supported (see the “Compatibility” section in the README).
  • deepseek-harness-desktop: The README indicates support, but Electron packaging issues may cause the transparency display for the left sidebar and central area to be inverted, pending a desktop client update for a fix.

Security and Permissions

DSH plugins run with the permissions of the current dsh process and can read and write local files (this plugin stores data in ~/.dsh/.dsh-any-background-data/). Before installation, it is recommended to review the GitHub source code and the MIT license to ensure they align with your security policies.

SkillHub (directory page) is a community plugin directory and has no official affiliation with DeepSeek / High-Flyer; the DSH ecosystem philosophy is “everything is a plugin,” and this plugin is one such example.

Conclusion

dsh-any-background brings together the theme color wheel, image/video wallpapers, per-element transparency and blur, and configuration export/import into the Harness web settings panel, making it suitable for DSH users who need fine-grained control over the web interface’s appearance.