Preface

The plugin structure of DSH allows UI capabilities to be split into independent plugins. dsh-ui-skin addresses a specific problem: adding wallpaper or video backgrounds to DeepSeek Harness while allowing the underlying interface and sidebar backgrounds to show through. The following introduces its positioning, installation method, usage, and security boundaries.

Positioning

dsh-ui-skin is a UI skin plugin for DeepSeek Harness. Package name: dsh-ui-skin, Version: 1.0.0, License: MIT. GitHub repository address:

https://github.com/huabai-flowerwhite/dsh-ui-skin

It mainly does two things:

  • Inject wallpaper / video background below the UI.
  • Bake the surface background of the entire DSH interface (including sidebar) into semi-transparency (frosted glass) to let the skin show through.

Core Features

  • Inject wallpaper / video background below the UI.
  • Bake the surface background of the entire DSH interface (including sidebar) into semi-transparency (frosted glass).
  • Supports drag-to-crop and zoom.
  • Skin history.
  • Draggable floating window.
  • Custom skins support network addresses or local files.
  • Provides a “Settings → UI Skin” settings page.
  • Provides the skin_list read-only tool.
  • Provides the /dsh-ui-skin/skins local route.
  • Local images are compressed and stored in localStorage as JPEG (0.85 quality, 1920px wide), and local videos are stored in IndexedDB.

Installation and Enablement

First install the plugin, then restart dsh. Choose the installation command provided by the repository based on your system.

Linux / macOS (bash):

cd dsh-ui-skin
bash install.sh

Windows (PowerShell):

cd dsh-ui-skin
powershell -ExecutionPolicy Bypass -File install.ps1

After installation, open:

Settings → UI Skin

Skin and parameter configurations are persisted to the browser localStorage.

Typical Usage

  1. After installation, restart dsh and open “Settings → UI Skin” to switch skins and parameters.

  2. In “Custom”, you can fill in a network address, or click “Select Image/Video” to choose from a local folder.

  3. In the preview area, drag to move the crop position and use the scroll wheel to zoom.

  4. After uploading, it will enter “Skin History”.

  5. Click “Expand Floating Window” to pop up a draggable shortcut panel.

In the chat box, you can call skin_list to view the skin list:

skin_list

Skin List

id Name Type Description
none None — No background (Original UI)
custom Custom Wallpaper / Video Network address, or select image/video files from a local folder

Runtime Environment

Verified runtime and compatibility requirements are as follows:

engines: node >=22 <25
compatibility: apiLevel 1, harness >=0.1.0-rc.7

The Host-side capabilities included in the plugin are:

skin_list
/dsh-ui-skin/skins

Where skin_list is a read-only tool and /dsh-ui-skin/skins is a local route.

Security and Notes

Verified security boundaries are as follows:

  • Security Level S1 / Permission Level P1: Read-only Host tools + Local route + Pure UI.
  • Does not read or write files.
  • Does not send external network requests.
  • Does not run shell/subprocesses.
  • Does not contain keys.

When using custom skins, please note:

  • The network URL for custom skins must be accessible by the browser.
  • The plugin itself does not send external network requests.
  • Local images are compressed to JPEG (0.85 quality, 1920px wide) before being stored in localStorage, subject to site quotas.
  • Local videos are stored in IndexedDB.
  • The sidebar transparency of 0.6 is a compromise between letting the entire interface show through and ensuring text readability.
  • Cropping and zooming only support magnification, not reduction, with a range of scale 1.0–4.0.

The plugin runs with the permissions of the current dsh process; please check the source code and license before installing.

Unimplemented and Known Limitations

  • Agent reactive intensity and WebGL/Shader rendering are not implemented.
  • dshpd_analyze is a heuristic scan and may falsely report fields like plugin.id in nested manifests.

Conclusion

dsh-ui-skin is suitable for DSH’s UI skin scenarios: adding wallpaper or video backgrounds below the interface and baking the entire interface surface into semi-transparency to let the background show through.

The community directory is a separate site; this article does not provide a verified directory page address.

GitHub:

https://github.com/huabai-flowerwhite/dsh-ui-skin