dsh-client-ui-aqua-community-fix

Aqua glass theme (community-maintained fork)

English | 中文

Upstream notice: this package continues from WYH66666666's DSH-Transparent-UI-Plugin (published on npm as dsh-client-ui-aqua) at v1.3.0. The original author states he cannot keep up with new DSH APIs, so this fork fixes and adapts that code. It is not guaranteed to work with future DSH versions — back up your profile before upgrading DSH.

Supported DSH version

Item · Value DSH desktop / web · V0.2.1-rc.2 Host client packages · @deepseek-ai/dsh-client-* 0.2.1-rc.2 Declared in metadata · package.json → engines.dsh: ">=0.2.1-rc.2 <0.3.0"

V0.2.1-rc.2 is the version this release is built and verified against — the theme hooks are read from that host build (page-head markup, composer/dock seams, slot names). These are private client surfaces, so a DSH upgrade can break the look or the mount even though nothing changes here. If you are on another DSH build, treat the theme as unsupported and keep a profile backup.

Topics / community listing

Published under the dsh-plugin topic, so it shows up on the dsh-plugin community page alongside other DeepSeek Harness plugins.

dsh-plugin · dsh · deepseek-harness · deepseek-harness-plugin · theme · glassmorphism · aqua

Credits

Item · Value Original author · WYH66666666 — repository Upstream npm package · dsh-client-ui-aqua (latest 1.3.1) Base of this fork · upstream v1.3.0 sources Maintained by · ZHUBAI0528 — repository This package · @zhubai0528/dsh-client-ui-aqua-community-fix Version · 2.0.0 DSH support · V0.2.1-rc.2 License · AGPL-3.0 (inherited from upstream LICENSE; original copyright and licence notice retained verbatim)

Aqua is a highly customizable glassmorphism theme for the DeepSeek Harness web UI and desktop app. The floating header, composer and stats line, and the trajectory view become panes of frosted glass, while the main column can sit on the living fluid board or on your own wallpaper (image or video); the sidebar keeps its stock look. Switch it off and the stock UI comes back exactly, with no source changes to DSH itself.

Differences from upstream v1.3.0

