dsh-theme-liquid-glass
适用于 DSH Web UI 的真正 Liquid Glass 主题：在输入卡片、发送按钮、气泡、视图标签、队列停靠栏和侧边栏上使用 SVG feDisplacementMap 实现边缘折射。内置动画演示壁纸，可自定义背景模糊和亮度，重新设计的模型选择器
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-theme-liquid-glass@0.4.2
Theme Liquid Glass 以 dsh-theme-liquid-glass 发布，当前版本为 0.4.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Genuine Liquid Glass theme for DeepSeek Harness Web UI.
A complete frosted-glass skin: SVG edge refraction, a customizable animated wallpaper, glass-lens buttons, a redesigned full-screen model selector, and a dedicated water-drop settings icon.
v0.4.2 — Requires DeepSeek Harness ≥
0.1.2-rc.1. This release adapts to the harness client-package split: the store part of the removed@deepseek-ai/dsh-client-runtimenow lives in@deepseek-ai/dsh-client-store. See CHANGELOG.md.
feDisplacementMap refraction on the input card,
send button, message bubbles, view tabs, queue dock, and sidebar buttons.
Intensity is adjustable from a slider.ctx.theme.overrideTokens) swap the
--dsw-alias-* semantic tokens for translucent glass values. Glass parameters
are driven by --dsh-lg-* custom properties on body and apply instantly.(+) button all use a glass material with edge refraction.bgBlur)
and brightness (brightness) independently so the background sits perfectly
under the glass.settings.section, beside
General / Model / Plugins) with two groups: Page Background and
Input Card · Frosted Glass. All changes apply in real time; Reset to
defaults restores everything.body.dsh-lg-on class, so disabling leaves zero
residue.filter: blur() on a dedicated background layer
(inset: -48px for bleed room), never backdrop-filter on #root —
a non-none backdrop-filter makes #root the containing block for every
position: fixed descendant (menus, popups, toasts), re-anchoring them.src/index.ts Host half: wallpaper file routes, file upload, web proxy
src/client/index.ts Browser half: token overrides, background layer, glass params, settings panel
src/shared.ts Shared constants and settings types (zero runtime dependencies)
build.mjs SWC build pipeline (lib/index.js + lib/client.js in loader format)
dsh plugin add --profile web dsh-theme-liquid-glass
Refresh the browser.
Compatibility: requires DeepSeek Harness ≥
0.1.2-rc.1. Earlier harness versions use the removeddsh-client-runtimepackage and are not supported by v0.4.0.
Link your source directory into the profile's node_modules with a Windows
junction (a plain dsh plugin add "<absolute-path>" can produce a broken
relative symlink and drop the plugin from the profile bundles list):
# 1) remove any stale entry
dsh plugin remove --profile web dsh-theme-liquid-glass
# 2) junction the source dir into the profile
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-theme-liquid-glass" `
-Target "<absolute-path-to-theme-source>" -Force
# 3) ensure the theme is listed in the profile bundles
dsh plugin add --profile web dsh-theme-liquid-glass
Refresh the browser.
After modifying code: rebuild, then refresh.
cd <theme-source-dir> node build.mjsClient changes (settings UI, glass params) take effect after a build + browser refresh. Host changes (routes, upload endpoint) require a
dsh webrestart to reload the host half.
npm install
npm run build # one-shot build (lib/index.js + lib/client.js)
npm run watch # watch mode (works with client-hmr hot-reload)
npm run dev # build + smoke test
npm test # run the client smoke test
npm run typecheck # tsc --noEmit
The client bundle exports an inject array of service names:
['slots','locale','theme'] (matching the shipped dsh-ui-appearance /
dsh-dream-skin plugins). The client loader builds the fiber injection table
from this array; missing it causes cannot get property X without inject and a
hard web-boot failure. The apply() function itself is wrapped in try/catch —
runtime errors degrade gracefully without crashing the GUI.
Settings are stored in localStorage (key dsh-liquid-glass.settings), not
through the settings RPC. The harness settings gateway only exposes hard-coded
product namespaces to browser clients — a third-party namespace stays loading
forever even when the host half registered it. The shipped dsh-ui-appearance
and dsh-dream-skin plugins hit the same wall and both chose localStorage.
Trade-off: settings are per-browser — switching browsers or clearing site data loses them.
| Field | Description |
|---|---|
enabled | Master switch |
wallpaper.kind | none / url / html / image / video / local |
wallpaper.value | Web URL or relative path under the wallpapers directory |
wallpaper.proxy | Route web URLs through the host proxy (bypasses X-Frame-Options) |
wallpaper.muted | Mute video wallpapers (default true; unmuting may be blocked by autoplay policy) |
demo.speed | Demo wallpaper animation speed multiplier 0.1–4 (step 0.1) |
demo.blobs | Demo wallpaper blob count 1–6 |
demo.colorCycle | Demo wallpaper color cycle 0–10 (0 = static) |
demo.blur | Demo wallpaper blob blur 10–140px |
demo.opacity | Demo wallpaper blob opacity 0.2–1 |
demo.wash | Demo wallpaper background gradient wash toggle |
glass.frosted | Frost toggle (input card / bubbles / dock backdrop blur) |
glass.blur | Input card frost blur radius 0–60px |
glass.bgBlur | Background wallpaper blur 0–60px (independent of card frost) |
glass.refraction | Edge refraction 0–1 |
glass.tint | Glass color |
glass.tintOpacity | Glass color opacity 0–1 |
glass.toolTextColor | Tool call text color (hex, empty = default) |
glass.codeBlockOpacity | Code block background opacity 0.2–1 (independent of tint opacity) |
glass.glassBrightness | Glass material brightness 0.2–1.6 (tint lightness scaling; >1 brighter, <1 darker) |
glass.brightness | Background brightness 0.2–1.6 |
On first enable, the plugin checks whether demo.html exists under
<DSH_HOME>/wallpapers. If missing, it writes the built-in demo wallpaper
(existing files are never overwritten). The default path is
$DSH_HOME/wallpapers/demo.html; the directory can be changed via the
wallpaperDir config option.
Input card with edge refraction Chat interface with glass bubbles Settings panel