dsh-theme-plugin

English · 简体中文

Theme studio for the DeepSeek Harness (DSH) Web GUI: five built-in presets plus fully customizable light/dark palettes — accent, background, foreground, UI and code fonts, translucent sidebar and contrast — applied instantly, with no page refresh.

Features

• 🎨 5 built-in presets — codex-warm, nord, solarized, graphite, plus the stock DeepSeek theme
• 🖌️ Full customization — per-mode (light.* / dark.*) accent, background, foreground, UI font, code font, translucent sidebar and contrast; custom mode starts from scratch
• ⚡ Instant hot-swap — a Settings GUI ("Theme Studio") applies changes immediately through the official ctx.theme.overrideTokens API; light/dark follow the system preference
• 💾 Persistent — the selection is saved in browser localStorage and survives reloads
• 🧮 70+ derived tokens — three colors plus a contrast value expand into the whole semantic token set (borders, layers, scrollbar, tooltip, code blocks, bubbles, sidebar states…)
• 🪟 Translucent sidebar — real frosted sidebar via the --dsw-specific-sidebar-fill variable
• 🔌 Official seams only — host-side injection through webServer.tapIndex, no patched vendor files

Installation

Requires DeepSeek Harness with the web profile enabled. Install from the official registry:

dsh plugin --profile web add github:BeiZi6/dsh-theme-plugin

Restart dsh web for the plugin to take effect.

To remove:

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

Usage

Settings GUI (recommended)

After a restart, open Settings → Theme Studio:

• Preset — one-click chips: DeepSeek default / Codex warm / Nord / Solarized / Graphite / Custom
• Colors — color pickers for accent, background and foreground, with a "follow preset" reset
• Fonts — dropdowns for the UI font and the code font (common stacks included)
• Translucent sidebar — follow preset / on / off
• Contrast — slider 0–100 with preset restore

Every change applies instantly and persists locally; GUI selections take priority over host config.

The stock preset derives no palette: color controls are disabled and only fonts can be overridden.

Config reference

Field	Type	Description
preset	enum	stock · codex-warm · nord · solarized · graphite · custom (default codex-warm)
light.accent	color	accent for light mode (primary buttons, links, …)
light.background	color	light-mode background
light.foreground	color	light-mode primary text
light.uiFont	CSS font-family	UI font stack
light.codeFont	CSS font-family	code font stack
light.translucentSidebar	enum	preset · on · off
light.contrast	number	0–100; -1 = keep preset value
dark.*	—	same fields for dark mode

Empty strings mean "keep the preset value"; unset fields are not overridden at all.

Example — merge into the web profile patch ($DSH_HOME/profiles/web/cordis.patch.yml):

…