Preface

DeepSeek Harness (dsh) is an open-source agent runtime developed by DeepSeek AI, with the architectural slogan of “Everything is a plugin”: models, tools, sessions, and UIs can all be replaced or superimposed via plugins without modifying the Harness source code. The official repository is currently marked as developer preview. You can launch the web interface with the following command by default, and the address is usually http://127.0.0.1:3080:

npx @deepseek-ai/dsh web

Once the interface is usable, the next common need is to adjust its appearance. The top bar, sidebar, input box, status bar, and chat history view are the most frequently used areas in the workspace. The native style is purely functional. To achieve a frosted glass effect, you usually have to either modify the frontend source code or install a skin that dynamically adjusts the layout. The former may cause conflicts during upgrades, while the latter may disrupt the panels of other plugins.

DSH-Transparent-UI-Plugin takes a third approach: it adds a glass layer on top of the web interface. Blur intensity, frosted effect strength, and background can all be adjusted in the settings; turning off the main switch will restore the interface to its native state. The community plugin directory categorizes it under “Themes & Appearance”. It should be noted that the DeepSeek Harness Plugin Repository is an independent community site and has no official affiliation with DeepSeek / Horizon AI. Do not treat it as an official app store.

What is this

One-sentence positioning: DSH-Transparent-UI-Plugin is a glass-style theme that wraps over the web version of DeepSeek Harness. It is maintained by GitHub user WYH66666666, the repository uses the MIT license, and the copyright page is attributed to John Wu. Both the directory page and package.json indicate that the primary language is JavaScript.

The internal npm package name of the repository is @deepseek-ai/dsh-client-ui-aqua, which is abbreviated as Aqua in the README. The main switch text on the settings page is “Glass Theme”. The @deepseek-ai/ scope is only part of the package name; this plugin is community-maintained and not an official DeepSeek theme. The dsh.client.platform field in package.json is set to web, and the peer dependency points to ^0.1.0-rc.5 of @deepseek-ai/dsh-client-*, meaning it only works with the Web UI and does not cover the terminal TUI.

As of August 17, 2026, the GitHub API shows that the repository has 177 stars, and the latest stable version is v1.3.0 (released on 2026-08-16). The community directory page still shows 19 stars at the same time, which is inconsistent with the real-time GitHub data. Please refer to the star count on GitHub.

The problem it aims to solve is specific: without modifying a single line of DSH source code, it turns the top bar, sidebar, input box, status bar, and chat history view into adjustable frosted glass, and allows using fluid gradients, images, or videos as backgrounds.

Core Features and Highlights

The following features are sourced from the repository’s README / README.zh.md and CHANGELOG, based on the latest stable version v1.3.0. The README updates slower for several features added after v1.2 (such as hover press-down effect, mouse glow, video wallpapers, etc.), and these should refer to the CHANGELOG.

1. Mica Effect and Compatibility Mode

The theme provides two modes:
- Mica Effect (called “Floating Glass” in early versions): Changes the layout to floating glass cards, with adjustable blur and frosted effect strength. The top bar, sidebar, send box, status bar, and chat history view are separate glass panels, and the chat area slides on the background.
- Compatibility Mode: Keeps the original layout completely unchanged, only replacing the materials with universal glass. The README specifies that it targets menus, cards, bubbles, dropdowns, tooltips and other surfaces by role and class name substring, and the interfaces of other plugins will also be automatically glassified.

The CHANGELOG for v1.2.0 also records a compatibility mode fix: the injection layer will no longer misalign the top bar, new session button, and send bar. If you have installed plugins that add controls to the page such as sidebars or dashboards, it is more reliable to use Compatibility Mode first.

2. Three Background Types: Fluid Gradient, Images and Videos

There are three options for backgrounds:
1. Fluid Gradient: A dynamic background with adjustable colors. Starting from v1.2.0, it is split into two sliders: “Hue” and “Lightness/Darkness”. 0°/360° anchors to blue, the default hue is 320° (cyan-purple); the lightness/darkness can be adjusted infinitely from deep to pastel tones.
2. Image Wallpaper: Covers the entire page while maintaining aspect ratio, with separate adjustable blur and frosted effect strength. Images are compressed and stored locally. The README recommends matching light wallpapers with light mode and dark wallpapers with dark mode.
3. Video Wallpaper (v1.3.0): Decoded natively by the browser, loops automatically, covers and crops the screen, and adapts when the window is resized. In Chromium-based browsers, you can use File System Access to “remember file authorization”, so the original file will be automatically loaded after refresh; non-Chromium browsers will fall back to database storage. The CHANGELOG notes that an automatic soft light filter will be added over the video, and chat bubbles will switch to solid backgrounds to avoid text being unreadable.

