kinmat-A/dsh-theme-switch

kinmat-A/dsh-theme-switch

DSH 主题切换:自动检测已安装的皮肤/主题,在设置页一键互斥切换,全部停用时回退官方默认外观,切换即时生效并跨重启保留。

插件市场与管理

@dsh-external/dsh-theme-switch

DSH theme switch: auto-detects installed skin/theme plugins and offers one-click, official-style switching under Settings → Plugins → Skins.

中文说明

Install

dsh plugin --profile web add github:kinmat-A/dsh-theme-switch

Restart dsh web afterwards (or install it from the dsh-market plugin, which hot-activates it), then open Settings → Plugins → Skins.

Usage

Switch skins from Settings → Plugins → Skins; after switching, refresh the browser page (Ctrl+F5) for the new skin to appear.

Screenshots

The skins tab (Settings → Plugins → Skins), dark theme:

Note: the themes shown in the screenshot are for display only.

Features

  • Auto-detection: scans the profile's dependencies and bundles, recognizing skins by package name / skin.json / bundle-patch rows. Missed skins can be added via config.themes.
  • Mutually exclusive switching: clicking a skin's button enables it and disables all the others; clicking it again disables it.
  • Official fallback: when every skin is off, the official DSH look applies automatically (the panel's "Official DSH skin" row has a matching button).
  • Instant and restart-proof: switches are written to the home-layer patch ~/.dsh/cordis.patch.yml, which the dsh boot flow watches live and replays on every startup — no restart needed.

Development

pnpm install          # first time (needs network)
pnpm run build:client # build the client (tsdown)

Structure

  • lib/index.js — host entry (plain ESM, zero dependencies): skin detection, home-patch read/write, HTTP API.
  • src/client/index.tsx → lib/client.js — official-style settings tab (--dsw-alias-* tokens + primitives).
  • API: GET /@dsh-external/dsh-theme-switch/api/themes, POST …/api/toggle {id} (id: "__official__" disables every skin).

License: BSD-3-Clause