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 桌面环境集成,使界面颜色随系统设置自动同步。