应用闪退：收集日志、定位原因、提交 Issue

HyperCeiler 会导致闪退吗

HyperCeiler 代码维护较好，正常使用很少闪退。但以下情况可能发生：

• 装错分支：OS3 分支装到 HyperOS 2 上，Hook 目标方法签名不对
• 系统更新后：HyperOS 小版本更新改了内部方法，旧的 Hook 代码失效
• 同时开了冲突的模块：比如同时装了 HyperCeiler 和另一个也 Hook 状态栏的模块，两者会相互干扰
• 打开了有 bug 的功能组合：某些功能同时开启会导致作用域进程崩溃

第一步：把日志等级调到 Warn

HyperCeiler App → 设置 → 日志等级 → 选择 Warn。

默认日志等级是 Info，信息不够详细。调到 Warn 后 HyperCeiler 会把所有 Hook 相关的警告和异常都记录下来。

第二步：触发闪退，然后收集日志

1. 复现闪退——打开导致闪退的那个功能、重启作用域、等它闪退
2. 闪退发生后，HyperCeiler 会在下一次打开时自动检测到异常
3. HyperCeiler App 里设置 → 应用崩溃异常追踪自检页——这是 2.6.161 起新增的页面，专门用来查看和导出崩溃日志
4. 把日志复制或导出出来

日志文件位置

HyperCeiler 的日志存放在 /data/user/0/com.sevtinge.hyperceiler/files/logs/ 目录下，文件名带时间戳。你也可以在 HyperCeiler App 里直接导出。

第三步：提交 Issue

到 GitHub Issues 页面提 bug，按下面的格式提供信息：

机型：小米 14
HyperOS 版本：3.0.300.CN01OS30A16
Android 版本：16
HyperCeiler 版本：2.10.166 OS3 分支
LSPosed 版本：v1.10.3

触发闪退的步骤：
1. 在 HyperCeiler 里打开了"焦点歌词 → 状态栏焦点"
2. 重启系统界面作用域
3. 系统界面闪退，状态栏和通知栏消失几秒后恢复

崩溃日志：
（把收集到的日志粘贴在这里）

其他信息：
- 同时装了哪些 Xposed 模块：只有 HyperCeiler
- 是否第三方 ROM：不是，官方原生
- 之前用的 HyperCeiler 版本：2.10.165，没这个问题

闪退后的应急处理

如果作用域进程一直在闪退、系统不稳定：

1. 先在 LSPosed 里把 HyperCeiler 模块临时禁用
2. 重启设备让系统恢复正常
3. 排查最近改动的功能开关，定位到具体哪个导致闪退
4. 把那个功能关掉，再重新启用 HyperCeiler