DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-glass-sidebar

M

dsh-glass-sidebar

Manifest valid

Frosted, wallpaper-backed translucent sidebar for the DeepSeek Harness Web GUI - blur and opacity in Settings > General

UI (client)hasBundlePatch

dsh-glass-sidebar

Frosted, translucent left sidebar for the DeepSeek Harness Web GUI (Desktop and Web), with all three controls in Settings → General.

What it does

The sidebar column becomes a translucent surface over your current Windows wallpaper, blurred by the browser's backdrop-filter — the same picture the macOS vibrancy sidebar shows. The centre and right columns keep painting their own opaque surfaces, so readable content is untouched: only the sidebar (and the Windows caption band) reveal the backdrop. Changing the wallpaper changes the glass with it.

Three preference rows appear in Settings → General:

RowRangeDefault
Sidebar glass (switch)on / offon
Frost blur0–40 px18 px
Sidebar opacity20–100 %62 %

Changes apply immediately. Turning the switch off restores the stock sidebar exactly: the document attribute and both custom properties are removed, and every rule in the stylesheet stops matching.

The wallpaper backdrop

The window itself stays opaque, so the wallpaper is painted behind the shell rather than seen through the window (that would need Electron window material, which the plugin layer does not expose):

  1. The Host half reads the applied image from %APPDATA%\Microsoft\Windows\Themes\TranscodedWallpaper (the file Windows keeps for the current wallpaper, including slideshow rotations), detects its format from magic bytes, and republishes it as lib/assets/wallpaper.<ext>. It re-checks the source every 20 s and rewrites the asset only when the source changed.
  2. The package exports ./assets/*, so the client asset route serves it at plugins/dsh-glass-sidebar/assets/wallpaper.<ext>.
  3. The browser half points --dsh-glass-wallpaper at that URL — the Host bakes an absolute URL into the page head, and the Client re-probes on window focus with a fresh cache token, so a wallpaper change reaches an open page without a reload (the Host serves the asset with no-store).

When no wallpaper is readable (non-Windows, a solid-colour background, an unreadable file) the backdrop falls back to a painted blue wash, and the plugin never fails: the glass still works.

Storage

The preferences are three .volatile() fields of this plugin's Host Config. The Client reads and writes them through ctx.configForms, so they persist in the profile's cordis.patch.yml (the same seam ui-theme uses for the theme and font sizes) and survive app restarts. Volatile fields update in place, so dragging a slider never restarts the plugin.

localStorage is deliberately unused: the Desktop app starts the Web server with --port 0, so the page origin changes between launches.

Implementation notes

  • The effect is one stylesheet gated on html[data-glass-sidebar='on']. It targets the sidebar column through its CSS-module local name (_sidebarCol, _scrollFade), anchors the frame with :has(> [class*='_sidebarCol']), and clears the occupant's own fill through the slot outlet wrapper ([data-slot='sidebar'] > *). Those local names and that wrapper are the only internal details it depends on; if a future release renames them the rules stop matching and the plugin degrades to no visual change, with the switch row showing a "sidebar container not found" note.
  • The blur never lands on a shell element. filter and backdrop-filter make an element the containing block for position: fixed descendants, and the sidebar's Windows caption controls (the collapse toggle and the New Session button) are exactly that: fixed to the window. A blurred column pushed both into the column, where collapsing clipped them away. The blur therefore lives on a fixed body::before layer over the whole window, and the tint sits on the frame, not on the column: one glass surface behind every column means the centre column's rounded corner reveals glass rather than the raw wallpaper, and the caption band is the same surface as the sidebar.
  • The fallback wash uses the palette tokens --dsw-static-deepseek-500 and --dsw-static-blue-500 (both palettes define them) instead of the brand alias, which resolves to a near-neutral in this design system. It only shows when no wallpaper could be published; like the wallpaper, it is painted across the window, so surfaces over the sidebar that use translucent fills (menus, the settings mask) can pick up the tint while the centre and right columns stay opaque.
  • The switch copies the shipped Switch primitive's markup and CSS exactly; the two sliders are native input[type=range] controls using the same accent-color and focus-ring treatment the shell uses for checkboxes.
  • The Host half injects a tiny webserver/index-inject head script with the persisted values so the first paint already has the right state. It contains no CSS; the stylesheet ships with the browser bundle.
  • A page that receives the plugin without a reload keeps the shell's cached settings document, so the mirror may not serve this namespace until the page is reloaded. The surface still paints with the seeded values; persistence starts working after the reload. Restarting the app always loads everything fresh.

Known limitations

  • The backdrop is the wallpaper this plugin paints behind the shell, not the live desktop: the window stays opaque. Reaching Windows Mica/Acrylic would require Electron window control, which the plugin layer does not expose.
  • Following a wallpaper change without a reload costs one asset fetch (~the wallpaper's size) at most once a minute, on focus; a page reload always picks the current file up immediately.
  • Windows only for the wallpaper itself (it reads the Themes folder). Other platforms keep the painted wash, which still gives a working glass surface.
  • A wallpaper whose format changes (png → jpg) keeps the old asset extension until the page is reloaded; the image then simply falls back to the wash for that session.
  • Left sidebar only; the right sidebar, terminal and conversation surfaces are out of scope.
  • On macOS the shell already has native vibrancy glass; enabling this plugin lays its own tint and blurred wash over that, so the result is a blend of both rather than a replacement.
  • The min/max/close strip is Electron's native window-controls overlay: the window paints it above the page with a background chosen when the window is created, so no plugin can make that strip translucent. Everything below it — the caption row and the sidebar — is this plugin's glass.
  • Narrow Web windows switch the sidebar to a drawer overlay, where the effect falls back to the stock solid fill on purpose; a collapsed Windows sidebar keeps its stock zero-width behaviour and its controls in the caption row.
  • prefers-reduced-transparency: reduce drops the wash and the blur and uses a 92 % opaque, blur-free surface.

Install

git clone https://github.com/MrMark019/dsh-glass-sidebar.git
cd dsh-glass-sidebar
npm install        # the Host half imports @deepseek-ai/schemastery

Then install the directory as a local bundle (Plugins → Add plugin, or the profile's plugin manager) and reload the page once so the new browser bundle is served.

A directory/link: install does not install a bundle's own dependencies, so the npm install step is required: without it the Host row fails to import @deepseek-ai/schemastery and the plugin stays inactive.

lib/assets/ is generated at runtime from your own desktop wallpaper and is never committed.

License

MIT — see LICENSE.

Comments

Loading…

Similar plugins

dsh-desktop-glass

by JianHeShui

Frosted-glass look for the DeepSeek Harness desktop app (translucent page + Windows acrylic window material)

Manifest valid

★ 3

MIT

JavaScript

Oct 10, 2026

dsh plugin --profile web add dsh-desktop-glass

by omorisunn

Frosted-glass (acrylic) surfaces for the DeepSeek Harness Desktop app - a plugin-only wallpaper blur, no shell change required

Development & InfrastructureManifest valid

★ 0

MIT

JavaScript

Sep 25, 2026

dsh plugin --profile web add dsh-vibrancy

by noexcs

Frosted-glass skin for the DeepSeek Harness web UI: pick any image as background, theme colors extracted from it, glassmorphism surfaces.

Manifest valid

★ 0

MIT

JavaScript

Aug 16, 2026

dsh plugin --profile web add dsh-skin-glass

✦

No screenshots

by H2CO3w

DSH (DeepSeek Harness) plugin — turn an image folder into a frosted-glass global wallpaper, keeping the official palette. 一个 DSH壁纸插件。

Themes & SkinsUI & ExperienceManifest valid

★ 1

MIT

JavaScript

Oct 17, 2026

dsh plugin --profile web add dsh-theme-frost

by blockman0321

Floating sidebar overlay for DeepSeek Harness: independently rendered workspace/session browser in the official shell.overlay seat, without touching the official sidebar or grid.

UI & ExperienceTerminal & ClientsManifest valid

★ 1

MIT

JavaScript

Oct 27, 2026

dsh plugin --profile web add dsh-sidebar-overlay
dsh-liquid-glass3

No screenshots

by Ultronen

Liquid glass for DeepSeek Harness: full-shell translucency, adjustable opacity, and custom wallpapers.

Themes & SkinsUI & ExperienceTerminal & ClientsManifest valid

★ 3

↓ 136/wk

MIT

JavaScript

Sep 4, 2026

dsh plugin --profile web add dsh-liquid-glass