Skip to main content

dsh-client-ui-skin-denia

23Stars4Forks3Issues0Watchers

A Dania-themed skin for the DSH Web client featuring pink-purple gradient colors, dual-form switching animation, artwork and Q-version mascot, bubble particle field, and a visual color palette.

Evidence4/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
Language
JavaScript
License
NOASSERTION
Branch
main
dsh-plugin

Install

cmdweb profile
$ dsh plugin --profile web add github:Ewnscat-ya/dsh-client-ui-skin-denia

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 Ewnscat-ya/dsh-client-ui-skin-denia for me: review the repository at https://github.com/Ewnscat-ya/dsh-client-ui-skin-denia 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

Apply a complete "Denia" visual skin themed after Wuthering Waves to the DSH Web client, transforming the interface into a fan-made style featuring pink-purple gradients, bubble and chain decorations, with a visual color palette in the bottom-right corner for full customization of every detail.

Core Features

  • Switch overall interface color scheme: covering backgrounds, glass card layers, sidebar chibi mascot, left/right character portraits, chain borders, corner stars and rainbow decorative strips
  • Switch to Denia's dual forms: Form of Scenery (light color, lazy campus atmosphere) / Dissolution Form (dark color, resonant liberation ethereal starry sky), playing approximately 4-5 seconds of form transformation animation when switching
  • Decoration field overlay: background frosted sheer + double-layer iridescent bubble particle field (quantity and speed adjustable) + deep purple chain border following sidebar width
  • Text and button renaming: replace DSH's light/dark mode toggle button text with "Form of Scenery / Dissolution Form", change workspace and session titles to pink-purple gradient
  • New session welcome screen injection: when chat is empty, display "Denia" title + subtitle + dialogue bubbles
  • Visual color palette: drawer-style panel in the bottom-right corner of the interface; all parameters sliders/switches/upload take effect immediately, persist after refresh
  • Smart联动淡出: when right workbench panel opens or DevTools is docked, portraits and chibi automatically fade to 20% to avoid blocking view
  • Automatic update check: each load calls GitHub Releases API to compare versions, with update availability prompt at bottom of color palette

