1. 下载并安装
前往 下载页 获取最新 APK，安装后首次启动会进入权限引导。
云手机用户建议在镜像中预装 App，并在系统设置里开启「开机自启」，避免重启后需要手动打开。
2. 完成权限引导
引导按顺序要求三项权限，缺一不可：
- 悬浮窗 — 显示运行状态条与控制球
- 无障碍服务 — 执行点击、滑动、文本输入，并读取控件树
- 电池优化白名单 — 避免后台被系统杀死
详细步骤见 权限配置。屏幕录制授权在执行需要截图的脚本时会单独弹出。
3. 写第一个脚本
进入「脚本」页 → 右下角 + → 选择目标应用（游戏或 App）→ 进入编辑器。 脚本是纯文本，一行一条指令。最小可运行的脚本如下：
#脚本: 我的第一个脚本
#默认重试: 3
等待 ocr:"开始" 最长10秒
点击 ocr:"开始" 直到 不存在 ocr:"开始"
等待 2秒
停止逐行含义：
#脚本:是头部配置，只做备注，不影响执行。等待 ocr:"开始" 最长10秒让脚本等待画面出现「开始」文字，最多等 10 秒。点击 ocr:"开始" 直到 不存在 ocr:"开始"点击该文字，并以「文字消失」作为校验。停止正常结束脚本。
ocr:"文字" 要求画面里真的有这四个字。如果目标按钮是图片而不是文字，请改用 yolo:类别名，
并先在「设置 → 模型管理」中导入对应模型。
不确定怎么写？用 AI 帮写
编辑器右下角有「AI 帮写」入口。用中文描述你想做的事，例如 「进入公会，捐赠 1000 结晶，然后把 5 次公会任务做完」，AI 会生成草案，你可以在对话面板里继续调整。 免费用户每天 20 次，基础会员 200 次，高级会员不限。
4. 加入队列并运行
保存脚本后回到「任务」页 → 队列 Tab → + 添加脚本，可设置重复次数、失败策略、执行前等待。 点「启动队列」后切到「运行中」Tab 可以看到实时画面、识别框和执行日志。
运行时画面上方会有一条悬浮状态条，显示当前状态节点、脚本行号与进度：
运行中 · 主城 · L12/46
状态：蓝点运行 / 黄点暂停 / 红点异常 / 灰点空闲
5. 运行不起来怎么办
- 一直卡在识别失败：确认权限已开、画面确实是脚本描述的那一屏；OCR 文案要一字不差。
- 点击没反应：可能是游戏使用 SurfaceView 渲染，无障碍无法直接操作，此时引擎会自动降级为截图 + 坐标点击。
- 脚本跑到一半暂停：说明某一行重试次数耗尽。查看失败截图与日志，定位是哪一行。
更多排查见 常见问题。
下一步
掌握了基本流程后，建议继续阅读：