LuckyTool 三大硬前提——缺一个，模块装上也是空壳

前提一：设备已 Root

LuckyTool 是 Xposed 模块，Xposed 的工作方式是注入到系统进程里 Hook 方法——而这件事从 Android 5.x 开始就必须有 Root 权限才能做。

ColorOS 设备常用两种 Root 方案，LuckyTool 都能适配：

Magisk：最主流的 Root 方案。注意需要在 Magisk 里开启 Zygisk（设置页 → Zygisk → 开启 Zygisk），这是 LSPosed 在 Android 12+ 上工作的必要条件
KernelSU：另一个流行的 Root 方案，也能运行 LSPosed。用 KernelSU 的用户需要在超级用户列表里预先勾选 LuckyTool

不管用哪种方案，LuckyTool 打开时如果弹出 Root 请求，一定要允许——模块需要 Root 权限读取和写入配置，没有 Root 授权的话模块界面打开了也只是个空壳。

LSPosed 是 Xposed 框架在 Android 8+ 上的现代实现。没有它，Xposed 模块根本无处加载。

传统的 Xposed（rovo89 版）在 Android 8 之后停止更新了，需要刷 Magisk 版的 Xposed。LSPosed 是完全重写的实现，基于 Zygisk，可以在不重启的情况下启用/禁用模块（实际生效仍需重启作用域或系统）。

打开 LSPosed 管理器，如果首页能看到已挂载的作用域应用（比如 SystemUI），说明框架正常。如果显示「框架未挂载」，先检查 Magisk 的 Zygisk 是否开启、LSPosed 模块是否在 Magisk 里勾选了。

LuckyTool 的 Hook 目标是 ColorOS 特有的系统组件——OplusFramework、SystemUI、Launcher、GameAssistant 等。这些组件在不同版本的 ColorOS 上实现不同，模块只适配了 12 及以上版本。

realme UI 和 OxygenOS 都是 ColorOS 的同源分支。社区有玩家自行尝试在 realme UI / OxygenOS 上使用 LuckyTool，部分功能正常，但不在官方适配口径内——遇到功能失灵属正常范围，需要自己调整作用域或等待版本更新。

ColorOS 11 及以下系统，LuckyTool 无法工作——它依赖的很多 OplusFramework API 在 11 上不存在。