Technical Implementation

  • Language: JavaScript (ESM, browser-side single-file bundle)
  • Key Dependencies: @deepseek-ai/cordis (peer) as plugin host contract; no npm runtime packages required, all assets are inline base64
  • Architecture Pattern: Cordis pure client plugin: node-side entry point lib/index.js only provides empty apply() placeholder (no node services attached), all implementation in lib/client.js, injected into DSH Web browser context via window.__ModuleLoader__.load({ id, factory }); registered via ctx.effect(dispose) for cleanup hooks that restore injected DOM, data-* attributes, <style>, <meta theme-color> and other modifications when switching skins
  • Entry Files: cordis.patch.yml (registers ui-skin-denia into web profile's client injection whitelist) + lib/client.js (browser-side main logic)

Use Cases

Users who want to customize the DSH Web interface with their preferred anime/game character theme, or those seeking enhanced visual atmosphere beyond DSH's default minimalist style while preserving full conversation functionality. Particularly suited for Wuthering Waves Denia fans or users drawn to pink-purple/bubble decoration aesthetics.

Prerequisites & Compatibility

DependencyMinimum VersionDescription
DSH Web0.1.0-rc.6 – 0.1.0-rc.7From package.json#dsh.client.version; outside this range, bundle patch may refuse to load
Node.jsNot requirednode-side entry apply() is empty; this plugin has no node scripts or build steps
Cordis^4.0.1peerDependencies declaration
PlatformWeb onlydsh.client.platform = "web"; desktop/host not supported
Native modulesNoneBrowser-side single-file bundle; no node-pty / node:sqlite etc.

Installation

dsh plugin --profile web add github:Ewnscat-ya/dsh-client-ui-skin-denia

Configuration Options

This plugin doesn't require config.json. All configuration is adjusted via the "Color Palette" panel triggered by the purple circular button in the bottom-right corner, with results automatically written to browser localStorage (key denia-palette-settings). The panel divides into two groups:

GroupConfigRange / TypeDescriptionDefault
Light / Dark (per-form independent)Background imageUpload / ClearUpload custom background image or clear to restore default illustrationDefault
Light / Dark (per-form independent)Left portraitToggleShow/hide left character full-body portraitOn
Light / Dark (per-form independent)Right portraitToggleShow/hide right character full-body portraitOn
Light / Dark (per-form independent)Chibi mascotToggleShow/hide sidebar bottom chibi GIF expressionOn
Common (applies to both light and dark forms)Chat width500 – 1000 pxMain chat column width780 px
CommonPortrait height30 – 80 vhCharacter portrait viewport height ratio55 vh
CommonPortrait horizontal offset−50 – 50 pxLeft/right portrait horizontal offset0 px
CommonExpression size60 – 240 pxSidebar chibi GIF dimensions120 px
CommonExpression vertical offset−200 – 200 pxSidebar chibi GIF vertical displacement0 px
CommonBackground opacity20 – 100 %Background illustration opacity100 %
CommonMessage text boxToggleAdd decorative border to AI response bubbles (turning off hides border but preserves opacity control)Off
CommonText box opacity20 – 100 %Message bubble border opacity68 %
CommonBubble particle fieldToggleShow floating iridescent bubbles on backgroundOn
CommonBubble count5 – 40Number of bubbles on screen simultaneously20
CommonBubble speed30 – 200 %Bubble float animation speed multiplier100 %
CommonChain borderToggleDeep purple chain decoration on sidebar right edgeOn
CommonDecoration stripsToggleRainbow gradient decoration strips at top/bottomOn
CommonRestore defaultsButtonOne-click reset all options above—

FAQ

Q: Where do I switch skins after installation?

A: After restarting DSH Web, go to Settings → Skins and select "Denia · Void Bubbles"; if you don't see the entry in the list, confirm the ui-skin-denia line in cordis.patch.yml isn't commented out with disabled: true, or manually run cd <harness>/profiles/web && npm i ../dsh-client-ui-skin-denia to force re-linking.

Q: The interface doesn't change after enabling. What should I do?

A: The skin mounts by injecting a data-dsh-denia attribute into <body>. When another skin or conflicting logic takes over, this attribute gets cleared. You can verify by running document.body.dataset.dshDenia === '' in DevTools console; if it's undefined, another skin has taken precedence.

Q: Does it support DSH desktop (host profile)?

A: No. The dsh.client.platform in package.json is restricted to web, and the bundle patch only inserts into the web client injection list. The host side cannot load this package.

Q: Can it be used commercially?

A: The repository uses CC BY-NC-SA 4.0 license, commercial use prohibited; Denia / Wuthering Waves are trademarks of Kuro Games, this skin is a fan-made work unrelated to Kuro Games. See the attribution chain in the NOTICE file.

Q: Will settings in the color palette sync across devices?

A: No. All parameters are stored in browser localStorage under the key denia-palette-settings. Switching devices or clearing cache requires reconfiguration; to reset to factory defaults, click the "♻ Restore Defaults" button at the bottom of the panel.

Q: Why can't I sometimes see portraits and chibi?

A: The skin monitors the right workbench panel and DevTools docking state. When they're open, portraits and chibi automatically fade to 20% opacity to avoid blocking content; they restore when closed (MutationObserver in client.js:798-803).

Q: Does the skin auto-update?

A: It doesn't auto-download. Each load requests the GitHub Releases API (15s timeout, HTTP 403/network errors fail silently) to compare the latest tag. When a new version is found, a "✨ vX.Y.Z available →" link appears at the bottom of the color palette, requiring manual execution of the install command to upgrade.

Q: How do I completely uninstall?

A: Delete the profiles/web/node_modules/@dsh-external/dsh-client-ui-skin-denia/ directory, or run dsh plugin remove @dsh-external/dsh-client-ui-skin-denia (if this command is available in your DSH version), then restart DSH Web. The skin's cleanup hooks (client.js:1481-1514) will remove all injected DOM, CSS variables, <style>, <meta theme-color> and other side effects.

Ease of Use

Beginner — After installation and restart, simply select it from "Settings → Skins". All adjustable options are in the color palette in the bottom-right corner. Just open it and you'll see Chinese prompts. No coding or config file editing required.

Known Issues & Limitations

  • In DevTools docked mode, left/right portraits and sidebar chibi are forced to 20% opacity to avoid covering the console (introduced in v0.0.4; client.js:798-803). For debugging, temporarily close DevTools or disable portrait switches first.
  • Earlier versions (before v0.0.2) experienced: chibi not displaying after refresh, chat width slider not working, portrait flickering. Root cause was DSH Web's async React rendering with hashed classNames not matching the skin's assumed stable selectors. Fixed by using getBoundingClientRect instead of getComputedStyle, adding 2-second retry delay, and switching to match real DOM elements _centerCol/_viewArea/_composerSeat (see README.md v0.0.2 changelog).
  • Historical "Ripple + Ethereal Erosion" animations were actively removed as they caused hover jitter, replaced by current "Message Text Box" decoration controlled by color palette toggle (client.js:312-314).
  • The color palette version check requires accessing api.github.com and silently gives up after 15 seconds; if your network is restricted (e.g., proxy/VPN extending TLS handshake), the new version prompt may not display. Manual comparison needed.
  • Only supports web client; does not support host/desktop profile, and is sensitive to DSH Web version (dsh.client.version limited to 0.1.0-rc.6 – 0.1.0-rc.7). Future major DSH updates may cause the skin to become ineffective.

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/Ewnscat-ya/dsh-client-ui-skin-denia)

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