dsh-kde-tint: 将 KDE 系统强调色应用到 DSH Web UI

DSH Web UI 默认为中性主题。在 KDE 桌面上,用户已经设置了强调色。此插件读取该颜色以匹配桌面。

核心功能

该插件包含两个部分:主机部分读取配置并返回数据,客户端部分通过 HTTP 获取数据并应用主题。

  • 读取 KDE 配置文件 (~/.config/kdeglobals)
  • 读取 KDE 颜色方案文件
  • 将 KDE 系统强调色应用到 DSH Web UI
  • 提供 API 端点 /api/kde-tint/kde-colors
  • 支持亮/暗模式自动应用不同色调

安装与启用

官方安装命令如下:

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

本地开发使用 link 安装方式:

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

插件配置中设置了 immediately: true,加载时立即生效,无需手动配置。安装后重启 dsh web 即可查看效果。

典型用法

使用 curl 访问 API 端点获取当前 KDE 颜色配置:

curl http://localhost:<dsh-port>/api/kde-tint/kde-colors

响应为 JSON 格式,包含强调色、背景色和方案名称。

适用场景与注意

  • 平台限制:仅限 Linux 平台。
  • 回退机制:在非 KDE 系统上会回退到默认颜色 (#386798) 和默认方案 (KlassyDark)。插件设计上不会因为配置文件缺失而阻塞启动。
  • 通信方式:通信使用纯 HTTP。
  • 构建依赖:客户端代码为手写,无构建步骤。

该插件将 DSH Web UI 与 KDE 桌面环境集成,使界面颜色随系统设置自动同步。

GitHub 仓库

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