Skip to main content

dsh-ui-web/packages/skins/aurora

34Stars2Forks0Issues0Watchers

Provides Aurora skin for DSH Web GUI featuring: custom background image/video, translucent frosted glass panels, adjustable opacity and blur, plus an inference level slider panel.

Categories▣ UI Enhancements◈ Themes & Skins
Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki

ⓘ This plugin is a sub-package of the CAPTAIN1275/dsh-ui-web monorepo — stars and activity count the whole repository.

CAPTAIN1275CAPTAIN1275
·CAPTAIN1275/dsh-ui-web
Language
TypeScript
License
Apache-2.0
Branch
main
dsh-plugindsh-plugin-marketdsh-plugins

Install

cmdweb profile
$ dsh plugin --profile web add @captain1275/dsh-client-ui-skin-aurora

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 CAPTAIN1275/dsh-ui-web/packages/skins/aurora for me: review the repository at https://github.com/CAPTAIN1275/dsh-ui-web 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

The Aurora Skin is an official skin pack for DSH Web GUI that replaces the default interface with a translucent frosted glass style: supports custom local or remote background images and videos, falling back to built-in aurora gradients when left empty; also includes a slider panel that replaces the default effort level list.

Core Features

  • Custom Background: Enter any http(s) image/video URL, or use "Choose File..." in settings to upload local files
  • Auto-adapt to Light/Dark Theme: Renders dark blue-purple aurora gradient for dark theme and light blue-purple aurora gradient for light theme when background is empty
  • Adjust Opacity and Blur: Background layer provides 0.1–1 opacity and 0–40px blur sliders
  • Video Background: Automatic looped muted playback, supports HTTP Range streaming (video seekable)
  • Frosted Glass Panel: Based on aqua mechanism, glass blur and frost can be adjusted via skin center sliders
  • Effort Level Slider Panel: Click the "Effort" row in the official model menu to pop up a continuous slider panel that replaces the default list

Technical Implementation

  • Language: TypeScript
  • Key Dependencies: @deepseek-ai/cordis (plugin runtime), @deepseek-ai/dsh-client-runtime (client framework), @deepseek-ai/dsh-client-ui-settings (settings integration), @deepseek-ai/dsh-client-ui-settings-general (settings slot)
  • Architecture Pattern: Dual-hemisphere plugin—the host hemisphere registers /api/skin-aurora/* routes via ctx.inject(['webServer']) for config read/write and media storage; the browser hemisphere attaches body attributes, background layer, and event linkage via apply(ctx); styles concentrated in CSS Modules + token overrides, all scoped under body[data-dsh-aurora]
  • Entry Points: Host src/index.ts, browser src/client/index.ts, skin settings card src/client/AuroraCard.tsx

Use Cases

Heavy users of DSH Web GUI who want to make the chat interface less monotonous: use favorite wallpapers, GIFs, or videos as background, overlay translucent panels for "frosted glass" texture; also want to fine-tune official model effort levels with sliders without leaving the interface.

Prerequisites and Compatibility

DependencyMinimum VersionDescription
DSH>= 0.1.0-rc.6Explicitly declared in peerDependencies
NodeNot declaredNo engines set in source
PlatformCross-platformNo os/cpu restrictions declared
Native modulesNoneOnly uses Node built-in fs/path/os/crypto

Installation

dsh plugin --profile web add github:CAPTAIN1275/dsh-ui-web/packages/skins/aurora

Configuration Options

ConfigTypeDescriptionDefault
enabledbooleanWhether to enable the Aurora skin effect; returns to native appearance when disabledtrue
backgroundUrlstringBackground image or video URL; can be http(s) URL or local media path, uses built-in aurora gradient when empty""
opacity0.1–1Background layer opacity0.8
blur0–40Background layer blur radius (pixels)0
mediaTypeimage / videoMedia type of background; auto-detected from URL, can also manually select videoimage
mutedbooleanWhether video background plays muted in loop; uncheck for video with audiotrue
Glass blur0–40Frosted glass panel blur radius (skin center slider, writes to localStorage)14
Glass frost0–100Frosted glass frost intensity (skin center slider, writes to localStorage)50

FAQ

Q: The skin doesn't take effect immediately after installation. What should I do?

A: Check if the "Aurora Skin (Custom Background)" card switch in DSH "Settings - General" is turned off; if the interface is still native after installation, refresh the browser page or restart DSH, and the config will persist in ~/.dsh/skin-aurora.json.

Q: Video plays normally but the progress bar can't be dragged?

A: Video is served by host /api/skin-aurora/media/<file> and implements HTTP Range streaming. If the progress bar can't be dragged, the DSH host is likely behind a reverse proxy that strips the Range header; please ensure the proxy forwards Range / Accept-Ranges.

Q: How to troubleshoot upload failures or missing media?

A: Server allows maximum 200MB request body; images are automatically compressed to within 1920 pixels before upload. Media files are stored in DSH_HOME/skin-aurora-media/ (default ~/.dsh/skin-aurora-media/); uninstalling the plugin doesn't automatically delete this directory, please clean up manually.

Q: The "Effort" panel opens but has no response or is unusable?

A: The panel only intercepts the row with label "Effort" in the official model menu; the panel needs to first get the model catalog of the current session via sessions.models, displays "Loading model catalog..." before loading completes, and the panel becomes available after loading.

Q: Will config sync to cloud or DSH official settings bridge?

A: No. Aurora config is completely stored in host local ~/.dsh/skin-aurora.json file (bypassing the settings bridge's namespace whitelist), and won't auto-sync when switching devices.

Q: How to completely remove the skin and all data?

A: After removing the plugin in DSH, manually delete ~/.dsh/skin-aurora.json and ~/.dsh/skin-aurora-media/ directories; the glass blur/frost values are stored in browser localStorage, can be cleaned in developer tools by clearing dsh.ui-skin-aurora.* keys.

Getting Started Difficulty

Beginner — Installed and enabled by default, config options centralized in the settings card, no code changes needed; enter settings to adjust URL, opacity, blur, and glass effects when customization is desired.

Known Issues and Limitations

  • Upload request body limit is 200MB (src/index.ts:115-119), local videos larger than this cannot be uploaded and need to be hosted via URL
  • Glass blur max 40, frost max 100, values exceeding these are clamped by the server (src/client/aqua/theme-layer.ts:51-55), exceeding values won't persist
  • Glass blur/frost values are only saved to browser localStorage, not synced across multiple browsers or devices
  • Sidebar collapsed state is remembered via localStorage['dsh.ui-skin-aurora.sidebar-collapsed'], clearing cache or private mode will lose collapse memory

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/CAPTAIN1275/dsh-ui-web/packages/skins/aurora)

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