Skip to main content

dsh-ui-web/packages/skins/blue-fantasy

34Stars2Forks0Issues0Watchers

Provides a "Blue Fantasy" theme skin for dsh web GUI: whale illustration background, periwinkle indigo color palette, semi-transparent panels, with no impact on model requests and conversation data.

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.

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-blue-fantasy

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/blue-fantasy 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-Sentence Positioning

「蓝色幻想」is the theme skin plugin for dsh web GUI, porting the DreamSkin「DeepSeek-鲸鱼娘」Codex desktop theme to bring whale illustration backgrounds and a periwinkle indigo color palette to the entire interface. It only changes DOM appearance, without affecting model requests and conversation data.

Core Capabilities

  • Mount whale illustration background image across full browser viewport (base64 embedded, no network download needed)
  • Remap dsh color palette to periwinkle indigo system (light/dark dual sets)
  • Make main panels, sidebar, menus and other large surfaces semi-transparent with background visible
  • Inject official DeepSeek blue whale favicon (PNG, replace browser tab icon)
  • Real-time light/dark mask switching following host base theme, no remount needed
  • On dispose: completely retract - remove body attributes, restore original background image, remove injected favicon
  • Expose --dsw-skin-scrim CSS variable for skin center to adjust scrim concentration in real-time

Technical Implementation

  • Language: TypeScript + CSS Modules
  • Key Dependencies: @deepseek-ai/cordis (type-only import, effect lifecycle), lightningcss (CSS compilation), tsdown (build)
  • Architecture Pattern: DSH client half-region plugin; apply(ctx) registers disposer via ctx.effect(...), retracts all writes per ThemePresenter spec on dispose; does not inject any cordis services, does not emit events; mounts ui-skin-blue-fantasy line via cordis.patch.yml at bundle layer
  • Entry Files: src/index.ts (host-side empty shell) + src/client/index.ts (core logic, 104 lines)

Use Cases

For ordinary users who love whale娘 illustrations and indigo color scheme, transforming the dsh web GUI into a more personalized visual style. After installation and activation, the entire interface background becomes a whale painting, panels become frosted semi-transparent, without affecting any conversation or model behavior. Suitable for long daily use, for those who want a softer desktop atmosphere.

Prerequisites & Compatibility

DependencyMin VersionNotes
DSH>= 0.1.0-rc.6Repository uses official NPM SDK packages (@deepseek-ai/cordis@^4.0.1, @deepseek-ai/dsh-*@^0.1.0-rc.6), aligned with @deepseek-ai/[email protected]
NodeNot declaredNo engines set in both package and repository root package.json
PlatformCross-platformOnly affects DSH web GUI browser side; macOS / Windows / Linux hosts can all run
Native ModulesNonePure browser-side implementation, no Node native module dependencies

Installation

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

Or install all skins at once (recommended):

dsh plugin --profile web add @captain1275/dsh-skins

After installation, activation is still needed:

dsh-skin use blue-fantasy

Configuration

No additional configuration needed for this plugin. apply() automatically registers disposer via ctx.effect(...), no manual lifecycle management needed.

To adjust background scrim concentration, the skin center can write to --dsw-skin-scrim (0–1, 0 disables scrim and shows original image). The skin itself does not require any configuration fields.

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 APIs, and does not modify KV Cache behavior.

Q: Can I enable multiple skins at once?

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 blue-fantasy to switch.

Q: Will it leave traces after closing?

A: No. The effect disposer retracts everything it writes: removes body attributes, restores original background image value, removes injected favicon, original page style is 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 need to execute dsh-skin use blue-fantasy to apply the skin.

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

A: No. When installing via git link, the prepare script automatically builds lib/; however, with pnpm ≥10, first-time installation of git dependencies may require adding the printed package key to pnpm-workspace.yaml's allowBuilds list and retrying.

Q: Does it support dark mode?

A: Yes. The skin follows host base theme switching: in dark mode, the mask switches to dark indigo纱幕, color palette simultaneously switches to night mode (defined in CSS with body[data-dsh-blue-fantasy][data-ds-dark-theme] selector).

Q: Will it conflict with aionui right panel (file tree, Git Graph)?

A: No. The skin CSS specifically overrides aionui's dialog, ref badge, Git Graph chip and other areas, remapping internal tokens to the same color palette, adding frosted glass effect to these areas for consistent overall visuals.

Q: What makes it different from other skins?

A: This skin's core selling point is whale娘 illustration background and indigo color scheme; the same repository also has aurora (aurora borealis, supports custom background image/video) and other skins, each with different artwork and color schemes.

Ease of Use

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

Known Issues & Limitations

  • Only one skin can be active at a time; switching completely unloads current skin
  • Deliberately does not use backdrop-filter to blur ancestor elements: this would break fixed positioning overlay containing blocks (like settings panel), causing them to be locked inside parent container
  • Whale background image is embedded base64 (~210KB), slightly increases bundle volume
  • 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/CAPTAIN1275/dsh-ui-web/packages/skins/blue-fantasy)

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