dsh-theme-whalegirl

DeepSeek-鲸鱼娘 (Whale Girl) theme for the DeepSeek Harness (DSH) Web UI — ported from the DreamSkin skin package ver_cb557ececaa5de3f3dbe.

English | 中文

What it does

• Full token remap — registers one light theme (deepseek-whalegirl) into DSH's native theme runtime with a complete --dsw-* dictionary (174 tokens): every surface, label, border, button, markdown block, scrollbar and state color derives from the DreamSkin palette.
• Ambient wallpaper — the whale-girl artwork sits as a fixed backdrop behind a frosted UI; surfaces keep small alpha so it glows through, the app frame gets a backdrop blur.
• DreamSkin safe-css intent — frosted rounded sidebar, coffee-accent composer focus ring, sand selection color, soft violet-tinted shadows.
• Native integration — the theme pins itself through theme.setTheme(); if the built-in Appearance scope resets the preference to system, the plugin re-asserts it. An explicit light/dark pick you make in Appearance wins until the plugin is toggled off/on again.

Palette anchors taken from the source skin:

Role	Source value	Used for
text	#352970	primary labels, ink ladder
highlight	#455b78	brand & primary buttons
accent	#7a4e29	composer focus ring
accentAlt	#ceb683	active nav accent, selection
secondary	#85c1cc	blue/info ladder
panel / panelAlt	#abb4cf / #c3cee4	periwinkle sidebar glass
background	#bd9999	rose paper tint, bubbles

Install

From the dsh-market plugin's Themes tab (search "whalegirl"), or from a terminal:

# prebuilt tarball from GitHub Releases (no build step)
dsh plugin --profile web add -w https://github.com/ZHOUcourier/dsh-theme-whalegirl/releases/latest/download/dsh-theme-whalegirl.tgz

Other sources:

# git
dsh plugin --profile web add -w github:ZHOUcourier/dsh-theme-whalegirl

# npm
dsh plugin --profile web add -w dsh-theme-whalegirl

# local checkout
dsh plugin --profile web add -w link:/path/to/dsh-theme-whalegirl

Then restart the profile:

dsh --profile web

The theme applies immediately once the plugin mounts. To switch away, pick a preference in Settings → General → Appearance (the plugin steps aside); to come back, toggle the plugin off/on in the market Themes tab.

Uninstall:

dsh plugin --profile web remove dsh-theme-whalegirl

Compatibility

• Requires a DSH web client profile (dsh.client.platform: "web", client bundle via exports["./client"]).
• Light appearance only — faithful to the source skin, which ships one light palette.
• Works alongside other plugins; nothing outside the gated body attribute data-dsh-whalegirl is touched when disabled.

Development

npm run build   # wrap src/client.js into lib/client.js + embed assets/background.jpg
npm test        # smoke test: register/guard/dispose against a mocked DOM
npm run check   # verify lib/ matches src/ (CI)

The build is dependency-free (plain Node). lib/ is committed so installs never need a build step.

Credits

• Theme artwork & palette: DeepSeek-鲸鱼娘 on DreamSkin.
• Plugin shape follows the official dsh.bundle manifest convention.

License

MIT. The bundled artwork comes from the DreamSkin package linked above; all rights of the original artwork remain with its author.