kinmat-A
dsh-theme-switch
一款轻量级的 DSH 主题外观切换插件:自动检测已装皮肤,一键互斥切换,全部停用时回退官方外观,即时生效、重启保留。
- Stars
- 1
- Language
- TypeScript
- Created
- Aug 15, 2026
- Updated
- Aug 15, 2026
Introduction
@dsh-external/dsh-theme-switch
DSH 主题切换:自动检测已安装的主题/皮肤插件,在 设置 → 插件 → 皮肤 里提供官方风格的一键开关。
安装
dsh plugin --profile web add github:kinmat-A/dsh-theme-switch
装完重启 dsh web(或由 dsh-market 插件市场安装并热激活),打开 设置 → 插件 → 皮肤。
使用
在 设置 → 插件 → 皮肤 点击按钮即可切换皮肤;切换后刷新一下浏览器页面(Ctrl+F5),新皮肤才会显示。
截图
「皮肤」标签页(设置 → 插件 → 皮肤),深色主题:

注:图片中出现的主题外观仅为展示用。
特性
- 自动检测:扫描 profile 的 dependencies + bundles,按包名 /
skin.json/ bundle patch 行启发式识别皮肤(可用config.themes手动补充)。 - 互斥切换:点击某套皮肤的按钮即启用它并自动停用其余所有皮肤;再点一次则停用它。
- 官方回退:所有皮肤都停用时自动回到官方默认外观(面板里的「官方 DSH 皮肤」行有对应按钮)。
- 即时生效 + 跨重启保留:开关状态写入 home 层补丁
~/.dsh/cordis.patch.yml,由 dsh 启动流程实时监听并每次启动重放;修改后无需重启。
开发
pnpm install # 首次(需网络)
pnpm run build:client # 编译 client(tsdown)
结构
lib/index.js— host 入口(纯 ESM,零依赖):皮肤检测、home 补丁读写、HTTP API。src/client/index.tsx→lib/client.js— 官方风格设置标签页(--dsw-alias-*token + primitives)。- API:
GET /@dsh-external/dsh-theme-switch/api/themes、POST …/api/toggle {id}(id为__official__时停用全部皮肤)。
License: BSD-3-Clause