Skip to main content

dsh-kimino-theme

20Stars0Forks3Issues0Watchers

Apply "Your Name." theme to DSH Web: comet blue frosted glass effect, dynamic wallpaper, logo replacement, dark navy input cards. One-command install with complete uninstall restoration.

Categories◈ Themes & Skins
Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
niiangniiang
·niiang/dsh-kimino-theme
Language
JavaScript
License
MIT
Branch
main
deepseek-harnessdshdsh-pluginkimi-no-na-wayour-name

Install

cmdweb profile
$ dsh plugin --profile web add dsh-kimino-theme

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 niiang/dsh-kimino-theme for me: review the repository at https://github.com/niiang/dsh-kimino-theme 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 Pitch

Transform the DSH Web GUI into a cinematic interface inspired by Makoto Shinkai's "Your Name.": wallpaper backdrop, frosted glass morphing, comet blue theme color, movie Logo replacing default branding; one-command install, uninstall completely restores.

Core Capabilities

  • Expose wallpaper and Logo static resources: mount three routes on the DSH web server — /kimino-bg/current.jpg, /kimino-bg/logo-blue.svg, /kimino-bg/logo-letter.svg, providing assets to the browser half
  • Overall visual transformation: override approximately 60 DSH design tokens (background layers, borders, buttons, interaction states, scrollbars, status colors, etc.), unified into dark glass + comet blue (#93C5FD) color scheme
  • Replace default branding: display the movie Logo centered as the homepage title, use movie Logo in expanded sidebar state, switch to letter mark in collapsed state
  • Redraw input card: navy blue glass capsule shape + themed placeholder text (Chinese「黄昏之时，我在这里等你。」、English「黄昏の時、私はここにいるよ。」)
  • Localized fixes: 40px gradient mask fade at bottom of message list, fix "scroll to bottom" button not appearing in some sessions, normalize scrollbar behavior between input card and chat area
  • Global unified scrollbar: thin blue-purple glass scrollbar in Chromium kernel, shared visual between light/dark modes

Technical Implementation

  • Language: JavaScript (ESM, "type": "module")
  • Key dependencies: DSH host webServer (register static resource routes), DSH client theme (overrideTokens inject design tokens), native node:fs/promises + node:path (read assets); browser side registers via window.__ModuleLoader__
  • Architecture pattern: Standard DSH dual-half bundle: host half (bundle/host.js) injects webServer to register 3 asset routes; browser half (bundle/client.js) exports as ./client loaded by client module system; both halves register side effects via ctx.effect, disable/uninstall completely restores
  • Entry files: bundle/host.js (main field, host half) + bundle/client.js (exports['./client'] field, browser half); package.json#dsh.bundle.patch points to cordis.patch.yml, plugin line kimino-theme

Use Cases

Ordinary users who like the visual style of "Your Name.", want the DSH chat interface to feel more personal, and don't want to modify DSH source code but just want a skin change. One command installs to get wallpaper + frosted glass + theme color + Logo replacement effects; if you don't like it, one command uninstalls to completely restore.

Prerequisites & Compatibility

DependencyMinimum VersionNotes
DSHNot declaredMust be able to run dsh web to start Web GUI; this plugin doesn't declare version constraints in engines
Node.jsNot declaredHost half only uses three built-in modules: node:fs/promises, node:path, node:url, no version requirements declared
PlatformCross-platformNo platform restrictions declared; recommended for Microsoft Edge or Google Chrome, some visuals (scrollbars, gradient masks) may be reduced in Firefox
Native modulesNoneOnly uses Node.js built-in modules, no C++ native extensions

Installation

dsh plugin --profile web add github:niiang/dsh-kimino-theme

Configuration

No additional configuration required. After installation, restart dsh web to take effect; upon uninstall, all visual changes (tokens, stylesheets, scroll listeners, routes) will automatically unregister through the fiber effect chain, returning the page to DSH default theme.

FAQ

Q: Do I need to restart dsh web after installation?

A: Yes. After installing the plugin, you must restart dsh web to load the host half (wallpaper/Logo routes) and browser half (token overrides + stylesheet). The browser side also needs Ctrl+F5 to force refresh and skip cache.

Q: What if the page shows no changes after restart?

A: First confirm the install command includes --profile web (installed to the correct profile); then Ctrl+F5 for a forced refresh; if still not working, check dsh web startup logs for [kimino-theme] host half active (3/3 asset routes registered). If missing or fewer than 3 routes, the installation didn't take effect.

Q: Can it be used alongside other skin/theme plugins?

A: Not recommended. Token overrides are additive, but visually they will override each other (glass background, scrollbars, button colors will all clash). Using one theme plugin at a time yields the best visual results.

Q: What if styles break after a major DSH version upgrade?

A: Some selectors depend on DSH frontend build-time hash class names (such as .Md3f7G_*, .wSkVaW_*, .hHd-Xa_*, .FjxK0a_*, .pXSMma_*, .uV2eYG_*). These hashes may change after major version upgrades. Affected selectors need to be updated to match new class names—report in the issue section with a screenshot.

Q: Can it be used in Firefox?

A: Frosted glass, scrollbars, and gradient masks are tuned for Chromium kernel (Edge / Chrome). Some display effects are incompatible in Firefox (scrollbars, gradient masks may be reduced), so switching to Edge or Chrome is recommended.

Q: Can I replace the wallpaper and Logo with my own?

A: Yes. Clone the repo locally and install via link:, then replace the wallpaper in assets/current.jpg and replace the two SVGs under assets/logo/. Routes have 1-hour caching set (Cache-Control: public, max-age=3600), so force refresh the browser after replacing assets.

Q: Does it add significant time to DSH startup?

A: The plugin host half registers 3 static asset routes during DSH startup (wallpaper/Logo), while the browser half registers approximately 60 token overrides + one stylesheet + several scroll event listeners. Upon uninstall/disable, all side effects (routes, styles, attributes, listeners) are cleaned up through fiber effect unregistration, fully restoring the page.

Q: How do I completely uninstall?

A: Run dsh plugin --profile web remove dsh-kimino-theme and restart dsh web. All theme side effects (routes, token overrides, stylesheet, scroll event listeners) will be cleaned up, returning the page to DSH defaults.

Difficulty Level

Beginner — single command install with no configuration required; restart to see results; style exceptions can be Troubleshot via the README FAQ.

Known Issues & Limitations

  • Some selectors depend on DSH frontend build-time hash class names (Md3f7G_* / wSkVaW_* / hHd-Xa_* / FjxK0a_* / pXSMma_* / uV2eYG_*), which may change after major DSH upgrades and need to be updated accordingly
  • Frosted glass, scrollbars, and gradient masks are tuned for Chromium kernel (Edge / Chrome); Firefox has partial incompatibility (scrollbars, gradient masks may be reduced)
  • Theme forces dark glass visual, no separate light mode adaptation (light/dark modes share the same set of tokens and styles)
  • Wallpaper and Logo routes cache for 1 hour (Cache-Control: public, max-age=3600); force refresh the browser after replacing assets
  • Theme token overrides and component styles are concentrated in bundle/client.js, which contains a large number of CSS selectors (sourced from DSH built-in components' internal class names), with deep coupling to DSH itself; styles need adaptation after DSH upgrades

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/niiang/dsh-kimino-theme)

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