In DeepSeek Harness (DSH) Desktop Edition, interface style personalization is often limited by the core code. Although the default background is practical, it may not meet user needs for distinguishing different sessions or improving visual comfort. The dsh-background plugin uses an overlay approach to let users directly change the window background and adjust the mask intensity without modifying DSH’s core logic, enabling low-cost personalization.

Plugin Overview

dsh-background is a fun customization plugin maintained by SnoWinKK, designed specifically for DSH Desktop. Through image selection, mask intensity adjustment, and command operations, it allows customization of the DSH desktop UI background and supports local persistent configuration.

Core Features

  • Image selection: Supports PNG, JPG, WebP, and GIF formats, with a file size limit of 8MB.
  • Mask adjustment: Provides darkening and brightening functions; adjust the mask intensity via panel buttons or the command menu to accommodate images with different brightness levels.
  • Shortcut command: Supports typing /background in the chat box to open the control menu.
  • Restore default: Provides a clear button or command to restore the initial state with one click.
  • Local persistence: Image settings are persisted locally via localStorage and are not lost after restarting the application.
  • Configuration file: Supports presetting the image path and mask intensity through the ~/.config/dsh-background/config. file.

Installation and Activation

Install this plugin using DSH’s CLI tool. Replace <profile> with your configuration profile name (usually desktop for the Desktop Edition).

dsh plugin --profile <profile> add github:SnoWinKK/dsh-background

After installation, restart DSH to load the plugin.

Typical Usage

  1. Set the background image: Open the Settings menu, select the “General” option, and click the image selection button in “Custom Background”.
  2. Command operation: Type /background in the chat box to open the control menu.
  3. Adjust the mask: Click the darken (◐) or brighten (◑) button on the panel, or select it in the /background menu.
  4. Clear the background: Click the clear button in the menu to restore the default background.

Applicable Scenarios and Notes

  • Environment requirements: This plugin is only compatible with DSH Desktop and is not compatible with the web version; it requires Node.js version >= 20.
  • File limit: The uploaded background image must not exceed 8MB.
  • Configuration priority: If both a configuration file and local storage exist, the configuration file takes precedence over localStorage.
  • License: The plugin is open source under the MIT License.

Summary

With dsh-background, users can personalize the DSH interface at low cost. The plugin has a clear structure and active maintenance, making it suitable for developers or users who want to optimize the visual experience of the desktop application.