The background brightness follows the current color mode: dark mode only allows dimming from 0–50, light mode only allows brightening from 50–100, with 50 meaning no adjustment. When “Follow System” is selected, the slider range will be flipped according to the actually detected system mode.

3. Glass Sliders and Factory Defaults

In Mica Mode, the glass itself has two sliders for blur and frosted effect strength. The factory defaults given in v1.2.0 are:
- Blur: 20
- Frosted effect: 7
- Hue: 320
- Lightness/Darkness: 25
- Brightness: 50
- All related switches are enabled by default

v1.3.0 also combines the send bar and status bar into one glass panel: sharing the same background, blur, border, and shadow, with the dividing line at the curved rounded corners on the left and right, avoiding misalignment of blur intensity between two separate panels. The text on the status bar and the placeholder text in the send bar have been changed to neutral colors (near white in dark mode, dark gray in light mode), removing the original blue tone.

4. Decorative Layers: Particle Whale, Small Fish, Edge Gradient Blur, Brand Badge

These can all be disabled in the settings and are not part of the core theme:
- Particle Whale: A 2D port of the particle fish effect from deepseek.com/harness, placed in the center of the main chat area (excluding the sidebar). The particles are white in dark mode and gray in light mode.
- Small Fish (v1.1.2): Swimming small fish/bubbles in the background, with a switch next to the particle whale option.
- Harness Glossy Badge: Only生效 in dark mode, replaces the sidebar badge with the official website’s signature pill shape (135° gradient stroke + soft light); keeps the original version in light mode.
- Edge Gradient Blur: A 5px gradient blur strip at the top and bottom of the page, floating above the chat content, fading into the edge when scrolling. It is slightly off-white in light mode and slightly black in dark mode.

v1.2.0 also added two sets of hover effects, grouped separately in the settings:
- Mouse Glow: A fluorescent halo near the cursor, drawn under the glass and visible through the frosted effect, without blocking content. Starting from v1.2.1, the color follows the “Hue” slider.
- Hover Press-down: The same 3D tilting effect as the official website cards (tilted towards the side with the mouse, perspective 800px, slightly zoomed to 1.01, 0.1s transition). The top bar, sidebar, send bar + status bar, and chat history window use the same configuration, with the amplitude halved for the chat history window.

5. One-key Switch, Restores Native Interface When Disabled

The theme takes effect by default after the main switch is turned on; when turned off, the README states that it will “completely restore the native interface”, and the effect will disappear along with the plugin uninstallation. The main switch is located at Settings → Plugins → Glass Theme, with the same shape as other plugin cards. The remaining sliders are located directly below the Settings → General → Appearance section, without a separate title. When the main switch is off, the entire adjustment section under Appearance will be hidden.

Installation and Activation

The installation command provided on the community directory page is as follows, execute it in the terminal where dsh CLI has been installed. Please use the original command from the directory page and do not拼接 the repository name yourself:

dsh plugin add github:WYH66666666/DSH-Transparent-UI-Plugin

For reproducible installations, pin the commit hash as instructed on the directory page:

dsh plugin add github:WYH66666666/DSH-Transparent-UI-Plugin#<commit>

Replace <commit> with the actual commit hash from the repository. According to the official dsh documentation, GitHub source installation uses pnpm; if the first add command is blocked by pnpm ≥10 due to the prepare script, follow the terminal prompt to add the corresponding package name to allowBuilds in the current profile’s pnpm-workspace.yaml, then run the add command again.

Windows users who prefer the built-in installer can use the PowerShell command provided in the README, which installs the latest Release by default and does not require git to be installed locally (will fall back to zip download). The script will symlink the plugin to the profile’s node_modules and register ui-aqua in cordis.patch.yml, and repeated execution will not register it multiple times:

powershell -ExecutionPolicy Bypass -Command "Invoke-WebRequest 'https://github.com/WYH66666666/DSH-Transparent-UI-Plugin/raw/main/install.ps1' -OutFile install.ps1; .\install.ps1"

To specify a version or track the development branch:

