Preface

DeepSeek Harness (dsh) is an open-source agent runtime released by DeepSeek, whose official repository summarizes its architecture in one sentence: everything is a plugin. The Web UI natively supports model configuration, workspace selection, and session management, with its appearance mostly following built-in themes. If you only want to adjust color schemes, add a corner glow effect, change the background image or loop a video, you don’t need to install a full character skin pack. The community plugin dsh-gui-customization integrates these options into Settings → Interface Settings.

Two important points need clarification first. DeepSeek Harness itself is released by DeepSeek; the plugin directory site deepseek-harness-plugin.com is an independent community index and has no official affiliation with DeepSeek / FunFound. All functions, installation commands, and version numbers below shall be cross-verified against the directory page, the plugin’s GitHub repository, the npm package, and the deepseek-ai/deepseek-harness official repository.

What is this

dsh-gui-customization is a theme customization plugin for DeepSeek Harness Web UI, maintained by LAN-TINA-WS, licensed under MIT, and primarily developed in TypeScript. It is categorized under “Themes & Appearance” in the directory. The repository calls itself a “fashion studio”: it supports changing theme colors, custom image or video backgrounds, and adjusting ambient lighting, with a bilingual Chinese-English interface.

This plugin is different from whale girl skins and desktop pets. Its functions focus on color schemes, glows, and backgrounds in the settings panel, rather than replacing the entire character artwork. The dsh.client.platform field in package.json is declared as web, meaning it only works for the web interface.

The current released version is 0.6.2 (released on 2026-08-16) on both npm and GitHub Release. As verified on 2026-08-17, the GitHub repository had 14 stars; the community directory page showed 10 stars at that time, so star counts should refer to the repository page.

Core Features

The feature descriptions in the root README and CHANGELOG of the repository can be cross-referenced as follows. The packages/dsh-gui-customization/README.md file still retains earlier records and to-do items, where entries like “separate light/dark editing” and “import/export” have been implemented in subsequent versions. The following description is based on the root README, CHANGELOG, and the release notes for version 0.6.2.

Color Schemes

  • The default theme is Nous Blue, with both light and dark modes.
  • One-click switching between four presets: System Default, Nous Blue, Indigo Purple, and Emerald Green.
  • There are 13 additional theme color fields that can be modified via color picker or text input, taking effect after clicking “Apply Color Scheme”.
  • Starting from CHANGELOG version 0.6.0, the dark theme has a separate set of 13 colors; presets will reset the dark color palette to a supporting scheme, and export, import, and persistence will carry both light and dark color sets simultaneously.

Ambient Lighting

The corner glow follows the main theme color. The settings include a toggle switch, intensity, breathing amplitude, and 5 position modes. Changes take effect immediately without refreshing the page.

Dynamic Backgrounds

  • Images: Select local images via the system file picker. The README notes the built-in preset “deepseek girl 01”, and CHANGELOG version 0.5.2 added “deepseek girl 02” and “deepseek girl 03”.
  • Videos: Also use the native file picker, with muted looped playback.
  • Images and videos are mutually exclusive; only one can be enabled at a time.
  • The main conversation area will show the background with a mask layer that adjusts with the light/dark mode.
  • Background transparency slider (range 10%–90% as recorded in CHANGELOG version 0.5.0) and sidebar transparency toggle.
  • Background files are stored in the browser’s IndexedDB, allowing recovery after page refresh or dsh restart.

The CHANGELOG also records two fixes encountered in actual use: starting from version 0.5.1, large images use Blob URLs to avoid some browsers discarding CSS data URLs larger than approximately 2 MB; version 0.5.3 fixed an issue where background images/videos/presets did not display properly in dark themes (submitted by FuturePioneer-3).

Import, Export, and Persistence

Color schemes can be exported as JSON and automatically copied to the clipboard; pasting the JSON back will import and apply the scheme. Interface text switches between Chinese and English following DSH’s settings. Settings are stored via localStorage, while backgrounds use IndexedDB. The plugin is a composite plugin that remains active after restart and appears in Settings → Plugins.

Installation and Activation

DeepSeek Harness is still in developer preview, and the official README notes that breaking changes may occur. If you do not yet have the dsh CLI installed locally, you can launch the Web UI as instructed in the official repository:

npx @deepseek-ai/dsh web

The default address is http://127.0.0.1:3080.

The original installation command provided on the community directory page can be run in the DeepSeek Harness terminal:

