deepseekplugins

DeepSeek Harness plugin

dsh-client-ui-aqua-unofficial

Aqua: a highly customizable glassmorphism theme for the DeepSeek Harness Web UI — blur, frost, fluid or video wallpaper, unified corners, and motion. Unofficial community fork, not affiliated with

Just for Fun
Jump to install

Source facts

Repository
afrel1024/dsh-client-ui-aqua-unofficial
Latest update
Aug 18, 2026
Category
Just for Fun
GitHub stars
3
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/afrel1024/dsh-client-ui-aqua-unofficial
Plugin: dsh-client-ui-aqua-unofficial
Author: afrel1024

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

dsh-client-ui-aqua-unofficial

English | 中文

> UNOFFICIAL — This is a community third-party fork. It is not an official DeepSeek product, is not affiliated with or endorsed by DeepSeek, and claims no connection to the @deepseek-ai package scope. Use at your own risk. > > Upstream: WYH66666666/DSH-Transparent-UI-Plugin (MIT, (c) 2026 John Wu). This fork adds DSH rc.7 compatibility and rebrands the package as unofficial.

Aqua is a highly customizable glassmorphism theme for the DeepSeek Harness web UI. The header, sidebar, composer, stats line, and trajectory view all become panes of frosted glass. You can set an image or video as wallpaper, and switching it off restores the stock UI exactly — with no source changes to DSH itself.

![](assets/1.png)

![](assets/2.png)

![](assets/3.png)

![](assets/4.png)

Features

  • Two modes: Mica restyles the layout into floating glass cards (blur and frost adjustable), while Compatibility Mode keeps the stock layout byte-for-byte and only swaps the material to generic glass — other plugins' UI gets the same treatment automatically
  • Free backdrop: a living fluid board (hue adjustable) or your own wallpaper (fills the page, aspect preserved, with its own blur and frost); light wallpapers look best in light mode, dark wallpapers in dark mode
  • Background brightness: follows the resolved scheme — dark mode darkens (0–50), light mode brightens (50–100), 50 is unchanged
  • Particle whale: the deepseek.com/harness centerpiece fish (a 2D port of the site's particle engine), centered in the chat area right of the sidebar — white particles on dark, gray on light, toggleable in settings
  • Glossy "Harness" badge: in dark mode the sidebar wordmark wears the official nameplate pill (135° gradient ring + soft glow); light mode keeps the stock plate
  • Edge fades: 5px gradient blur bands pinned to the top and bottom of the page, above the chat content — scrolling content melts into the edges; faint white veil on light, faint black on dark
  • One switch: off restores the stock UI exactly, and every effect is removed with the plugin

What this fork changes

  • DSH rc.7 compatibility (v1.4.0): the Plugins-section card slot became a keyed slot; the master-switch card now registers with key: 'aqua' and the node half serves the aqua settings namespace so the card still appears in Settings → Plugins.
  • Unofficial rebrand: package renamed to dsh-client-ui-aqua-unofficial (no @deepseek-ai scope) and the repository name carries the -unofficial suffix.
  • Everything else (theme, settings, wallpapers) is unchanged from upstream v1.3.0.

Installation

Option 1: npm one-liner (recommended)

dsh plugin --profile web add dsh-client-ui-aqua-unofficial

Installs the latest version from npm and registers it as a profile plugin layer (dsh.bundle patch) — works on every platform. Reload the web UI and it is on.

> Auto-registration: v1.4.1+ ships the dsh.bundle patch inside the package, so dsh plugin add registers the plugin layer automatically. v1.4.0 needs the ui-aqua row added to cordis.patch.yml by hand.

> DSH rc.7: v1.4.0+ targets @deepseek-ai/dsh-* rc.7 (the Plugins-section card slot became a keyed slot). Earlier versions still run on rc.5/rc.6.

Option 2: GitHub installer (fallback)

No npm account and no git needed (falls back to a plain zip download).

Windows (one command):

powershell -ExecutionPolicy Bypass -Command "Invoke-WebRequest 'https://github.com/afrel1024/dsh-client-ui-aqua-unofficial/raw/main/install.ps1' -OutFile install.ps1; .\install.ps1"

Installs the latest release by default. The script links the plugin into the profile's node_modules and registers ui-aqua in cordis.patch.yml (idempotent — safe to run again).

Pin a version or track the dev branch:

.\install.ps1 -Version 'v1.4.0'   # a specific release
.\install.ps1 -Version 'main'     # the development branch

macOS / Linux (manual, three steps):

git clone --depth 1 https://github.com/afrel1024/dsh-client-ui-aqua-unofficial.git
ln -s "$PWD/dsh-client-ui-aqua-unofficial" "$DSH_HOME/profiles/node_modules/dsh-client-ui-aqua-unofficial"

then append to $DSH_HOME/profiles/web/cordis.patch.yml:

- insert:
    - id: ui-aqua
      name: 'dsh-client-ui-aqua-unofficial'

Usage

Reload the web UI. Aqua is on by default; the master switch lives in Settings → Plugins → Glass theme (same shape as the other plugin cards), and every other control sits directly under Settings → General → Appearance (no title of its own): mode, blur/frost (Mica mode), fluid color, background brightness, backdrop (fluid/wallpaper) with its wallpaper controls, and the particle-whale toggle. With the master switch off, the whole control block under Appearance is hidden.

License

MIT, inherited from the upstream project ((c) 2026 John Wu). See [LICENSE](LICENSE).

Back to searchOpen GitHub repository

More related plugins

View category