.\install.ps1 -Version 'v1.3.0'
.\install.ps1 -Version 'main'

The README’s macOS/Linux examples still use --branch v1.1.0, while the latest stable version is already v1.3.0. A more reliable cross-platform approach is to use the dsh plugin add github:WYH66666666/DSH-Transparent-UI-Plugin command mentioned above. Refresh the web interface after installation is complete.

Typical Usage

After refreshing the webpage, Aqua is enabled by default. Follow the path in the README to operate:
1. Open Settings → Plugins → Glass Theme and confirm that the main switch is turned on. Turning it off will hide the entire slider group on the Appearance page and restore the interface to its native state.
2. Open Settings → General → Appearance, adjust the options directly below the Appearance section:
- Mode: Mica Effect / Compatibility Mode
- Blur, Frosted Effect Strength (Mica Mode only)
- Fluid Gradient Hue, Lightness/Darkness
- Background Brightness
- Background Type: Fluid / Wallpaper (including images and v1.3.0 videos)
- Wallpaper-specific blur, frosted effect, and delete button
- Particle Whale, Small Fish
- Mouse Glow, Hover Press-down
3. Start testing with the default values: Blur 20, Frosted Effect 7, Hue 320, Lightness/Darkness 25, Brightness 50. If the background is too distracting, first adjust the brightness towards 50, or increase the wallpaper blur.
4. If you have installed other interface-modifying plugins, switch to Compatibility Mode first to confirm that the buttons and panels of other plugins remain in their original positions before deciding whether to use the Mica Effect to adjust the layout.
5. When using video wallpapers, the CHANGELOG recommends authorizing local files in a Chromium-based browser once, so you do not need to reselect them after refresh; the solid background of chat bubbles over videos is intentional and not a display error.

The settings page itself has also been glassified after v1.2.0 (approximately 50px frosted effect, adapts to light/dark mode, works with Compatibility Mode). Decorative and hover effects are grouped separately in the settings, and you can turn off entire groups to retain only the glass material.

Applicable Scenarios and Notes

It is suitable for the following use cases:
- Daily use of the DSH web interface for coding and viewing chat history, hoping for a frosted glass interface without forking the frontend code.
- Already have sidebar, dashboard, or skin plugins installed, and only want to change the material without altering the layout as much as possible — use Compatibility Mode.
- Want to use your own wallpaper or looping video as the workspace background, and can independently adjust blur and brightness.

Please note the following before use:
1. Only covers the Web UI. package.json declares platform: "web". If the terminal TUI or desktop wrapper does not use this web interface, the glass theme will not appear after installation.
2. Peer dependency is ^0.1.0-rc.5. DSH is still in developer preview, and the official README notes that there will be breaking changes. If the theme is misaligned or the switches disappear after upgrading Harness, first check whether the plugin version matches the Web UI version.
3. The @deepseek-ai/ scope in the package name does not represent official production. It is maintained by WYH66666666 and licensed under MIT. Before installation, you should open the repository to review the source code and LICENSE.
4. The plugin runs with the permissions of the current dsh process, and may execute code during installation. The community directory page also includes this warning. The community directory is only an index and does not replace your security review. For a reproducible environment, pin the version with #<commit> to avoid subsequent pushes silently changing the running code.
5. The macOS example in the README is still pinned to v1.1.0, which lacks multiple features added after the particle whale update. Do not copy the outdated branch number; use the v1.3.0 release from GitHub or the current default version resolved by dsh plugin add.
6. The Particle Whale, Small Fish, Hover Press-down, and Video Wallpaper all have independent switches in the settings. You can turn off these decorative features and retain only the glass material; the repository does not provide performance benchmarks, so please test the smoothness on your local web interface.

Summary

DSH-Transparent-UI-Plugin has a very focused feature set: adds a switchable glass theme to the DSH web interface, supports changing the layout to mica cards or only replacing the material. Backgrounds support fluid gradients, images, and videos, with all sliders located under the Appearance section. Turning off the main switch will restore the native interface without modifying Harness source code.

It is a community MIT project and not an official skin. Please review the source code and license before installation, and use the following command from the community directory page:

dsh plugin add github:WYH66666666/DSH-Transparent-UI-Plugin

Community Directory Page: https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-transparent-ui-plugin/

GitHub Repository: https://github.com/WYH66666666/DSH-Transparent-UI-Plugin