KWGT 小组件不刷新、不显示怎么排查

时间停在旧值、重启后小组件消失、打开是空容器——KWGT 的绝大多数问题不是预设坏了，而是系统把后台拦了、桌面没配合好，或者文件本身坏了。本篇按从简到繁给排查路径，末尾附现象对照表。相关文档：小组件制作工具入门.md · 预设怎么导入与备份.md

一、先做两件最快的事

1. 重启手机；
2. 打开一次 KWGT 应用本体——打开应用会触发一次刷新，很多"冻住"的小组件会当场活过来。

如果打开应用后立刻恢复、过一会儿又冻住，基本可以确定是后台被杀，直接看第二节。

二、时间不更新：电池与后台

小组件的刷新靠 KWGT 的后台服务活着，系统省电机制把它杀了，卡片就停在最后一次刷新的值。逐项核对：

国产系统（MIUI 之类）还要多查一层：省电策略、智能省电、后台清理白名单，把 KWGT 加进去，改完重启再观察。折中手段是在 KWGT 设置里开常驻通知，带常驻通知的后台进程更不容易被杀，代价是通知栏多一条常驻项。

另外把预期调对：安卓对小组件刷新频率有系统级上限（通常约每分钟一次，这是省电机制），时钟精确到分钟属正常；KWGT 设置的高级选项里可以把更新模式（Update Mode）调成 Fast 跟到秒级，更耗电。刷新慢是上限问题，完全不刷新才是后台问题。

三、重启后小组件消失或变透明

常见根源是权限和桌面，不是 KWGT 本身：

1. 查权限：部分系统需要给 KWGT"修改系统设置"类权限，在应用信息页的权限列表里补上；
2. 查桌面：换一个桌面（如 Nova）再装同样的小组件验证——个别桌面更新后就不再刷新小组件，这种情况换桌面比折腾 KWGT 有效；
3. 第二节的电池与后台清单同样过一遍。

四、加载出来是空的或提示损坏

编辑器里预设显示 Corrupted、打开是空容器，问题在文件本身：0 字节文件重新拿一份干净的（别对已在 Kustom/widgets 里的文件重复点导入）；后缀带 .zip 的改名或解压；下载没完成的重下。具体见预设怎么导入与备份.md第二、三节。

五、升级系统后大面积失效

系统大版本升级（如 Android 15）后有用户反馈小组件长时间不更新，按这个顺序处理：

1. 把 KWGT 更新到最新版；
2. 强停并清除缓存，重走第二节清单；
3. 仍不行就到开发者论坛反馈，同类反馈集中出现时通常会跟进修复。

六、现象对照表

还没安装的话，安装包与功能介绍见 KWGT 介绍站；从零开始做的路径见小组件制作工具入门.md。