Item · Upstream v1.3.0 · This package v2.0.0 Layout modes · Mica + Compatibility, switchable · Mica only — compatibility mode and its selector are removed (tokens and styles too) Edge blur bands · 5px gradient blur bands at the top/bottom (an upstream feature) · Removed — they read as an extra gradient wash over the page edges; readability is carried by the column veil instead (the 13px edge fade stays) Submenu opacity · not available · New setting, default 96%, in the same group as "Chat surface opacity" Submenu click · opens on hover, then a click closes it · New "click keeps it open": a hover-opened submenu survives the click and closes on the next one; works at any depth via ARIA, keyboard Enter unaffected Popup material · 62% × frost fill (≈8.7% by default), text behind was legible through it · 96% fill + blur + 4px, panels no longer show the text behind Composer and stats line · two panes with a 6px gap · one continuous piece of glass (single radius, hairline divider) Light-mode conversation area · if the host or a skin plugin wrote the column background, the veil lost and the area went all-white; the opacity knob did nothing · Fixed: the veil is !important and also matches [class*='centerCol'], so it no longer depends on stamp timing Scheme switching · switching to dark left the backdrop light until a knob was touched · Fixed: the layer watches body[data-ds-dark-theme] and recomputes the fluid palette, glow tone and brightness direction Cold-start fluid · a GPU that was not ready permanently disabled the canvas (all-white in light mode) · Fixed: retried with backoff (up to 8 attempts, ~12s) Published tarball · files omitted cordis.patch.yml, so installs never loaded · Fixed: the tarball ships cordis.patch.yml and lib/* Dependency range · peer ^0.1.0-rc.5 (mismatched a 0.2.x host) · >=0.2.1-rc.2 <0.3.0, pinned to the host line the theme is built against Licence statement · repo LICENSE is AGPL-3.0 while package.json said MIT · Aligned: both now declare AGPL-3.0

Features (current)

• Mica layout: floating glass header, composer, stats line and trajectory view, with adjustable blur and frost
• Theme control panel: one page collects every knob — colours, wallpaper, opacity, blur and decor
• No 3D tilt on the composer: the 3D effect is gone — it interfered with text rendering
• Free backdrop: the living fluid board (hue and depth adjustable) or your own wallpaper — images and video both supported; wallpapers have their own blur and frost, video adds a brightness knob
• Desktop scheme following: tracks the desktop app's light/dark switch and re-tunes the palette, glow and brightness direction on its own
• Background brightness: follows the resolved scheme — dark 0–50 darkens, light 50–100 brightens, 50 is unchanged
• Chat surface opacity: 0 lets the wallpaper/fluid show untouched, 100 is an opaque slab
• Submenu opacity: fill strength for popups (menus, dropdowns, quick-invoke panels), independent of the cards
• Submenu display: popups get a 96% fill plus extra blur, so multi-level menus stay legible above the transcript
• Submenu interaction → click keeps it open: a hover-opened submenu stays open when clicked, and closes on the next click
• Ambient decor: particle whale (the deepseek.com/harness centerpiece), fish, and the interactive mesh — each toggleable
• Hover effects → cursor glow: a highlight that follows the pointer
• Glossy "Harness" badge: dark mode swaps the sidebar wordmark for the official nameplate pill
• Edge fade: a 13px fade so content melts into the viewport edges
• One switch: off restores the stock UI exactly and removes every effect

Installation

Upstream dsh-client-ui-aqua and this fork @zhubai0528/dsh-client-ui-aqua-community-fix must not be installed together — the profile would end up with two ui-aqua entries.

Option 1: desktop app — install from the in-app plugins page (recommended)

Open DeepSeek Harness 0.2.1-rc.2 and click Plugins in the left sidebar.

Click Add plugin, then enter the following in the "package name or address" field:

github:zhubai0528/dsh-client-ui-aqua-community-fix

No npm and no terminal needed — the plugin is pulled from that GitHub repository's latest release. Reload the UI and it is on.

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/ZHUBAI0528/dsh-client-ui-aqua-community-fix/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).

Option 3: npm (not published yet — unavailable)

⚠️ This package is not published to npm, so the command below fails today. It is kept only to document the npm channel for later.

dsh plugin --profile web add @zhubai0528/dsh-client-ui-aqua-community-fix

Once published, it installs the latest version from npm and registers it as a profile plugin layer (dsh.bundle patch) on every platform.

Option 4: manual (macOS / Linux)

git clone --depth 1 https://github.com/ZHUBAI0528/dsh-client-ui-aqua-community-fix.git
ln -s "$PWD/dsh-client-ui-aqua-community-fix" "$DSH_HOME/profiles/web/node_modules/@zhubai0528/dsh-client-ui-aqua-community-fix"

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

- insert:
    - id: ui-aqua
      name: '@zhubai0528/dsh-client-ui-aqua-community-fix'

Usage

Reload the UI. Aqua is on by default; the master switch sits at the top of the Glass theme page in the left sidebar (it is its own page, not a tab inside Plugins/Settings). Panel groups, top to bottom:

Glass material (glass blur, frost) → Backdrop (fluid/wallpaper, hue, colour depth, background brightness, chat surface opacity, submenu opacity) → Ambient (particle whale, fish, interactive mesh) → Submenu interaction (click keeps it open) → Hover effects (cursor glow)

The upstream Mode group (Mica / Compatibility) was removed entirely in 2.0.0.

Upgrading from upstream 1.x

• dsh.ui-aqua.mode is no longer read: users who picked Compatibility land on the mica layout (the stored value is left untouched, not destroyed)
• Every other setting keeps its key (blur, frost, hue, depth, brightness, chat-surface opacity …) and carries over untouched
• The package name differs — uninstall the old package first so two ui-aqua entries never coexist

Local development

npm install
npm run bundle      # build lib/ (tsdown → inlined CSS → ESM→CJS shim)
npm run watch       # watch build

Before publishing, inspect the tarball with powershell -ExecutionPolicy Bypass -File .\publish.ps1 -DryRun; drop -DryRun to publish for real.

Licence

AGPL-3.0, inherited from upstream. The original author's copyright and licence notice are retained verbatim.