模块不生效排查:按清单逐条核对
第一类:LSPosed / 模块基础问题
按顺序检查:
| 检查项 | 怎么查 | 正常标准 |
|---|
| LSPosed 是否已激活 | 打开 LSPosed App 看首页状态 | 显示"已激活" |
| HyperCeiler 模块是否启用 | LSPosed → 模块 → HyperCeiler | 右上角开关打开 |
| LSPosed 版本是否够新 | LSPosed 设置 → 关于 | 最新稳定版(兼容 Android 15/16) |
| HyperCeiler 分支装对了吗 | HyperCeiler App → 设置 → 关于 | OS2 分支装 HyperOS 2 设备、OS3 分支装 HyperOS 3 设备 |
第二类:作用域问题(最常见的原因)
| 检查项 | 说明 |
|---|
| 有没有漏勾作用域 | 想用相机功能但没勾相机包名 → 肯定不生效。对照你想用的功能组 → 回到 LSPosed 逐个核对作用域列表 |
| 有没有勾错应用 | 作用域里应用的包名必须精确——比如"系统界面"是 com.android.systemui,不要勾成别的。如果拿不准,直接用 LSPosed 给 HyperCeiler 推荐的作用域清单,不要自己瞎选 |
| 系统框架(system)勾了吗 | 必勾!没有这个,几乎所有系统级 Hook 都不生效 |
第三类:重启问题
| 检查项 | 说明 |
|---|
| 改完功能开关后重启了吗 | 必须重启对应作用域进程,光改开关不重启 = 进程还在跑旧代码 |
| 重启的是对的进程吗 | 比如改了系统界面相关功能,你重启的是桌面 → 没用。看 HyperCeiler App 弹出的重启提示是哪个 |
| 建议直接重启设备 | 第一次装模块、system 作用域改了、同时改了多个作用域 → 直接重启设备最稳妥 |
第四类:系统兼容问题
| 检查项 | 说明 |
|---|
| 第三方 ROM 吗 | 第三方 ROM(crDroid、LineageOS 等)没有 HyperOS 的组件,Hook 目标找不到 → 不生效 |
| 国际版系统吗 | 国际版 HyperOS 的系统应用包名与国内版不同 → Hook 目标找不到 |
| HyperOS 小版本更新了吗 | 比如从 2.0.100 升到 2.0.200,内部方法签名可能变了。等 HyperCeiler 出新版本适配,或者去 GitHub Issues 提 bug |
| Android 16 / HyperOS 3 的适配进度 | 2.10.166 的 Release Notes 明确标注了部分功能在 Android 16 上不可用——这是正常的,等后续更新 |
第五类:主动安全模式
如果 HyperCeiler App 右上角有安全模式徽章,说明模块触发了连续崩溃、系统自动降级了。解决方法见 安全模式恢复。
如果还是找不到原因
去 GitHub Issues 提 bug,提交前:
- 确认有没有相同问题已经被提过
- 带上必要的设备信息:机型、HyperOS 版本号、Android 版本号、HyperCeiler 版本号、OS2 还是 OS3 分支
- 在 HyperCeiler 设置里把日志等级调到 Warn,带上崩溃日志