Fedora KDE 的中国化补完：日历调休 + 一个自写的天气 ion

换到 Fedora + KDE 之后，有两件小事一直硌应人：

1. 数字时钟的日历里没有中国法定节假日，更没有调休；
2. 天气组件搜不到「东莞长安镇」——KDE 自带的天气源里根本没有中国城市，更别提小镇。

这篇记录把这两件事一起补上：节假日用 kholidays 自定义文件，天气则手写了一个 KDE Plasma 6 的 ion 插件接到 Open-Meteo。全部代码在 https://github.com/iyhome/fedora-kde-cn-setup。

一、日历节假日：给 kholidays 喂一个 plan2 文件

KDE 的日历节假日来自 kholidays 库。它除了内置资源，还会读用户目录：

1

$XDG_DATA_HOME/kf5/libkholidays/plan2/holiday_<区域代码>

所以只要把自己的节假日文件丢进去、再选中对应区域即可。数据源用 shuyz 的中国节假日 ICS，但 kholidays 用的不是 ICS，而是一种叫 plan2 的文本格式：

1
2

"春节" public on february 15 2026
"补班" public on february 14 2026

写个脚本把 ICS 逐条转过去就行（holiday/ics_to_kholidays.py）。名字做了缩短——原始 ICS 里是「春节 假期 第1天/共9天」，塞进日历格子根本显示不下，索性假期只留节日名，调休上班日统一叫「补班」。装完点开时钟即可看到：

1

bash holiday/install.sh

二、天气：为什么不是彩云，也不是中央气象台

一开始想用彩云，理由很朴素：数据准、覆盖到镇。结果发现 KDE 天气组件只认一种叫 ion 的插件，系统自带 wetter.com / noaa / dwd / envcan / bbcukmet，没有彩云，整个 KDE 生态也没有现成的彩云 ion。自己写 ion 倒也行，但彩云要 API token——我没有。

退而求其次看 plasma-ions-china（中央气象台 / 和风天气）。中央气象台不需要 key，我满怀希望地拿它的搜索接口一测：

• 北京 → 搜得到
• 上海 / 深圳 → 搜得到
• 东莞 → 搜不到（返回的还是广东其它城市）
• 长安镇 / 虎门 / 厚街 → 全搜不到

得，中央气象台的站点库里压根没有东莞。

最后落到 Open-Meteo：免费、无需 key、按经纬度取数、国内可直连。它的地名库里还真有「长安广场 广东 22.815,113.797」——就在长安镇。于是决定自己写 ion。

三、手搓一个 KDE Plasma 6 天气 ion

现代 ion 的接口很小，继承 Ion 实现两个方法：

1
2

void findPlaces(promise, searchString) override;   // 搜索地点
void fetchForecast(promise, placeInfo) override;   // 取天气

• findPlaces：Open-Meteo 没有地名搜索，干脆固定返回一个位置——坐标从 ~/.config/plasma-weather-openmeteo/location 读，默认长安镇 113.80,22.81；
• fetchForecast：请求 Open-Meteo 的 /v1/forecast，把 WMO 天气码映射成 KDE 图标 + 中文描述，填进 KDE 的 Forecast 结构。

编译安装（需要 sudo 装 -devel 依赖）：

1
2

bash weather-ion/build.sh
systemctl --user restart plasma-plasmashell

重启后天气组件里就会多出 Open-Meteo，选中即可。弹窗里现在是这样：东莞·长安镇 25°C 毛毛雨，五天预报，全中文。

四、踩过的坑（给后来者）

1. 插件 id 来自文件名。KPlugin 规范明确写着「嵌入式元数据不要自己写 Id，id 从文件 basename 派生」。所以 openmeteo.so 对应的 provider 值就是 openmeteo。
2. QJsonArray 没有 .value(int)。Qt6 里得用 .at(i)，我在这上面编译报错了一轮。
3. 别用系统的 PlasmaWeatherConfig.cmake。它 find_dependency(KF6Holidays)，而 Fedora 默认只有 kf6-kholidays 运行库、没有 kf6-kholidays-devel，直接配置失败。仓库里自带了 FindPlasmaWeather.cmake 绕开它。
4. 改 plasma-org.kde.plasma.desktop-appletsrc 前必须停 plasmashell，否则退出时会被覆盖。

五、顺带踩坑并放弃的东西

折腾过程中还试了 Panel Colorizer：它能让面板做毛玻璃、圆角、托盘图标重着色，看着很诱人。但配置项多到劝退，而且它作用于整条面板，一不小心就把左边（开始菜单、任务栏）也一起搞乱，最后索性卸载了。想要「任务栏像 Windows」，Plasma 原生面板设置 + 一套合适的主题其实更省心。

顺带一提，KDE 系统托盘的图标排序在「配置系统托盘 → 条目」里拖动即可；但第三方应用（微信、clash 之类）的托盘图标顺序由应用自己决定，extraItems/shownItems/hiddenItems 只对 Plasma 内置组件生效。

仓库：https://github.com/iyhome/fedora-kde-cn-setup 含：Open-Meteo ion 源码、节假日 ICS→kholidays 转换脚本、以及一份「新装 Fedora 照着做就能还原」的总纲。