MIT glassmorphism theme for the DeepSeek Harness web UI, installed as a DSH profile plugin layer via `dsh plugin --profile web add`; one switch restores the stock UI exactly.
DSH integration
Compatible
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-21
License
MIT
01What can it help you accomplish?
Restyle the DeepSeek Harness web UI into a frosted-glass (glassmorphism) interface
Header, sidebar, composer, stats line and trajectory view rendered as frosted-glass panes with adjustable blur and frost; one master switch restores the stock UI exactly
DeepSeek Harness web UI users who want a premium glass aesthetic without modifying any DSH source code
Personalize the DSH workspace with custom backdrops and ambient effects
A living fluid backdrop (hue adjustable) or your own wallpaper — including video — with independent blur/frost, scheme-aware background brightness, and a toggleable particle whale
Users who want wallpapers, ambient animation and mode-aware brightness in their DeepSeek Harness web UI
02How to install into DeepSeek Harness
Prerequisites
- DeepSeek Harness (dsh) with the web UI — the theme applies to the DSH web profile
- Option 1 needs access to npm; Option 2 needs no npm account and no git (falls back to a plain zip download)
Installation steps
- 01
Option 1 (recommended): run `dsh plugin --profile web add dsh-client-ui-aqua` — installs the latest version from npm and registers it as a profile plugin layer (`dsh.bundle` patch), then reload the web UI
$ dsh plugin --profile web add dsh-client-ui-aqua
- 02
Option 2 (Windows): run the one-line PowerShell installer to download install.ps1 from GitHub and install the latest release; pin a version afterwards with `.\install.ps1 -Version 'v1.1.0'` or `-Version 'main'`
- 03
Option 2 (macOS / Linux): `git clone --depth 1 --branch v1.1.0` the repo, symlink `DSH` into `$DSH_HOME/profiles/node_modules/@deepseek-ai/dsh-client-ui-aqua`, then append the `ui-aqua` insert entry to `$DSH_HOME/profiles/web/cordis.patch.yml`
$ git clone --depth 1 --branch v1.1.0
Verify the integration
- Reload the web UI — Aqua is on by default once installed
- The master switch appears under Settings → Plugins → Glass theme
Rollback
- Turn off the master switch in Settings → Plugins → Glass theme — the stock UI comes back exactly, with no source changes to DSH itself
03DSH integration and capability boundaries
DSH profile plugin layer for the web UI, installed via `dsh plugin --profile web add` and registered as a `dsh.bundle` patch
Two glass modes: Mica & Compatibility
the DeepSeek Harness web UI layout→Mica restyles the layout into floating glass cards (blur and frost adjustable); 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
installation registers a `ui-aqua` entry in `cordis.patch.yml` and links plugin files into the profile's `node_modules` (config change)Custom backdrops & scheme-aware brightness
a fluid board or your own wallpaper (image or video)→full-page backdrop with aspect preserved, independent blur/frost per wallpaper, and background brightness that follows the resolved scheme (dark 0–50, light 50–100)
Ambient effects: particle whale, glossy badge, edge fades
the DSH chat area and sidebar→toggleable particle whale (white on dark, gray on light), glossy 135°-gradient "Harness" badge in dark mode, and 5px gradient blur bands at the page edges
One-switch restore
the master switch in Settings → Plugins → Glass theme→off restores the stock UI exactly and every effect is removed; with the switch off the whole Appearance control block is hidden
04Who is it for? When not to use it?
Good for
- DeepSeek Harness web UI users who want a premium glass aesthetic without modifying any DSH source code
- Users who want wallpapers, ambient animation and mode-aware brightness in their DeepSeek Harness web UI
Not for
- The maintainer warns that recent DSH updates changed the plugin ID and they cannot promptly update the plugin (due to academic commitments); installing against a newer DSH may crash, and the README suggests replacing or repairing the ID yourself with another agent.
- The GitHub-installer fallback is one-command only on Windows; on macOS / Linux you must manually git clone, symlink the plugin into `$DSH_HOME/profiles/node_modules`, and edit `$DSH_HOME/profiles/web/cordis.patch.yml` by hand.
05Compatibility, maintenance and safety notes
- The maintainer warns that recent DSH updates changed the plugin ID and they cannot promptly update the plugin (due to academic commitments); installing against a newer DSH may crash, and the README suggests replacing or repairing the ID yourself with another agent.
- The GitHub-installer fallback is one-command only on Windows; on macOS / Linux you must manually git clone, symlink the plugin into `$DSH_HOME/profiles/node_modules`, and edit `$DSH_HOME/profiles/web/cordis.patch.yml` by hand.
- The theme restyles DSH's live web UI DOM rather than official theming APIs, so future DSH UI changes are the most likely source of visual breakage — Compatibility Mode exists to keep the stock layout byte-for-byte as a safer lane.
MIT · maintained, but maintainer warns of delayed fixes for new DSH plugin IDs (latest release v1.3.0, 2026-08-16)
06Frequently asked questions
How do I install the Aqua theme on DeepSeek Harness?
Run `dsh plugin --profile web add dsh-client-ui-aqua` (recommended) — it installs the latest version from npm, registers the plugin as a profile plugin layer (`dsh.bundle` patch), and it is on after you reload the web UI. Without npm, Windows users can run the one-line GitHub PowerShell installer; macOS/Linux users git clone, symlink into the profile's node_modules and register it in cordis.patch.yml.
Is this a native integration or MCP?
Neither — it is a DSH profile plugin layer. It is registered as `ui-aqua` in `cordis.patch.yml` and applied to the web UI as a `dsh.bundle` patch, not through MCP.
How do I revert to the original interface?
Turn off the master switch under Settings → Plugins → Glass theme. The stock UI comes back exactly and every effect is removed — DSH source code is never modified.
What's the difference between Mica and Compatibility Mode?
Mica restyles the layout into floating glass cards with adjustable blur and frost. Compatibility Mode keeps the stock layout byte-for-byte and only swaps the material to generic glass — UI from other plugins gets the same treatment automatically.
Is there anything to watch out for?
The maintainer states in the README that DSH recently updated and changed the plugin ID, and they cannot promptly update the plugin due to academic commitments — installing on a newer DSH may crash. They suggest replacing or repairing the ID yourself with another agent.
07Related DSH workflows
dsh-web
by zhu1090093659
DeepSeek Harness (DSH) Web Plugin Aggregation Ecosystem · Everything is a plugin, distributed via the Creative Workshop
petdex
by crafter-station
A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and more.
j-space-cognition-suite-v3.7
by tiger3807861189
AI cognitive-enhancement skills for agent harnesses inspired by Anthropic's global workspace research. Adds inference-time control and reasoning tools for DeepSeek Harness, Claude Code, Codex and OpenCode.
dsh-deep-whale
by small-tailqwq
DSH Web GUI 鲸鱼娘主题皮肤（深海女仆工坊 maid-atelier：亮/暗双模式）
08Data and sources
Aqua is a highly customizable glassmorphism theme for the DeepSeek Harness web UI. The header, sidebar, composer, stats…
Installs the latest version from npm and registers it as a profile plugin layer (`dsh.bundle` patch) — works on every pl…
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.