出问题先走这张排查路线图
四层模型：先定位，再动手
模块的问题看起来五花八门，实际都能归进四层。先判断问题落在哪一层，再去翻对应的处理页，比从第一页一路试下来快得多：
| 层 | 典型症状 | 判断特征 |
|---|---|---|
| 框架层 | 一切功能无反应 | 模块管理器本身异常或未激活 |
| 作用域层 | 勾选重启后面板唤不出 | 管理器正常、聊天应用没被注入 |
| 面板层 | 面板能出但功能异常 | 开关、按钮、手势层面的问题 |
| 资源层 | 面板正常但内容加载失败 | 本地正常、仅在线内容异常 |
每层的第一处理站
- 框架层 → 回框架的官方说明检查激活状态；框架问题本站不展开；
- 作用域层 → 勾了作用域重启后还是没反应的排查思路，五项逐一对；
- 面板层 → 长按了但表情语音面板弹不出来的原因与聊天应用突然闪退或卡顿的处理顺序；
- 资源层 → 在线表情与语音加载失败的应对，多数与线路相关。
两个万能前置检查
不管哪一层，动手前先做这两件事，能省掉一半误判：
- 查版本：聊天应用是否升到了新大版本（适配空窗高发）、模块是不是旧版；
- 分本地与在线：本地保存的表情语音是否正常——正常则基本锁定资源层与线路，不正常则问题在更下层。
定位不了怎么办
四层都对过、症状仍说不清，就把现象按模板整理好去作者频道反馈，见向作者反馈问题要讲清哪五件事——描述得越有结构，被看到和解决的速度越快。