Introduction¶
In the DSH plugin architecture, UI appearance adjustments can be implemented as an installable, uninstallable client layer. For DSH Web users, a specific requirement is to have a set of more stable light/dark visual values while retaining their own light, dark, or system preferences, and to restore the original theme after uninstalling.
ui-song-theme is a plugin built around this need: it provides a Song-inspired light and dark theme layer for DeepSeek Harness.
What is this¶
ui-song-theme is maintained by yunfei07, has the package name ui-song-theme, and is licensed under MIT.
One-sentence positioning: It is a Song-inspired light and dark theme plugin for DeepSeek Harness. It primarily solves the problem of “stacking a layer of fallback theme tokens rather than directly modifying the base theme”.
Core Features¶
- Provides a reversible
ThemeRuntime.overrideTokens()layer containing complete light and dark values. - Preserves the user’s
light,dark, orsystempreference. - Repaints visible legacy blue selections and browser focus outlines to the same botanical color family.
- When uninstalling the plugin, it only removes its own layer and restores the underlying theme.
Installation and Usage¶
Before installation, please confirm that the runtime environment meets the following requirements:
- Node.js
^22.19.0or>=24.0.0 - DeepSeek Harness UI theme
>=0.1.0-rc.6 <0.2.0 - Peer dependencies include
@deepseek-ai/cordis ^4.0.1and@deepseek-ai/dsh-client-ui-theme >=0.1.0-rc.6 <0.2.0
Below, we install the plugin to the Web profile. After executing this command, ui-song-theme will be added to the profile as a theme layer.
dsh plugin --profile web add github:yunfei07/ui-song-theme
After installation, start the Web profile using the following command to check the actual effect under light, dark, and system preferences.
dsh --profile web
Typical Usage¶
If you need a reproducible installation, you can fix a specific commit first. This ensures that subsequent installations to the same profile do not drift with the repository’s default branch.
dsh plugin --profile web add github:yunfei07/ui-song-theme#<commit-sha>
If you no longer need this set of themes during usage, execute the uninstall command. After uninstalling, it will only remove the ui-song-theme layer and restore the theme beneath it.
dsh plugin --profile web remove ui-song-theme
If you need to perform local checks within the repository, you can use the following set of commands to perform install, check, build, and pack checks sequentially.
corepack pnpm@11.21.0 install
pnpm check
pnpm build
pnpm pack:check
Scenarios and Notes¶
This plugin is suitable for users who wish to adjust the visual tokens of the DSH Web interface, especially those who want to preserve light/dark/system preferences and require an uninstallable fallback. Verified capabilities are focused on the theme token layer.
Please note the following:
- The plugin code runs with the permissions of the current dsh process. Please review the source code, dependencies, and license before installing.
- The availability of system fonts may affect the exact Song glyph metrics; specific glyph measurements may vary slightly across different systems.
- The project license is declared as MIT.
Conclusion¶
The value of ui-song-theme lies in transforming the Song-inspired light and dark theme into a stackable, uninstallable DSH plugin layer: providing a complete set of light/dark values upon installation and restoring the original theme upon uninstallation.
The community directory is an independent site with no official affiliation with DeepSeek or Huanfang; the verifiable repository address is listed below: