Skip to main content

How to use dsh-theme-plugin

Provides 98 Chinese traditional color themes (49 anchor colors × light/dark variants) for DeepSeek Harness, featuring a settings panel and deep link switching, all passing WCAG AA contrast requirements.

This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.

This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

dsh-theme-plugin

— source: plugin_wiki.wiki_content

Install & verify

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

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

  • Verify — the browser console logs registered 98/98 themes (49 light / 49 dark), and dsh --profile web --dump-config shows a theme-zhongguo row.
  • Update — run the same add command again.
  • Uninstall — dsh plugin --profile web remove dsh-theme-plugin
  • pnpm build needs tsdown; node scripts/build-esbuild.mjs is the fallback.

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

How to confirm the plugin is working after installation?

After opening DSH Web, check the browser console. When you see the line registered 98/98 themes (49 light / 49 dark), it means all 98 themes have been successfully registered.

Where is the theme selection saved? Does it sync with the account?

The saved theme is stored in the browser's localStorage (key name dsh:theme-zhongguo:theme), it won't be written to settings.yaml, so it won't follow when switching devices or browsers.

Do I need additional configuration after installation?

No configuration needed. This plugin intentionally doesn't expose configuration items. DSH 0.1's client startup list doesn't carry host plugin configurations, so all interactions go through the settings panel or #theme= deep links.

How to switch themes?

Two ways: select in the "Settings → Traditional Color Theme" panel, or directly open a deep link like http://127.0.0.1:3080/#theme=zhuqing-light; after selection, the theme= parameter in the hash will be automatically cleared.

How to uninstall?

Execute dsh plugin --profile web remove dsh-theme-plugin. The next time you start DSH, the "Traditional Color Theme" entry will disappear from the panel.

What are the 49 anchor colors?

49 Chinese traditional colors (such as bamboo green, vermilion, ultramarine, gamboge, purplish red, etc.), each anchor color spawns light/dark theme variants, totaling 98 themes. Among them, 12 are marked as "Featured" and placed at the top of the panel.

Do themes affect code block syntax highlighting?

Yes, each theme fills all 9 shiki --shiki-token-* slots. The five color slots retain the familiar hue intuition for programmers, while comments and punctuation are reduced to ink colors rather than colorful, ensuring readability.

Why must -w be used during local development installation?

Because the profile directory is the pnpm workspace root; -w installs the plugin as a directory symlink and writes to dsh.profile.bundles. After changes, you must run pnpm build for the host to read the new lib/client.js.

— source: plugin_wiki.faq_json

Compatibility

  • DSH: 未声明（peerDependencies 标 *，实测面向 DSH 0.1.x 的 web 客户端）
  • Node: >=20

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule

How to use dsh-theme-plugin