dsh-theme-presets

dsh-theme-presets

DSH Web GUI 的主题预设插件：在内置的 浅色 / 深色 / 跟随系统 之外，再叠一层配色家族。

安装

在 DSH 的插件安装界面里填：

https://github.com/MicroSharpAnt/dsh-theme-presets.git

也可以用 github:MicroSharpAnt/dsh-theme-presets 或 git+ssh://git@github.com/MicroSharpAnt/dsh-theme-presets.git。

不要用 git@github.com:... 这种 scp 语法：DSH 的预检会放行，但 pnpm 把它按 name@range 拆成「包名 git + 版本 github.com:...」，于是只装出一个悬空的 node_modules/git 软链，日志特征是 added 0，实际什么都没装上。

安装后无需构建：浏览器端产物 lib/client.js 随仓库提交，本包也没有任何运行时依赖。

仓库已从 DSH-simple-theme-plugin 更名为 dsh-theme-presets。旧地址仍会重定向， 但建议直接用上面的新地址。

从本地目录安装（开发时）

插件安装界面也接受绝对路径，指向工作副本即可，改完代码后重启 dsh web 生效。

用法

设置 → 通用 → 主题预设，点一个色块。

• 预设只决定配色家族，明暗仍由上一行的「外观」控制，两者正交。 选了 Nord 之后，「浅色」= Snow Storm，「深色」= Polar Night， 「跟随系统」则跟着系统在两者之间切。
• 每个色块显示当前明暗模式下该预设的底色 / 强调色 / 正文色，会随「外观」一起变。
• 默认 = DSH 自带配色，不做任何覆盖。
• 选择写进当前 Web profile 的 cordis.patch.yml 中 theme-presets.config.preset， 跨刷新、跨重启保留。

十一个预设

配色取自各主题自己发布的调色板，不是凭印象配的近似值。每个主题的 15 个语义锚点 （底色 / 表面 / 文字 / 边框 / 强调 / 四种状态）定义在 presets.mjs，其余 92 个 --dsw-alias-* token 由统一的 deriveTokens() 用 color-mix() 从这些锚点派生。

改配色

presets.mjs 是唯一数据源。

1. 改 PRESETS 里某个预设的 light / dark 锚点（各 15 个颜色），或整段新增一个预设；
2. npm run build 重新生成 lib/client.js；
3. 浏览器刷新。

只调配色不需要重启；改了 host.js 或 src/plugin.mjs 则要重启 dsh web。

测试

npm test            # 进程外的五个套件，不需要运行中的 dsh
node e2e-test.mjs   # 可选：真实浏览器端到端（22 项），需要运行中的 dsh web + 本机 Chrome

e2e-test.mjs 结束时会恢复进入时的预设，不会改掉你的选择； dsh 检出不在默认位置时用 DSH_CHECKOUT=/path/to/dsh 覆盖。

实现细节

首屏无闪烁的三层接管机制、宿主端加载的三条约束、为什么自带一份 Config schema， 以及各测试套件的覆盖范围：见 docs/internals.md。