dsh plugin add github:LAN-TINA-WS/dsh-gui-customization

This repository is a pnpm monorepo, and the plugin itself is located in packages/dsh-gui-customization. Both the root README and the v0.6.2 release notes recommend including the web profile and subdirectory path (the repository states this method is faster than waiting for npm in mainland China):

dsh plugin --profile web add github:LAN-TINA-WS/dsh-gui-customization#path:packages/dsh-gui-customization

You can also install the npm package with the same name (current version is also 0.6.2):

dsh plugin --profile web add dsh-gui-customization

Alternatively, download dsh-gui-customization-v0.6.2.zip from Releases, extract it, and install via local link. The extract directory example in the README still uses the old version v0.5.2, so refer to the latest release filename:

dsh plugin --profile web add link:<extract directory>/dsh-gui-customization-v0.6.2

The directory page also provides a method to pin a specific commit, replace #commit with the actual commit hash to reproduce the installation:

dsh plugin add github:LAN-TINA-WS/dsh-gui-customization#commit

Regardless of the installation method used, you will need to restart dsh web after installation, then open Settings → Interface Settings to configure. When installing from GitHub source code, pnpm may require you to first allow the package’s build script, only approving repositories you have reviewed.

Configuration and Usage

Open Settings → Interface Settings in the Web UI, with sections consistent with the README configuration table.

  1. Preset Color Schemes
    First select one preset from “System Default / Nous Blue / Indigo Purple / Emerald Green”, and confirm whether the colors match expectations after switching light/dark modes. CHANGELOG version 0.6.1 fixed a readback issue: after applying Indigo Purple, Emerald Green, or a custom color, the highlight will no longer incorrectly stay on “Nous Blue” when opening settings again.

  2. Custom Colors
    Modify the 13 theme color fields and click “Apply Color Scheme”. If using both light and dark themes, follow the instructions in version 0.6.0 to configure the dark color palette separately, then export for backup.

  3. Import / Export
    After exporting, you will have a JSON copy on your clipboard, which you can save for future reinstallation or paste into an issue to share. Importing will immediately apply the scheme without needing to reselect a preset.

  4. Ambient Lighting
    Toggle on the switch, then adjust intensity, breathing amplitude, and position. These settings take effect in real time, making it easy to fine-tune while viewing the main interface.

  5. Background Image / Video
    Select a local image, use the built-in “deepseek girl” presets, or select a video (muted looped playback). Do not enable both images and videos at the same time. The transparency slider controls how much of the background is visible, while the sidebar transparency toggle independently controls whether the sidebar shows the background.

Refresh the page after making changes to confirm that the color scheme and background are retained. Settings are stored in localStorage, while backgrounds use IndexedDB, and according to the repository instructions, they should persist across restarts.

Applicable Scenarios and Notes

This plugin is suitable for users who are already using the DSH Web UI and only want to adjust the appearance without installing a full skin pack. Daily use can start with Nous Blue or Indigo Purple, then decide whether to add a background image; when you need to sync the same color scheme to another machine, use the JSON export function. It does not provide desktop pets, character art, or sidebar workbenches, which are covered by other “Themes & Appearance / Interface Enhancement” plugins in the directory.

Please note the following before use:
- The plugin runs with the permissions of the current dsh process and may execute code during installation. You should review the source code repository and license before installing; for reproducible installations, pin the commit hash.
- This is a community open-source project under the MIT license. The repository notes that the tsdown build preset under build/ originates from dsh-web-ui (BSD-3-Clause), with license statements retained in the header of the corresponding files.
- It only applies to the Web UI and cannot be used to modify the appearance of the terminal TUI or other profiles.
- Background files are stored in the local browser storage, and you will need to reselect them after switching browsers or clearing site data.
- DeepSeek Harness is still undergoing rapid iteration, and third-party theme plugins may stop working as the host API changes. If the interface settings disappear after upgrading dsh, first check whether the plugin is still loaded.

For issues, feature requests, and color scheme sharing, refer to issue #1 in the repository.

Summary

dsh-gui-customization wraps up the appearance customization of the DSH web interface into a set of persistent settings: presets like Nous Blue, 13-field custom colors, ambient lighting, and image/video backgrounds. It is not an official product from the skin shop, but a MIT-licensed community composite plugin, with its configuration entry located at Settings → Interface Settings.

Directory page: https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-gui-customization/

GitHub: https://github.com/LAN-TINA-WS/dsh-gui-customization