Introduction

Most people using DSH spend most of their time on the Web GUI. The official interface style is fixed. There is no ready-made entry to change the background image of the entire page or customize the color scheme to your liking. qe2592008/dsh-ui-customizer solves this problem: it adds two sub-menus, “Background Image” and “Theme,” to the official settings modal, supporting image/video wallpapers and full-interface color customization. Below is an introduction to its features, installation, and uninstallation methods, based on the plugin’s README and package.json.

What is This

dsh-ui-customizer (GitHub repository qe2592008/dsh-ui-customizer, npm package name @dsh-external/dsh-client-ui-customizer, version 0.1.0) is a UI customization plugin for the DeepSeek Harness Web GUI, licensed under MIT, maintained by qe2592008.

Instead of creating a separate independent interface, it embeds the two sub-menus “Background Image” and “Theme” into the official settings modal. They are located immediately after “General Settings” and open/close together with the official modal. You can see them by clicking “Settings” in the sidebar.

Core Features

Background Image: Wallpaper for the Entire Web Interface

The “Background Image” sub-menu places the background behind all content, creating a wallpaper effect:

  1. “Background Type” is an either/or choice between Image and Video, both supporting network URLs or local uploads.
  2. Files uploaded locally are automatically saved to the images/ folder in the plugin directory, so they won’t be lost even if you switch browsers or clear site data. Upload limits: 100 MB for videos, 10 MB for images.
  3. Videos support mp4 / webm / ogv / mov, playing in a muted loop and not participating in cropping; click to play in the preview area. Playback progress is not lost during the open/close of the settings modal.
  4. The three sliders for Opacity/Blur/Darken apply to both images and videos, taking effect in real-time; blur range 0–24px, darkening overlay 0–90%.

Image backgrounds have additional refined capabilities:

  • Interactive crop preview: Use the scroll wheel or hold the middle mouse button and drag up/down to zoom, left-click and drag to pan. Only the area selected in the preview will be used as the background; “Reset” restores the full image with one click.
  • Four stretch modes: Fill (cover, default) / Fit (contain) / Tile / Stretch (fill); when cropping is active, Tile falls back to Fill.
  • Recently used: Automatically keeps the last 10 background images used. Click a thumbnail to switch; click ✕ in the top-right corner to delete.

Theme: 50 Interface Color Customizations

The “Theme” sub-menu customizes the colors of interface elements via color pickers, totaling 50 items covering backgrounds, text, modals, buttons, states, fonts, etc. They are organized into 8 collapsible groups and work in both light and dark themes. “Restore Defaults” allows you to revert all changes with one click.

Configured themes can be saved in any number of copies. When saving, you can include the current background (image or video) and apply or delete them later at any time.

Font Presets

Regarding fonts, it provides 2 font tokens with a total of 42 presets (system fonts + popular open-source fonts), selectable via dropdown. The plugin will automatically detect if the corresponding font is installed on the machine; uninstalled ones will be marked as “Not Installed.”

General Behavior

All settings are automatically saved and persist after refreshing the page; the interface supports both Chinese and English. Performance-wise, the background video automatically pauses when the settings modal is opened and seamlessly resumes when closed, unaffected by the modal’s open/close state.

Installation and Activation

Execute the following in the DSH installation directory (where dsh can be run):

dsh plugin --profile web add github:qe2592008/dsh-ui-customizer

For development scenarios, you can use a local path link method for installation, where changes to the source code take effect immediately:

dsh plugin --profile web add D:\Work\工作目录\dsh-ui-customizer

The plugin comes with a dsh.bundle activation layer (cordis.patch.yml). After installation, it automatically activates the ui-customizer entry, so you don’t need to manually modify $DSH_HOME/profiles/web/cordis.patch.yml. After the steps above, restart DSH Web for it to take effect. You can see the two sub-menus “Background Image” and “Theme” by clicking “Settings” in the sidebar.

Two supplementary notes:

  1. This plugin does not depend on any npm packages, so no network is required during installation.
  2. dsh plugin relies on pnpm. If it is not installed on the machine, you can install it manually as described in the README: junction the plugin directory to $DSH_HOME/profiles/web/node_modules/@dsh-external/dsh-client-ui-customizer, register the dependency in the profile’s package.json, and add @dsh-external/dsh-client-ui-customizer to dsh.profile.bundles.

Uninstallation

First, execute:

dsh plugin --profile web remove @dsh-external/dsh-client-ui-customizer

Then rebuild the profile: execute dsh plugin --profile web add again (for any installed package) to trigger reconcile. The plugin entry will be automatically removed from the bundles list as the dependency is removed.

Applicable Scenarios and Notes

This plugin does not change DSH’s functional behavior, only the visual appearance of the Web interface. It is categorized as “Fun Outfit” in the community directory and is suitable for developers who want to stare at a pleasing interface for a long time.

Notes before use:

  1. The plugin runs with the permissions of the current DSH process. Before installing third-party plugins, you should read the source code and confirm the license. This plugin is MIT, and the README matches the license field in package.json.
  2. Local uploads have size limits (100 MB for videos, 10 MB for images); videos do not participate in cropping, so use images when precise framing is needed.
  3. When cropping is active, the Tile stretch mode will fall back to Fill.

Conclusion

dsh-ui-customizer turns visual needs like “changing wallpapers and adjusting colors” into two sub-menus in the official settings modal: automatic saving of settings, persistence of local uploads, and automatic activation after installation. It works right after installation. Project addresses:

  • GitHub: https://github.com/qe2592008/dsh-ui-customizer
  • Community Plugin Directory: https://www.skillhub.cn/plugins/qe2592008/dsh-ui-customizer

The directory is an independent community site and has no official affiliation with DeepSeek or Huanfang.