hatanokokosa/dsh-colorschemes

color-schemes

一个用于 DSH Web GUI 的配色方案插件。它注册了一组主题，
可在“设置 > 通用 > 配色方案”中选择，并保持悬停弹窗
（工具提示、悬停卡片）与当前活动主题一致。

功能：

- 七种内置方案：Catppuccin（Latte、Frappe、Macchiato、Mocha）、
Everforest（Dark、Light）、Nord。
- 所选方案在刷新和重启后保持不变（localStorage，
键为 dsh.color-schemes.state）。
- 方案是 schemes/ 中带类型的 TypeScript 数据文件；一个脚本会重新构建
客户端 bundle。添加方案时无需改动任何 UI 代码。

安装

该包是一个 bundle：package.json 声明了 dsh.bundle.patch
（./cordis.patch.yml），因此在任何 profile 中安装它都会自动激活
插件行。

该包 尚未发布到 npm registry。目前有两种来源：

Git：

dsh plugin --profile web add github:hatanokokosa/dsh-colorschemes

Tarball（离线或自托管；在包目录中使用 pnpm pack 生成）：

dsh plugin --profile web add ./color-schemes-1.0.0.tgz

然后重启 dsh web；配色方案行会出现在
“设置 > 通用”中。构建好的 lib/ 已提交到仓库中，因此
两种形式都不需要构建步骤或构建权限（git 安装不会运行
prepare 脚本，因此不需要 pnpm 的 allowBuilds）。

使用 dsh plugin --profile web remove color-schemes 卸载。

本地开发

在 profile 中（如本仓库中），该包改为以文件依赖的形式链接：

1. 将此包放在 web/ext/color-schemes。
2. 添加到 web/package.json：
"color-schemes": "file:./ext/color-schemes"

3. 添加到 web/cordis.patch.yml：
- insert:
- id: color-schemes
name: 'color-schemes'

4. 将该包链接到 web/node_modules（或运行 profile 的
包管理器），然后重启 dsh web。

添加方案

参见 schemes/README.md。简而言之：在 schemes/ 中
创建一个新的方案文件，在 schemes/index.ts 中注册它，运行
npm run build。

lib/client.js 是生成并提交的；运行它不需要任何构建
工具。构建它需要 Node >= 23.6（原生 TypeScript 类型剥离）
以及开发依赖（在此包内运行 npm install）：npm run build
使用 tsc 对源码进行类型检查，并使用 esbuild 将 src/client.ts + schemes/*.ts
打包进 loader bundle。

卸载

对于 bundle 安装：dsh plugin --profile web remove color-schemes。

对于文件依赖安装：从 profile 的
cordis.patch.yml 中移除补丁行，从 web/package.json 中移除 color-schemes 条目，并
移除 web/node_modules/color-schemes 链接。插件移除后，localStorage 条目
即失效。

许可证

BSD-2-Clause