常见问题

按顺序检查：

1. 当前画面是否真的是脚本描述的那一屏。中途掉线回到登录页时，靠 状态: 节点回退，如果没写状态节点就会卡住。
2. OCR 文案是否与屏幕上的文字完全一致，包括标点和空格。不确定时改用 ocr_contains:"关键词"。
3. YOLO 类别名是否与模型中的一致，置信度是否过高。可在「运行监控」页查看实时识别框与置信度。
4. 游戏更新后界面变化，需要补充截图重新训练模型。

如果同一段文字在屏幕上出现多次，OCR 可能定位到了另一处。 改用 yolo: 类别定位按钮，或在完整写法里用更精确的前置识别条件缩小范围。

VL 单次推理需要 3~10 秒，且只适合开放式判断。提问要尽量收敛，例如 「角色血条是否低于 30%，只回答是或否」，不要问需要长描述的问题。 能靠 YOLO 或 OCR 判断的场景就不要用 VL。

游戏常用 SurfaceView 渲染，无障碍读不到控件，也无法直接注入事件。 这种情况引擎会自动降级为「截图识别 + 坐标点击」。请确认已授权屏幕录制。

另外有些游戏会忽略过于精准的连续点击，此时可提高「防检测」强度，增加点击偏移与随机延时。

该行的前置识别或后置校验没通过。查看失败截图与日志里的行号， 确认是目标没找到（前置失败）还是操作没生效（后置失败）。 前者调整识别条件，后者增加等待时间或改用更可靠的校验条件。

常见原因：

• 脚本里命中了 停止 分支，例如出现「次数不足」「网络断开」。
• 某一行重试耗尽，引擎暂停脚本并告警。
• 账号池已全部执行完毕。

云手机重启、系统更新或省电策略都可能重置无障碍开关。 建议在云手机面板设置「开机自启」，并把 VsrTap 加入电池优化白名单。 App 检测到失效时会在悬浮球上显示红色告警。

这是 Android 系统对 MediaProjection 的限制，属于正常现象，无法绕过。 如果目标应用能用无障碍直接操作，可以不依赖截图，就不用每次重新授权。

识别频率越高越耗电。可在「设置 → 推理设置」中降低截图帧率、把 YOLO 分辨率从 640 调到 320， 并减少 VL 调用。长期挂机建议使用云手机而非实体机。

账号密码加密存储在本地数据库中，运行日志里一律掩码显示。 工作室模式下账号池存放在云端工作区，按工作区隔离。 导出数据源时会提示明文风险，请勿通过聊天工具传输。

在「我 → 云端备份」中手动备份后，换设备登录同一账号即可恢复脚本与数据源。 工作室版的数据本身就在云端，无需手动备份。

登录页点「忘记密码」，通过已绑定的邮箱或手机号接收验证码后重置。 没有绑定联系方式时，个人用户需要通过注册邮箱联系支持处理。

额度按自然日重置。免费用户每天 20 次，基础会员 200 次，高级会员不限次数。 额度只影响 AI 帮写，脚本运行本身不受影响。

建议先用单步调试跑一遍。AI 生成的是逻辑草案，识别条件里的文字与类别名需要你按实际界面校正， 否则会在执行时识别失败。

存在封号风险。绝大多数网络游戏的用户协议禁止使用自动化脚本。 VsrTap 的拟人化机制只能降低被检测的概率，不构成任何免封承诺。 请仅用于技术研究、单机游戏与内部测试场景，并自行承担全部风险。

防检测的目的是让自动化操作尽量接近真人节奏，减少因机械式操作被风控直接命中的概率。 它降低的是「被识别为脚本」的概率，而不是消除使用自动化本身的风险。