// 文档地址 https://docs.hamibot.com/
// 查找屏幕上的可滚动列表并执行下滑操作
var list = className('android.support.v7.widget.RecyclerView').scrollable().findOne();
list.scrollForward();

代码说明：

1. className('android.support.v7.widget.RecyclerView') 用于匹配常见的列表控件（部分应用可能需要改为 classNameEndsWith("RecyclerView") 或使用具体控件ID）
2. .scrollable() 确保控件具备滚动属性
3. .findOne() 获取首个匹配的控件
4. .scrollForward() 执行向前滑动（包括下滑/右滑）

使用建议：

• 遇到特定应用（如QQ/微信）时，建议用Hamibot悬浮窗分析控件属性，替换更精确的 id() 或 className()
• 如需循环滑动，可将 scrollForward() 放入 while(true) 循环中
• 部分新版应用使用 androidx.recyclerview.widget.RecyclerView，需要调整类名为完整路径

补充回答 1

// 文档地址 https://docs.hamibot.com/
// 下拉页面触发刷新的经典实现
var refreshLayout = className("android.support.v4.widget.SwipeRefreshLayout").findOne();
refreshLayout.click();

进阶方案：

// 适用于没有明确刷新控件的场景
var listView = className("android.support.v7.widget.RecyclerView").findOne();
// 先滚动到顶部
listView.scrollToBeginning();
// 再模拟下拉手势
gesture(1000, [500, 300], [500, 1000]); // 从屏幕顶部向下拖动

关键说明：

1. SwipeRefreshLayout 是 Android 标准下拉刷新控件类名，部分应用可能使用自定义控件需要调整
2. scrollToBeginning() 需要 Hamibot v3.8+ 支持，用于确保从顶部开始刷新
3. gesture() 模拟物理拖动手势，坐标值需根据实际屏幕尺寸调整
4. 对于微信/QQ等应用，建议使用悬浮窗分析最新控件信息：

id("recent_chat_list").className("AbsListView").findOne().scrollForward();

调试建议：

• 遇到找不到控件时，使用 descContains("刷新") 或 textContains("刷新") 辅助定位
• 添加 sleep(1000) 保证动画执行完整
• 用 if(className("SwipeRefreshLayout").exists()) 做存在性校验

补充回答 2

// 文档地址 https://docs.hamibot.com/
// 使用 for 循环重复执行手势操作
for (var i = 0; i < 5; i++) {  // 循环5次
    gesture(1000, [500, 1500], [500, 500]);  // 从屏幕底部向上滑动
    sleep(2000);  // 每次间隔2秒
}

进阶方案：

// 无限循环示例（需手动停止）
(function loop() {
    gesture(800, [300, 1200], [700, 800]);  // 800ms完成滑动手势
    sleep(3000);  // 等待3秒后重复
    loop();  // 递归调用自身
})();

带条件判断的循环：

// 当特定控件存在时循环执行
while (id("refresh_icon").exists()) {
    gesture(500, [device.width/2, device.height*0.3], [device.width/2, device.height*0.7]);
    sleep(1500);
    // 添加退出条件防止死循环
    if (someCondition()) break;
}

调试建议：

1. 使用 device.width 和 device.height 自动适配不同分辨率
2. 循环中务必添加 sleep() 保证手势间隔合理（建议 ≥800ms）
3. 检查是否需要添加权限声明：

auto.waitFor();
// Android 10+需添加前台权限
if (device.sdkInt >= 29) {
    requestPermissions(["android.permission.FOREGROUND_SERVICE"]);
}

注意事项：

• 单次手势最大点数建议不超过20个坐标点
• 循环超过10次时建议添加防封策略（随机时间间隔）
• 需要多线程执行时可使用 threads.start() 包裹循环体