故障排查
常见问题排查
汇总权限、悬浮窗、截图识别、点击偏移、后台运行和远程连接等高频问题的排查路径。
先确认基础状态
遇到脚本无法运行、悬浮窗不显示、识别失败或远程连接异常时，建议先确认基础状态。多数问题不是脚本本身损坏，而是系统权限、后台限制、页面状态或分辨率基准不一致导致。
排查时不要一次修改太多设置。建议先从权限页、运行日志和当前页面状态开始，逐步确认是哪一类问题。
- 确认无障碍服务处于开启状态，且没有被系统自动关闭。
- 确认悬浮窗权限、通知权限、截图权限按当前功能需要开启。
- 确认目标应用已经停留在脚本预期页面，页面元素没有被弹窗、键盘或权限框遮挡。
- 打开运行日志，优先查看失败动作、耗时异常动作和变量读取结果。
无障碍已开启但脚本不能运行
无障碍权限开启后，脚本仍然不能运行，通常与服务未真正连接、系统后台限制、权限被系统回收、目标应用界面变化有关。部分手机会显示权限已开启，但服务连接回调延迟或被安全策略暂停。
如果刚从系统设置页返回，建议回到 WeMod 后等待数秒，再进入权限页确认服务状态。仍然异常时，可以关闭无障碍后重新开启，或重启 App 后再次检查。
- 先在 WeMod 权限页查看无障碍状态，而不是只看系统设置开关。
- 检查系统是否开启了省电模式、后台冻结、自动清理或安全管家限制。
- 如果运行入口在悬浮窗中，确认悬浮窗没有被系统隐藏。
- 如果只在某个应用内失败，检查该应用页面是否升级、布局是否变化、是否出现弹窗或登录状态变化。
悬浮窗不显示或运行中消失
悬浮窗依赖系统悬浮窗权限和厂商后台策略。部分 ROM 会在切换应用、锁屏、清理后台、进入游戏模式或开启省电模式后隐藏悬浮窗。
建议在系统设置中允许 WeMod 显示在其他应用上层，并在应用管理中允许后台运行、自启动和通知展示。
- 确认悬浮窗权限已经开启。
- 确认没有被游戏助手、隐私保护、应用锁或安全中心拦截。
- 运行长脚本前，将 WeMod 加入后台保护或锁定最近任务。
- 如果悬浮窗位置异常，可尝试收起后重新展开或重新进入脚本编辑器。
点击位置偏移或识别不到目标
点击偏移常见于脚本录制设备与当前设备分辨率、状态栏高度、导航栏模式、屏幕方向不一致的情况。识别失败常见于页面缩放、主题颜色变化、图片模板过期或截图权限异常。
对于跨设备使用的脚本，建议减少纯坐标点击，更多使用视觉识别、文本识别、条件判断和变量。
- 确认脚本分辨率基准与当前手机真实分辨率是否一致。
- 确认目标应用是否开启深色模式、字体放大、显示大小调整或横竖屏切换。
- 确认导航栏模式是否从三键导航切换为手势导航。
- 识别失败时，重新截取模板或扩大识别区域，避免模板过小。
远程连接失败或黑屏
远程连接涉及网络、屏幕采集、WebRTC 候选、设备权限和双方在线状态。局域网连接通常更稳定，跨网连接会受到 NAT、运营商网络、防火墙和 TURN 配置影响。
黑屏不一定代表连接完全失败，也可能是被控端没有授予屏幕采集权限、系统禁止后台采集、目标设备锁屏或屏幕内容被系统安全策略保护。
- 优先确认两台设备均在线，且被控端授权了屏幕采集。
- 局域网模式下确认两台设备处于同一网络，路由器没有开启客户端隔离。
- 服务云或跨网模式下确认网络稳定，并检查连接状态是否停留在 ICE failed/closed。
- 遇到黑屏时，重新授权屏幕采集并保持被控端前台唤醒。