Preface

The DSH plugin ecosystem emphasizes “everything is a plugin”; the community directory is an independent site with no official affiliation with DeepSeek / Huafan. For scenarios where you need to adjust the appearance, brand terms, Logo, and new session titles in DeepSeek Harness Web without modifying the Harness repository source code, dsh-yizi-themes is a third-party plugin available for use.

It is maintained by laoduu and is licensed under MIT. The old install.sh / install.ps1 / MANIFEST.json / patch/ files are remnants of the early “source code override” solution and have been deprecated. They are kept for reference only; please do not use them.

What is this

dsh-yizi-themes is a third-party DeepSeek Harness theme extension, with its design language ported from YiziMarkdown. It provides 19 high-quality style themes, each supporting both Light and Dark color schemes, and following the “Light / Dark / Follow System” settings.

It installs according to the standard Cordis plugin protocol and is installed/uninstalled via dsh plugin, without modifying any source code in the Harness repository.

Core Features

Themes and Light/Dark Mode

  • Provides 19 high-quality style themes.
  • Light/Dark mode and style themes are completely independent and can be freely combined.
  • You can switch themes / light/dark mode in the top-right corner of the session header; when in a new session (no dialogue), the switch entry is displayed as a floating button.

Custom Branding

  • Logo SVG, brand terms, badge terms, and new session titles are customizable.
  • Brand colors automatically follow the theme and light/dark mode.
  • Brand settings are persisted in the ui-theme.customBrand section of $DSH_HOME/settings.yaml.

If hardcoded colors are used in the SVG, they will not automatically follow the theme. You can change them to:

fill="var(--dsw-alias-brand-primary)"
fill="currentColor"

The former switches with the theme and light/dark mode, while the latter inherits the container color.

Brand Mapping (Experimental)

  • Disabled by default.
  • Allows replacing DeepSeek / 深度求索 / Harness brand terms in the UI / output.
  • Once enabled, it does not rewrite input content.

Installation and Enablement

Prerequisites

You need a DeepSeek Harness repository (including profile) that can run pnpm dsh web.

Web and Desktop versions are two independent profiles and do not communicate with each other. The Desktop version (DSH Desktop App) uses --profile desktop.

Install from GitHub Release

Download 0.4.0 tgz:

curl -L -o dsh-yizi-themes-0.4.0.tgz https://github.com/laoduu/DeepSeek-Harness-yizi-themes/releases/download/v0.4.0/dsh-yizi-themes-0.4.0.tgz

Then execute the installation in the Harness repository directory:

pnpm dsh plugin --profile web add /path/to/dsh-yizi-themes-0.4.0.tgz

Restart the Web端:

pnpm dsh web

If using the Desktop version, replace --profile web with --profile desktop in the command.

Build from Source

Clone the plugin repository:

git clone https://github.com/laoduu/DeepSeek-Harness-yizi-themes.git

After entering the plugin directory, build and package:

node prepare.mjs
npm pack

The generated dsh-yizi-themes-<version>.tgz can be installed using the add command above.

Typical Usage

Switch Themes and Light/Dark Mode

Click the theme / light/dark mode button in the top-right corner of the session header; if the new session has no dialogue content, use the floating button in the same position.

Customize Branding

Go to “Settings → Appearance → Custom”, fill in the Logo SVG, brand terms, badge terms, new session title, and enable brand mapping if desired.

Override Plugin Default Configuration

You can override the following fields in the profile’s cordis.patch.yml:

wordmark:
wordmarkBadge:
headline:
mappingEnabled:
mappingDeepSeek:
mappingDeepSeekChinese:
mappingHarness:
mappingDeepSeekHarness:

These fields are used for brand terms, badge terms, new session titles, brand mapping switches, and the replacement targets for each brand term respectively. Modifications in the settings page take priority over cordis.patch.yml; the configuration serves as the base layer, with the user layer overriding it.

Updates, Uninstall, and Notes

Updates

If the version number changes, you can directly add the new version.

If the version number hasn’t changed but the tgz content has changed, a direct add will not update it, and pnpm may report Already up to date. You need to uninstall and then install:

pnpm dsh plugin --profile web remove dsh-yizi-themes
pnpm dsh plugin --profile web add /path/to/dsh-yizi-themes-<version>.tgz

After updating, you need to fully restart pnpm dsh web and perform a hard refresh in the browser (Ctrl+Shift+R).

Uninstall

pnpm dsh plugin --profile web remove dsh-yizi-themes

The default appearance is restored after restarting. The ui-theme.customBrand section in $DSH_HOME/settings.yaml remains after uninstallation and can be manually deleted.

Compatibility and Configuration

  • Compatible with Harness v0.1.2-alpha.1+; since 0.4.0, it has migrated to @deepseek-ai/dsh-client-store / @deepseek-ai/cordis.
  • Harness v0.1.2-alpha.1 removed @deepseek-ai/dsh-client-runtime; old versions 0.3.x need to be upgraded to 0.4.0.
  • Plugin data uses the core ui-theme namespace (api-proxy whitelist), do not change it to a custom namespace.
  • Expanding the sidebar blank after collapsing it is a bug from older versions; upgrade to 0.2.2+.

Security and License

dsh-yizi-themes is a third-party plugin with an MIT license. It is recommended to check the source code and license before installing. The plugin runs with the current dsh process permissions after installation; do not execute it directly from untrusted sources.

Conclusion

The value of dsh-yizi-themes lies in modifying the appearance and branding of the DeepSeek Harness Web UI via a plugin approach, without directly modifying the Harness repository source code.

Repository URL:

https://github.com/laoduu/DeepSeek-Harness-yizi-themes

The Community Directory URL is unconfirmed and is not listed in this article; if the directory site has an entry for this plugin, please refer to the actual page on that site.