Skip to main content

deepseek-harness-desktop/packages/skins/dragon-heir

156Stars5Forks6Issues0Watchers

Provides a "Descendants of the Dragon" theme for dsh web GUI: light-colored ink wash dragon, cinnabar seal with dark Great Wall, and gilded seal—all embedded artwork requiring no internet download, with no impact on model requests or conversation data.

Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki

ⓘ This plugin is a sub-package of the ningbainb/deepseek-harness-desktop monorepo — stars and activity count the whole repository.

Language
TypeScript
License
BSD-3-Clause
Branch
main
ai-agentai-coding-assistantcodexdeepseekdeepseek-harnessdesktop-appdshdsh-plugin

Install

cmdweb profile
$ dsh plugin --profile web add --allow-build=@linxin666/dsh-client-ui-skin-dragon-heir github:ningbainb/deepseek-harness-desktop#path:packages/skins/dragon-heir

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin ningbainb/deepseek-harness-desktop/packages/skins/dragon-heir for me: review the repository at https://github.com/ningbainb/deepseek-harness-desktop first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Line Description

"Dragon Heir" is a theme skin plugin for dsh web GUI, featuring a Chinese-style dual-side design: the light theme follows "Unyielding Dragon Soul" (ink dragon + cinnabar seal + warm paper palette), while the dark theme follows "Great Wall" (ink blue mountains + gilded seal + vast twilight). It only changes the DOM appearance, without affecting model requests or conversation data.

Core Features

  • Mount theme dragon background image across full browser viewport (two WebP artworks embedded as base64 data URLs in bundle, no network download required)
  • Remap dsh theme palette to "Paper + Ink + Cinnabar" and "Indigo + Golden Glow" dual sets
  • Transform main panel, sidebar, menu, input fields and other large-area surfaces into translucent frosted glass, allowing background light to show through
  • Inject "Dragon" seal favicon (cinnabar square seal for light theme, gilded square seal for dark theme), replacing browser tab icon
  • Real-time switching of artwork, mask, filter and seal following host base theme, without re-mounting
  • Complete rollback on dispose: remove body attributes, remove background layer, remove injected favicon
  • Adapt to aionui right panel (File Tree, Git Graph, Preview) and git-graph commit graph lanes and dialogs

Technical Implementation

  • Language: TypeScript + CSS Modules
  • Key Dependencies: @deepseek-ai/cordis (type-only import, effect lifecycle), lightningcss (CSS compilation), tsdown (building)
  • Architecture Pattern: DSH client half-zone plugin; apply(ctx) registers disposer via ctx.effect(...), reverts all writes according to ThemePresenter spec on close; does not inject any cordis services, does not emit events
  • Entry Files: src/index.ts (host-side empty shell) + src/client/index.ts (core logic, 96 lines)

Use Cases

For ordinary users who prefer Chinese-style themes or dragon totems, transforming dsh web GUI into a more Eastern aesthetic visual style. After installation and activation, the entire interface background becomes an ink dragon or Great Wall artwork, panels become semi-transparent with frosted texture, and cinnabar/gilded accent colors run through buttons, links, and Toasts; without affecting any conversation or model behavior. Suitable for daily long-term use, extending personal taste to work desktop, or festive atmosphere (Chinese New Year, Dragon Year) wanting a change of mood.

Prerequisites & Compatibility

DependencyMin VersionNotes
DSHNot DeclaredNo specific DSH version declared in package; as official bundle-form plugin, requires DSH to enable client plugin mechanism
Node.js^22.19.0 || >=24.0.0From repo root package.json#engines
PlatformCross-platformDSH web GUI client; macOS / Windows / Linux can all run the host
Native ModulesNonePure browser-side implementation, no Node native module dependencies

Installation

dsh plugin --profile web add github:ningbainb/deepseek-harness-desktop/packages/skins/dragon-heir

Activation is also required after installation:

dsh-skin use dragon-heir

Configuration

No additional configuration required. apply() internally registers disposer via ctx.effect(...), no manual lifecycle management needed.

FAQ

Q: Does this skin affect my conversation history and model requests?

A: No. It only modifies browser DOM (background image, panel colors, favicon), does not inject any cordis services, does not send requests, does not touch model API, and does not modify KV Cache behavior.

Q: Can I enable multiple skins at the same time?

A: No. Only one skin can be active at a time; when switching, the new skin takes over and the old skin is completely unloaded; use dsh-skin use dragon-heir for switching.

Q: Will there be traces left after closing?

A: No. The effect disposer reverts everything it writes: removes body attributes, removes background layer, removes injected favicon, original page styles fully restored. This is guarded by the "retracts everything on dispose" test case in tests/apply.spec.ts.

Q: Why doesn't the interface change after installation?

A: Installing to profile does not equal activation. You still need to execute dsh-skin use dragon-heir to apply the skin.

Q: Do I need to build locally on first installation?

A: No. When installing via git link, the prepare script automatically builds lib/; however, when pnpm ≥10 first installs git dependencies, you may need to add the printed package key to pnpm-workspace.yaml's allowBuilds list and retry.

Q: Does it support dark mode?

A: Yes. The skin follows host base theme in real-time: light theme uses ink dragon + cinnabar seal + warm paper palette (brightness 1.5), dark theme uses Great Wall + gilded seal + ink blue stone palette (brightness 1.42), artwork masks and filters switch synchronously (defined separately in CSS with selectors like body[data-dsh-dragon-heir][data-ds-dark-theme]).

Q: Will it conflict with aionui right panel and git-graph commit graph?

A: No. The skin includes aionui panel's --aion-* token remapping section (dedicated chapter in CSS), and colors git-graph commit graph lanes with cinnabar/indigo/golden glow series badges; dialogs, menus, and Toasts have frosted glass effect applied, maintaining consistent overall visuals.

Q: What makes it different from other skins?

A: This skin's core selling point is the Chinese-style dual-side dragon artwork (Unyielding Dragon Soul + Great Wall) with cinnabar/gilded overlay palette; the same repo also has other skins like blue-fantasy, miku, minecraft, each with different background artwork and color schemes.

Difficulty Level

Beginner — one command to install, one command to activate, no configuration items, ordinary users can get started.

Known Issues & Limitations

  • Only one skin can be active at a time; switching completely unloads the current skin
  • Intentionally not using backdrop-filter to blur ancestor elements: this would break the containing block of fixed-position overlays (like settings panel), locking them inside parent containers; only used at composerSeat::before
  • Two dragon artworks (WebP base64) embedded with bundle, ~400KB+, adds slight bundle size
  • No explicit known issues like TODO / FIXME / HACK found in current source code

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/ningbainb/deepseek-harness-desktop/packages/skins/dragon-heir)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory