iwinoid/dsh-kde-tint

dsh-kde-tint
standard-readme compliant
License: MIT
topic: dsh-plugin
powered by dsh
Platform: Linux

使用 KDE 系统强调色为 DSH Web UI 着色。

目录

- 背景
- 安装
- 用法
- 哪些内容会被着色
- API
- 维护者
- 贡献
- 许可证

背景

DSH Web UI 自带中性主题。在 KDE 桌面上，用户已经在系统设置中选好了强调色。本插件读取该颜色，并用它为 DSH 界面着色。这样，harness 就能与桌面保持一致。

本插件分为两部分。宿主部分（lib/index.js）读取 ~/.config/kdeglobals 以及当前活动的配色方案文件。它通过 profile Web 服务器将结果以 JSON 形式提供。浏览器部分（lib/client.js）获取该 JSON，并通过 theme 服务应用着色。两部分通过普通 HTTP 通信。静态客户端 bundle 没有宿主桥接，因此 HTTP 是正确的通道。

在没有 KDE 配置的系统上，插件会回退到默认值（强调色 #386798，配色方案 KlassyDark）。它绝不会因为缺少配置文件而阻塞启动。

安装

dsh plugin --profile web add github:iwinoid/dsh-kde-tint

本地开发则使用 link 安装：

dsh plugin --profile web add link:/path/to/dsh-kde-tint

该包没有构建步骤，因此 git 安装不需要 allowBuilds 例外。该包通过 dsh.bundle.patch 提供 cordis.patch.yml，因此加载器无需手动打补丁即可挂载它。安装后重启 dsh web。

检查安装：

dsh --profile web --dump-config | grep -A3 kde-tint

然后打开 DSH Web UI。背景和边框会带有 KDE 强调色的色调。

用法

本插件无需点击操作。它以 immediately: true 加载，并在每次页面加载时为 UI 着色。卸载（或禁用）会恢复默认主题。token 覆盖的作用域限定于 effect，因此会随插件一起撤销。

哪些内容会被着色

客户端将 KDE 强调色混入基础表面。浅色模式保留白色基底，并混入 6–16% 的强调色。深色模式保留深色基底，并混入 6–8% 的强调色。品牌主色在两种模式下都使用原始强调色。

| Token | Light | Dark |
| --- | --- | --- |
| --dsw-alias-bg-base | 白色 ＋ 6% 强调色 | #0a0f14 ＋ 8% 强调色 |
| --dsw-alias-bg-layer-1 / 侧边栏填充 | 白色 ＋ 8% 强调色 | #11161c ＋ 7% 强调色 |
| --dsw-alias-bg-layer-2 | 白色 ＋ 11% 强调色 | #1a2028 ＋ 6% 强调色 |
| --dsw-alias-bg-layer-3 | 白色 ＋ 14% 强调色 | #232d37 |
| --dsw-alias-border-l1 / -l2 | 白色 ＋ 12% / 16% 强调色 | #2a323d / #303a47 |
| --dsw-alias-brand-primary | 原始强调色 | 原始强调色 |

文本令牌保持中性（#1a1d22 / #e6e8eb 主色）。只有表面和品牌色跟随强调色。

API

配置文件 Web 服务器上的调试端点：

curl http://localhost:/api/kde-tint/kde-colors

GET /api/kde-tint/kde-colors 返回 200 及 JSON：

{ "accent": "#386798", "background": "#ffffff", "scheme": "KlassyDark" }

accent 来自 kdeglobals 中的 General.AccentColor（RGB 三元组或 #hex）。scheme 来自 General.ColorScheme。background 来自方案文件中的 Colors:Window.BackgroundNormal（或 Colors:View）。当读取失败时，响应仍返回 200，附带默认值以及一个 error 字符串。未知路由返回 404。

维护者

- iwinoid — iwinoid@outlook.com

贡献

欢迎在 GitHub Issues 页面提交错误报告和问题。接受拉取请求。客户端包为手写，无构建步骤。请保持这种方式。

许可证

MIT © iwinoid