findscripter 何时使用
适用：
- 验证 React Native 或原生 Android App 的 UI 变更是否生效。
- 自主排查布局错位、交互失效等 Bug，无需人工反复点。
- 手动测试太慢、希望脚本化跑通某条功能路径。
- 为 PR/文档自动抓取截图作为证据。
前置条件：
- Android 模拟器已启动；
adb已安装并在 PATH 中。 - App 以 debug 模式运行（否则 logcat 拿不到 JS 日志）。
不该用（负边界）：
- 真机/设备农场的大规模兼容性测试。
- iOS 端验证。
- 已有成熟 E2E 框架（Espresso、Detox、Maestro）的项目——优先用框架而非裸 ADB。
- 缺少必要输入、权限、安全边界或成功判据时，先停下问清楚，不要盲点。
步骤
1. 设备校准（取真实分辨率）
交互前先确认屏幕尺寸，保证点击坐标准确。布局常被缩放，以返回的物理尺寸为坐标计算基准。
adb shell wm size
2. UI 探查（发现状态）
dump 当前界面树，定位按钮/输入框的精确边界：
adb shell uiautomator dump /sdcard/view.xml && adb pull /sdcard/view.xml ./artifacts/view.xml
在 view.xml 中按 text、content-desc 或 resource-id 搜索元素；bounds="[x1,y1][x2,y2]" 即可点击区域。
3. 交互指令
- 点击：
adb shell input tap <x> <y>（取元素 bounds 的中心点）。 - 滑动/滚动：
adb shell input swipe <x1> <y1> <x2> <y2> <duration_ms>。 - 文本输入：
adb shell input text "<message>"（特殊字符支持有限）。 - 按键事件：
adb shell input keyevent <code_id>（如 66 = Enter）。
4. 验证与报告
视觉验证——交互后截图确认 UI 变化：
adb shell screencap -p /sdcard/screen.png && adb pull /sdcard/screen.png ./artifacts/test_result.png
分析验证——实时查 JS 控制台日志，捕获报错或成功标记：
adb logcat -d | grep "ReactNativeJS" | tail -n 20
清理：所有生成文件统一放进 artifacts/ 目录，满足项目组织规范。
指令
- 中心点坐标：对
[x1,y1][x2,y2]取算术平均，cx=(x1+x2)/2, cy=(y1+y2)/2，命中最稳。 - 交互与验证之间插入 1-2 秒等待，避免动画未结束就截图/读日志。
- 在代码里打独特日志标记（如
✅ Action Successful），方便grep精确匹配验证结果。
示例
验证「点击登录按钮后出现首页」一条路径：
# 1. 校准
adb shell wm size
# 2. dump 取登录按钮 bounds，例如 [432,1200][648,1320] → 中心 (540,1260)
adb shell uiautomator dump /sdcard/view.xml && adb pull /sdcard/view.xml ./artifacts/view.xml
# 3. 点击并等待动画
adb shell input tap 540 1260
sleep 2
# 4. 截图 + 日志双重验证
adb shell screencap -p /sdcard/screen.png && adb pull /sdcard/screen.png ./artifacts/test_result.png
adb logcat -d | grep "ReactNativeJS" | tail -n 20
注意事项
- 快速失败：若
uiautomator dump失败或找不到预期文本，立刻停下排查，不要凭猜测盲点坐标。 - 坐标随分辨率/缩放变化，换设备或换 emulator 配置后务必重新校准，不要复用硬编码坐标。
input text对中文及特殊字符支持有限，必要时改用粘贴或 ADB IME 方案。- 不要把本技能输出当作环境特定校验、专家评审的替代品。
互见
- 研发/testing 域内其他 E2E 与回归验证技能。
- 截图/日志分析类技能可与本技能的 artifacts 产物串联。
采编自 sickn33/antigravity-awesome-skills（MIT License）。