@dsh-external/dsh-theme-switch

Readme

# @dsh-external/dsh-theme-switch

DSH 主题切换：自动检测已安装的主题/皮肤插件，在 **设置 → 插件 → 皮肤** 里提供官方风格的一键开关。

[English](README.en.md)

[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)

## 安装

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

装完重启 `dsh web`（或由 dsh-market 插件市场安装并热激活），打开 **设置 → 插件 → 皮肤**。

## 使用

在 **设置 → 插件 → 皮肤** 点击按钮即可切换皮肤；切换后刷新一下浏览器页面（Ctrl+F5），新皮肤才会显示。

## 截图

「皮肤」标签页（设置 → 插件 → 皮肤），深色主题：

![dsh-theme-switch 皮肤标签页](https://cdn.jsdelivr.net/gh/kinmat-A/dsh-theme-switch@main/docs/screenshot-zh.png)

> 注：图片中出现的主题外观仅为展示用。

## 特性

- **自动检测**：扫描 profile 的 dependencies + bundles，按包名 / `skin.json` / bundle patch 行启发式识别皮肤（可用 `config.themes` 手动补充）。
- **互斥切换**：点击某套皮肤的按钮即启用它并自动停用其余所有皮肤；再点一次则停用它。
- **官方回退**：所有皮肤都停用时自动回到官方默认外观（面板里的「官方 DSH 皮肤」行有对应按钮）。
- **即时生效 + 跨重启保留**：开关状态写入 home 层补丁 `~/.dsh/cordis.patch.yml`，由 dsh 启动流程实时监听并每次启动重放；修改后无需重启。

## 开发

```sh
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