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 桌面環境集成,使界面顏色隨系統設置自動同步。