按键识别不到——从服务状态到设备协议的排查清单
按了键，Key Mapper 毫无反应——录制阶段遇上是「录不上」，日常使用遇上是「映射失灵」。两类表现的原因清单不同，分开排查。
录制时按了没反应
先查基本盘
蓝牙/外设按键录不上
这是蓝牙设备的常见现象，原因是协议而非配置：很多蓝牙耳机、音箱遥控不走标准按键事件，安卓收不到，Key Mapper 自然也收不到。官方明确说明很多蓝牙设备开箱不支持、蓝牙键盘则大多数正常。验证方法：把它当蓝牙键盘测试——蓝牙键盘的键能录上，说明服务没问题，是设备协议问题。
设备重启后外设映射失效（偶发）
官方记录过的已知问题（对应仓库 issue #783）：Key Mapper 用设备描述符区分外设，个别设备每次重启后描述符都变，导致「绑定该设备」的触发器失灵。解法：把触发器的设备从「指定设备」改回「任何设备（any device）」，牺牲一点防串扰能力换稳定。
日常使用中突然失灵
| 表现 | 先查什么 |
|---|---|
| 所有映射同时失灵 | 后台被杀（见随机失灵） |
| 只有音量键失灵 | 免打扰访问授权 |
| 只有外设键失灵 | 设备描述符漂移（上文）或设备协议 |
| 只有某个应用里失灵 | 约束条件挡了（见约束清单），或该应用独占按键 |
| 熄屏后失灵 | 没开「熄屏触发」+ Expert Mode（Expert Mode） |
已知系统级怪问题
- 熄屏时电源键 + 音量键组合导致音量跑满/静音：个别机型（官方测试记录含多款 OnePlus）的无障碍服务在 Android 9+ 上的系统级毛病，同类自动化应用同样中招——不是 Key Mapper 能修的
- DeX 模式进不去应用：三星 DeX 默认禁止带第三方输入法的应用运行，映射配置要在 DeX 外做好；一定要在 DeX 里开应用的话，DeX 设置里连点标题五次开开发者模式（官方 FAQ 的偏方）
- 应用卸载不掉：你开过设备管理员（锁屏动作会用到），设置 - 安全 - 设备管理员里取消勾选即可
排查到「确认是设备/系统层无解」时，把现象记下来：日志与反馈教你怎么给开发者一份有用的报告。