Skip to main content

deepseek-harness-desktop/packages/skins/miku

156Stars5Forks6Issues0Watchers

Provides a Hatsune Miku theme for DSH Web GUI: blue-purple-magenta gradient, frosted glass panels, changeable background, light/dark dual themes, hot-swappable presentation layer.

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-miku github:ningbainb/deepseek-harness-desktop#path:packages/skins/miku

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/miku 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.

This article describes the Miku Future skin subpackage in the ningbainb/deepseek-harness-desktop repository: packages/skins/miku.

One-Line Description

A Hatsune Miku-themed skin for the DSH Web GUI featuring blue-purple-magenta gradients, semi-transparent frosted glass, switchable backgrounds, and light/dark dual themes. The skin only modifies appearance without touching logic, enabling seamless hot-swapping.

Core Features

  • Transforms the DSH Web GUI with a blue-purple-magenta gradient theme, primary colors #2e9bff → #9b5dff → #ff4da6 applied throughout title bars and buttons
  • Sets an original digital idol illustration (1920x1080 SVG) as the webpage background, serving as the desktop "wallpaper"
  • Applies semi-transparent frosted glass effects to the sidebar, panels, input fields, and settings dialogs, allowing the background to show through from behind
  • Injects a custom title bar at the top of the page (musical note icon + 01 number badge + decorative window buttons), and injects a status bar at the bottom (sound wave + "MIKU 01 / Voicebank Ready / VOCALOID Official" status entries)
  • Provides both light (blue-pink clear sky) and dark (neon blue-purple night) themes, auto-switching following DSH's own light/dark mode
  • Includes a musical note icon favicon, replacing the browser tab icon
  • Embeds custom background illustration as data URI, the skin package itself has zero static resources

Technical Implementation

  • Language: TypeScript (JSX/TSX), targeting ES2024, pure transpilation (no type checking)
  • Key dependencies: @deepseek-ai/cordis (type imports only), lightningcss (build-time CSS Modules compression into bundle)
  • Architecture pattern: cordis bundle package form, cordis.patch.yml inserts ui-skin-miku into web plugin list; src/index.ts serves as the host half (empty shell no-op), src/client/index.ts as the browser half, browser-side apply(ctx) registers disposer via ctx.effect(() => () => ...) for strict cleanup
  • Entry files: src/client/index.ts (actual skin application entry); src/index.ts only exposes empty apply() placeholder

Use Cases

Individual users who enjoy Hatsune Miku/VOCALOID and want to decorate their DSH Web interface with a blue-purple theme atmosphere; as well as ordinary users who want to swap out a background image for their workspace to add a sense of ceremony, without modifying DSH source code or affecting model calls. Those seeking a lighter or darker base tone without the anime style can choose more subdued skins (like the official default).

Prerequisites & Compatibility

DependencyMinimum VersionDescription
Node.js^22.19.0 or >=24.0.0From monorepo root package.json#engines, miku package doesn't declare separately
pnpm>=9Build-time only, runtime not required
DSHNot declaredOnly requires host to run dsh web service (default http://127.0.0.1:3080), no specific DSH version specified
PlatformCross-platformBrowser-half skin, works on any device capable of running DSH Web GUI
Native modulesNonePure DOM/CSS, no node-gyp native extension dependencies

Installation

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

Activate via dsh-skin use miku. Activation is mutually exclusive (only one skin can be enabled at a time). Refresh the page after switching.

Configuration

This plugin requires no additional configuration.

All appearance parameters (background image, color scheme, status bar text) are hardcoded in src/client/art.ts and src/client/miku.module.css, without exposing Schema / Settings options. To change the background image, edit the source code and rebuild; don't look in the DSH Settings panel—the skin doesn't register any configuration items.

FAQ

Q: Will it auto-enable after installation? Will it conflict with the official default skin?

A: It won't auto-enable and won't conflict. Skins are mutually exclusive: you must execute dsh-skin use miku to activate, or dsh-skin use official to revert to default. Switching is managed by scripts/dsh-skin (writes cordis patch to profile and creates profile symlink).

Q: After disabling the skin, will the webpage have leftover styles or elements? How to roll back?

A: No. apply() registers disposers via cordis' ctx.effect: the data-dsh-miku attribute on body gets removed, injected title bar, status bar, and favicon nodes are all remove()ed, and document.title reverts if it hasn't been changed by other sources—the skin doesn't write anything it won't clean up.

Q: I want to swap in my own Miku wallpaper. Where to modify?

A: Place your image (e.g., bg.png) in this repository, then run node scripts/embed-bg.mjs (the script converts the image to WebP and writes to src/client/art.ts's MIKU_ART constant), then run pnpm build to rebuild and refresh the page. If the script isn't available, you can manually base64 encode the image and directly replace the MIKU_ART value.

Q: Will this skin trigger additional model requests, log behavior, or affect other plugins?

A: No. The skin is purely presentational: the cordis side doesn't inject services, fire events, or listen to model requests—it only manipulates DOM (document.body, custom tags, CSS variables, <link rel="icon">, <title>), completely non-interfering with other plugins.

Q: Will the background image become too dark to see in dark mode?

A: It won't darken. The skin uses MutationObserver to monitor data-ds-dark-theme attribute changes: when switching to dark mode, only a very thin blue veil (SCREEN_DARK) is overlaid, keeping the original illustration vibrant and text still clearly readable.

Q: After uninstalling the skin, will the favicon and page title recover?

A: Yes. The skin first caches the original favicon path and original document.title, then restores them during dispose. It only rolls back document.title when it still equals what the skin set, avoiding overwriting session titles the host later sets.

Difficulty Level

Beginner — just copy one dsh plugin add + one dsh-skin use miku to enable; swapping the background image only requires dropping in an image and running one script, no need to understand cordis, react, or DSH internals.

Known Issues & Limitations

No known issues.

No TODO / FIXME / HACK / XXX comments found in this package's source code; the only manual intervention "limitation" is that UI text within the package (such as status bar MIKU 01 / Voicebank Ready / VOCALOID Official, page title Hatsune Miku · DeepSeek Online) is hardcoded as constants in src/client/index.ts. To change to another language requires editing the source code and rebuilding, not through the configuration panel.

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/miku)

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