Preface¶

In the DSH Web GUI, theme adjustments typically go beyond simply changing an accent color: background, foreground, fonts, sidebar, and contrast all affect usability during long reading sessions. dsh-theme-plugin addresses these needs by offering 5 preset themes and customization options per light/dark mode, applied instantly within the current web session.

What This Is¶

dsh-theme-plugin is a theme plugin for the DeepSeek Harness (DSH) Web GUI. It provides 5 built-in presets and supports customizing accent, background, foreground, UI font, code font, translucent sidebar, and contrast per light/dark mode.

The repository owner is BeiZi6, the author in package.json is Xu Yuanshan, and the license is MIT.

Core Features¶

The following capabilities are derived from verified sources.

• Built-in presets: stock, codex-warm, nord, solarized, graphite.
• Per-mode customization: light.* and dark.* can set accent, background, foreground, UI font, code font, translucent sidebar, and contrast.
• Instant application: Changes are applied via the official ctx.theme.overrideTokens API without requiring a page refresh.
• Local persistence: Selections are saved in the browser’s localStorage and retained after refresh.
• Token derivation: Over 70 semantic tokens are derived from background, foreground, accent color, and contrast.
• Injection method: Theme styles are injected into index.html via the official webServer.tapIndex seam without modifying vendor files.
• Settings interface: Provides a Settings → Theme Studio GUI with controls for presets, colors, fonts, translucent sidebar, and contrast.

Additionally, the stock preset does not derive a color palette, disables color controls, and only allows font overrides; the custom mode starts from the codex-warm palette and uses values from light.* / dark.*.

Installation and Activation¶

Prerequisites include DSH with the web profile enabled, and a restart of dsh web is required after installation.

Installation command:

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

Then restart or start dsh web:

dsh web

To remove the plugin, you can run:

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

Environment requirements:

• Node.js >= 22.19
• License: MIT

Typical Usage¶

Using the Settings Interface¶

After restarting, open Settings → Theme Studio. You can select a Preset and adjust Colors, Fonts, Translucent sidebar, and Contrast. GUI selections take precedence over host config.

Each change is applied instantly and saved locally.

Configuring in the Web Profile Patch¶

You can also add a theme-plugin configuration to the web profile patch. The path is:

$DSH_HOME/profiles/web/cordis.patch.yml

An example configuration is shown below. Here, codex-warm is used as the preset, and key fields for both light and dark modes are set:

- id: theme-plugin
  config:
    preset: codex-warm
    light:
      accent: '#FF6B35'
      background: '#FFFAF0'
      foreground: '#1A1A1A'
      uiFont: '"Inter", "PingFang SC", sans-serif'
      codeFont: '"JetBrains Mono", Consolas, monospace'
      translucentSidebar: off
      contrast: 70
    dark:
      accent: '#FFB07A'
      background: '#1A1A1A'
      foreground: '#F5F5F5'
      uiFont: '"Inter", "PingFang SC", sans-serif'
      codeFont: '"JetBrains Mono", Consolas, monospace'
      translucentSidebar: on
      contrast: 70

Only set the fields you need to change. An empty string retains the preset value; unset fields are not overridden.

Applicable Scenarios and Notes¶

Suitable for scenarios where you want to adjust light/dark themes, fonts, sidebar, and contrast in the DSH Web GUI according to personal preferences. Before using the plugin, it is recommended to review its source code, license, and scope of behavior; the plugin runs with the permissions of the current dsh process.

Please note:

• A restart of dsh web is required after installation.
• GUI selections take precedence over host config.
• Color controls are unavailable under the stock preset; only fonts can be overridden.
• The custom mode starts from the codex-warm palette and uses light.* / dark.* fields.

Links¶

The value of dsh-theme-plugin lies in centralizing DSH Web GUI theme adjustments into preset-based and mode-based configuration: select a preset first, then adjust colors, fonts, sidebar, and contrast per light/dark mode, and finally apply instantly with persistence.

GitHub repository:

https://github.com/BeiZi6/dsh-theme-plugin

The directory page URL was not present in the verified sources, so no link is provided in this article.