Introduction

The default interface of DeepSeek Harness Web (dsh web) is a neutral engineering style. Staring at it for a long time, there are basically two ways to adjust the look: modify the interface styles yourself, or wait for a ready-made theme mechanism. DSH’s philosophy is “everything is a plugin,” so changing the interface outfit can also be left to a plugin.

Below introduces dsh-columbina-theme, a theme plugin maintained by hyposelen1a: it applies the theme of the Genshin Impact character “Columbina” to DSH Web — background, mask, color scheme. After installation, it takes effect immediately on the first frame without needing to modify DSH’s code itself.

What is it

dsh-columbina-theme is a theme plugin built for DeepSeek Harness Web. One-sentence positioning: background, mask, color scheme — moonlight from Natlan. The plugin is categorized as “Fun Outfit,” current version 0.1.1, code uses MIT license.

The plugin comes with two preset backgrounds: columbina-1 for light mode, columbina-2 for dark mode. When switching light/dark modes, the background and color scheme switch together.

Core Features

The plugin’s capabilities are divided into two groups: one is the theme itself, the other is the implementation method.

Theme Part:

  • Light/Dark Dual Defaults: Light default background columbina-1 + light color scheme, dark default background columbina-2 + dark color scheme;
  • Adjustable Mask: 0% equals original background effect (main interface panel transparency syncs to zero), higher means more opaque, 100% fully covers the current light/dark theme background color;
  • Custom Colors: Mask, input box, sidebar, font colors are all customizable, leave blank to follow light/dark theme defaults;
  • Custom Background: Upload PNG/JPEG/WebP/GIF images as background; any image placed in the assets/backgrounds/ directory automatically becomes a preset;
  • Selected Session Title Effect: Current session title uses blue-purple gradient text and glow;
  • Transparent Interface Surface: Transparency of main content surfaces (session area, bubbles, etc.) follows mask settings; input box fixed at 80% opacity; sidebar and floating layers are always opaque to ensure readability.

Implementation Part:

  • Takes Effect Immediately: Theme styles are injected on every page response via webServer.tapIndex, no flash on load;
  • Custom Image Limits: Uploaded custom images limited to under 15MB; bitmaps over 512KB generate a 640px wide JPEG preview thumbnail on the server to avoid loading the original image in the settings interface.

Installation and Activation

Prerequisites: DeepSeek Harness (dsh), Node.js ≥ 22, pnpm in PATH.

  1. First, completely exit DSH (not just close the browser tab).

  2. Install the plugin. Install from GitHub:

dsh plugin --profile web add github:hyposelen1a/dsh-columbina-theme

After the plugin is released to npm, you can also install directly by package name:

dsh plugin --profile web add dsh-columbina-theme

For local development and debugging using link, replace the path with your actual directory:

dsh plugin --profile web add link:/path/to/dsh-columbina-theme
  1. After the above steps, restart dsh web and hard refresh the browser (Ctrl+F5), then open Settings → Plugins → Columbina Theme to configure.

If you don’t want to uninstall and just want to temporarily disable it, edit $DSH_HOME/profiles/web/cordis.patch.yml, add the following two lines and restart:

- id: dsh-columbina-theme
  disabled: true

Delete these two lines (or change back to false) and restart to re-enable.

Typical Usage

After installation, the plugin’s settings entry is in Settings → Plugins → Columbina Theme. Common items:

  • Background Preset: Leave blank for auto (light columbina-1 / dark columbina-2);
  • Upload Custom Image: Supports PNG/JPEG/WebP/GIF, not exceeding 15MB, used as background after upload;
  • Mask Opacity: 0% is original effect, 100% fully covers current light/dark theme background color;
  • Colors: Mask, input box, sidebar, font colors are all customizable, leave blank to follow light/dark theme;
  • Selected Session Title Effect: Toggle the gradient + glow effect for the current session title.

To add your own preset backgrounds, just put the images in the plugin’s assets/backgrounds/ directory. Filenames can only contain letters, numbers, -, _ (e.g., columbina-3.jpg), support svg/png/jpg/jpeg/webp/gif formats. After restarting DSH, they automatically appear in the preset grid, no need to change code.

Bitmaps over 512KB will automatically use the server-generated 640px wide JPEG preview thumbnail to avoid loading the original image in the settings interface. Uploaded custom images and preset thumbnails are cached uniformly in $DSH_HOME/storages/dsh-columbina-theme/.

All plugin settings are saved under the dsh-columbina-theme namespace in $DSH_HOME/settings.yaml.

Applicable Scenarios and Notes

Suitable for: Players and developers who use dsh web daily and want to change the interface to a fixed style without modifying DSH’s code itself.

A few known limitations, it’s recommended to check before installing:

  • Compatibility: The plugin was developed for DeepSeek Harness 0.1.0-rc.7 (@deepseek-ai/cordis ^4.0.1, dsh-* ^0.1.0-rc.7). DSH is still in the developer preview stage, and interfaces may undergo breaking changes; if the theme fails after upgrading, first check the repository’s CHANGELOG and release notes.
  • DOM Structure: The selected session title effect relies on the DOM structure of the session row. When DSH interface internal class names change with versions, selectors may need adjustment.
  • CSS Tokens: Surface transparency is implemented via CSS token overrides. After DSH version upgrades, individual surfaces may no longer be controllable.
  • Concurrency: When sharing $DSH_HOME/settings.yaml across multiple instances, the last concurrent write wins.
  • Copyright: Copyright needs to be viewed separately: Code and program-generated preset resources use MIT license; the two background images columbina-1.png / columbina-2.png bundled with the package are author’s own assets, copyright belongs to the original author, see ASSET_LICENSE.md in the repository for details.

As usual, a reminder: When installing any DSH plugin, the plugin runs with the permissions of the current dsh process. The code for dsh-columbina-theme uses the MIT license and is open source on GitHub; it is recommended to check the source code and license yourself before installing.

Conclusion

dsh-columbina-theme does only one thing: turn DSH Web into the “Columbina” theme while keeping the interface readable and usable. Light/dark dual defaults, adjustable mask, and a background mechanism that becomes a preset just by putting it in a directory, keeps the custom threshold low. If you want an out-of-the-box outfit solution, or want to see how web profile theme plugins are written, its repository is worth reading.

  • GitHub Repository: https://github.com/hyposelen1a/dsh-columbina-theme
  • Community Directory Page: https://www.skillhub.cn/plugins/hyposelen1a/dsh-columbina-theme