hyperceiler 中文文档 下载 App

模块不生效排查:按清单逐条核对

第一类: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,提交前:

  1. 确认有没有相同问题已经被提过
  2. 带上必要的设备信息:机型、HyperOS 版本号、Android 版本号、HyperCeiler 版本号、OS2 还是 OS3 分支
  3. 在 HyperCeiler 设置里把日志等级调到 Warn,带上崩溃日志