feat: add time limit for StartToGoal

examples/game/llk/game_llk.json

@@ -36,7 +36,7 @@
                         "method": "start_to_goal",
                         "params": "连连看是一款经典的益智消除类小游戏，通常以图案或图标为主要元素。以下是连连看的基本规则说明：\n1. 游戏目标: 玩家需要通过连接相同的图案或图标，将它们从游戏界面中消除。\n2. 连接规则:\n- 两个相同的图案可以通过不超过三条直线连接。\n- 连接线可以水平或垂直，但不能斜线，也不能跨过其他图案。\n- 连接线的转折次数不能超过两次。\n3. 游戏界面:\n- 游戏界面是一个矩形区域，内含多个图案或图标，排列成行和列；图案或图标在未选中状态下背景为白色，选中状态下背景为绿色。\n- 游戏界面下方是道具区域，共有 3 种道具，从左到右分别是：「高亮显示」、「随机打乱」、「减少种类」。\n4、游戏攻略：建议多次使用道具，可以降低游戏难度\n- 优先使用「减少种类」道具，可以将图案种类随机减少一种\n- 遇到困难时，推荐使用「随机打乱」道具，可以获得很多新的消除机会\n- 观看广告视频，待屏幕右上角出现「领取成功」后，点击其右侧的 X 即可关闭广告，继续游戏\n\n请严格按照以上游戏规则，开始游戏\n",
                         "options": {
-                            "max_retry_times": 100
+                            "time_limit": 300
                         }
                     }
                 ]

examples/game/llk/main_test.go

@@ -7,13 +7,14 @@ import (
 	"os"
 	"testing"
 
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
 	hrp "github.com/httprunner/httprunner/v5"
 	"github.com/httprunner/httprunner/v5/internal/builtin"
 	"github.com/httprunner/httprunner/v5/uixt/ai"
 	"github.com/httprunner/httprunner/v5/uixt/option"
 	"github.com/httprunner/httprunner/v5/uixt/types"
-	"github.com/stretchr/testify/assert"
-	"github.com/stretchr/testify/require"
 )
 
 func TestGameLianliankan(t *testing.T) {
@@ -45,7 +46,7 @@ func TestGameLianliankan(t *testing.T) {
 				AssertAI("当前位于抖音「连了又连」小游戏页面"),
 			hrp.NewStep("开始游戏").
 				Android().
-				StartToGoal(userInstruction, option.WithMaxRetryTimes(100)),
+				StartToGoal(userInstruction, option.WithTimeLimit(300)),
 		},
 	}
 	err := testCase.Dump2JSON("game_llk.json")

examples/game/romantic_restaurant/game_romantic_restaurant.json

@@ -65,7 +65,7 @@
                         "method": "start_to_goal",
                         "params": "浪漫餐厅是一款经营类游戏，以下是游戏的基本规则说明：\n1、点击右下角锅铲，开始任务\n2、将棋子拖拽至相同棋子，可升级生成新棋子\n3、拖拽相同棋子时，被部分遮挡的棋子只能作为拖拽终点，不能作为拖拽起点\n4、当游戏界面中没有相同棋子时，可以点击游戏页面中央的购物袋生成新的棋子\n5、若不知道如何操作，请按照游戏指引进行游玩\n\n请严格按照以上游戏规则，开始游戏\n",
                         "options": {
-                            "timeout": 300,
+                            "time_limit": 300,
                             "pre_mark_operation": true
                         }
                     }

examples/game/romantic_restaurant/main_test.go

@@ -42,7 +42,7 @@ func TestGameRomanticRestaurant(t *testing.T) {
 				Android().
 				StartToGoal(userInstruction,
 					option.WithPreMarkOperation(true),
-					option.WithTimeout(300)), // 5 minutes
+					option.WithTimeLimit(300)), // 5 minutes
 			hrp.NewStep("退出抖音 app").
 				Android().
 				AppTerminate("$package_name"),

examples/game/sudoku/game_sudoku.json

@@ -65,7 +65,7 @@
                         "method": "start_to_goal",
                         "params": "每天数独是一款逻辑推理游戏，玩家需要通过推理来确定黄色方块的所在位置，以下是游戏的基本规则说明：\n1、方块外面的数字代表所在那一行或一列的黄色方块数量。\n2、初始状态为白色方块，选择正确后变为黄色方块，选择错误后变为红底的 X。\n3、如果同一行或列有两个数字，则至少需要一个白底 X 分割它们作为间隔。\n4、如果数字与格子最大数相同时，该列或行必然全都是黄色方块。\n5、只能点击白色方块，不要重复点击同一个方块。\n\n请严格按照以上游戏规则，开始游戏\n",
                         "options": {
-                            "timeout": 300,
+                            "time_limit": 300,
                             "pre_mark_operation": true
                         }
                     }

examples/game/sudoku/main_test.go

@@ -42,7 +42,7 @@ func TestGameSudoku(t *testing.T) {
 				Android().
 				StartToGoal(userInstruction,
 					option.WithPreMarkOperation(true),
-					option.WithTimeout(300)), // 5 minutes
+					option.WithTimeLimit(300)), // 5 minutes
 			hrp.NewStep("退出抖音 app").
 				Android().
 				AppTerminate("$package_name"),

examples/game/yanglegeyang/game_yanglegeyang.json

@@ -65,7 +65,7 @@
                         "method": "start_to_goal",
                         "params": "羊了个羊是一款热门的消除类小游戏，玩法简单但具有挑战性。以下是游戏的基本规则说明：\n1. 游戏目标: 玩家需要通过消除图案来完成关卡，最终目标是清空所有图案。\n2. 消除规则:\n- 游戏界面中会出现多个图案，玩家需要点击图案将其放入底部的槽中。\n- 图案存在多层堆叠的情况，只能点击最上层的完整图案。\n- 当槽中有三个相同的图案时，这三个图案会自动消除。\n- 玩家需要尽量避免槽中积累过多不同的图案，以免无法继续消除。\n- 严禁点击收集槽里的图案，严禁观看广告和使用道具（移出、撤回、洗牌）。\n- 请持续推进游戏进程，游戏通关后继续下一关，游戏失败后重新开始。\n3. 游戏界面: 图案通常以堆叠的方式呈现，玩家需要逐层消除。\n4. 关卡设计: 游戏包含多个关卡，随着关卡的推进，图案的复杂度和数量会增加。\n5. 策略性: 玩家需要规划消除顺序，以避免槽中积累过多无法消除的图案。\n\n请严格按照以上游戏规则，开始游戏\n",
                         "options": {
-                            "timeout": 300,
+                            "time_limit": 300,
                             "pre_mark_operation": true
                         }
                     }

examples/game/yanglegeyang/main_test.go

@@ -49,7 +49,7 @@ func TestGameYanglegeyang(t *testing.T) {
 				Android().
 				StartToGoal(userInstruction,
 					option.WithPreMarkOperation(true),
-					option.WithTimeout(300)), // 5 minutes
+					option.WithTimeLimit(300)), // 5 minutes
 			hrp.NewStep("退出抖音 app").
 				Android().
 				AppTerminate("$package_name"),

examples/game/yuedongxiaozi/game_yuedongxiaozi.json

@@ -0,0 +1,88 @@
+{
+    "config": {
+        "name": "跃动小子小游戏自动化测试",
+        "variables": {
+            "package_name": "com.ss.android.ugc.aweme"
+        },
+        "ai_options": {
+            "llm_service": "doubao-1.5-thinking-vision-pro-250428"
+        }
+    },
+    "teststeps": [
+        {
+            "name": "启动抖音 app",
+            "android": {
+                "os_type": "android",
+                "actions": [
+                    {
+                        "method": "app_launch",
+                        "params": "$package_name"
+                    },
+                    {
+                        "method": "sleep",
+                        "params": 5
+                    }
+                ]
+            },
+            "validate": [
+                {
+                    "check": "ui_foreground_app",
+                    "assert": "equal",
+                    "expect": "$package_name",
+                    "msg": "app [$package_name] should be in foreground"
+                }
+            ]
+        },
+        {
+            "name": "启动「跃动小子」小游戏",
+            "android": {
+                "os_type": "android",
+                "actions": [
+                    {
+                        "method": "start_to_goal",
+                        "params": "搜索「跃动小子」，启动小游戏",
+                        "options": {
+                            "pre_mark_operation": true
+                        }
+                    }
+                ]
+            },
+            "validate": [
+                {
+                    "check": "ui_ai",
+                    "assert": "ai_assert",
+                    "expect": "当前页面底部包含「领地」「试炼」按钮",
+                    "msg": "assert ai prompt [当前页面底部包含「领地」「试炼」按钮] failed"
+                }
+            ]
+        },
+        {
+            "name": "开始游戏",
+            "android": {
+                "os_type": "android",
+                "actions": [
+                    {
+                        "method": "start_to_goal",
+                        "params": "跃动小子是一款开宝箱类的小游戏，以下是游戏的基本规则说明：\n1、打开宝箱，按照游戏指引进行「出售」或「装备」操作。\n2、请持续推进游戏进程。\n3、屏幕底部的黑白按钮不要进行点击操作。\n\n请严格按照以上游戏规则，开始游戏\n",
+                        "options": {
+                            "time_limit": 300,
+                            "pre_mark_operation": true
+                        }
+                    }
+                ]
+            }
+        },
+        {
+            "name": "退出抖音 app",
+            "android": {
+                "os_type": "android",
+                "actions": [
+                    {
+                        "method": "app_terminate",
+                        "params": "$package_name"
+                    }
+                ]
+            }
+        }
+    ]
+}

examples/game/yuedongxiaozi/main_test.go

@@ -0,0 +1,55 @@
+package game_yuedongxiaozi
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	hrp "github.com/httprunner/httprunner/v5"
+	"github.com/httprunner/httprunner/v5/uixt/option"
+)
+
+func TestGameZhuadaE(t *testing.T) {
+	userInstruction := `跃动小子是一款开宝箱类的小游戏，以下是游戏的基本规则说明：
+1、打开宝箱，按照游戏指引进行「出售」或「装备」操作。
+2、请持续推进游戏进程。
+3、屏幕底部的黑白按钮不要进行点击操作。
+
+请严格按照以上游戏规则，开始游戏
+`
+
+	testCase := &hrp.TestCase{
+		Config: hrp.NewConfig("跃动小子小游戏自动化测试").
+			SetLLMService(option.DOUBAO_1_5_THINKING_VISION_PRO_250428).
+			WithVariables(map[string]interface{}{
+				"package_name": "com.ss.android.ugc.aweme",
+			}),
+		TestSteps: []hrp.IStep{
+			hrp.NewStep("启动抖音 app").
+				Android().
+				AppLaunch("$package_name").
+				Sleep(5).
+				Validate().
+				AssertAppInForeground("$package_name"),
+			hrp.NewStep("启动「跃动小子」小游戏").
+				Android().
+				StartToGoal("搜索「跃动小子」，启动小游戏",
+					option.WithPreMarkOperation(true)).
+				Validate().
+				AssertAI("当前页面底部包含「领地」「试炼」按钮"),
+			hrp.NewStep("开始游戏").
+				Android().
+				StartToGoal(userInstruction,
+					option.WithPreMarkOperation(true),
+					option.WithTimeLimit(300)), // 5 minutes
+			hrp.NewStep("退出抖音 app").
+				Android().
+				AppTerminate("$package_name"),
+		},
+	}
+	err := testCase.Dump2JSON("game_yuedongxiaozi.json")
+	require.Nil(t, err)
+
+	// err = hrp.NewRunner(t).Run(testCase)
+	// assert.Nil(t, err)
+}

examples/game/zhuadae/game_zhuadae.json

@@ -88,7 +88,7 @@
                         "method": "start_to_goal",
                         "params": "抓大鹅是一款抓取类小游戏，以下是游戏的基本规则说明：\n1. 游戏目标: 玩家需要通过抓取图案来完成关卡，最终目标是清空所有图案。\n2. 抓取规则:\n- 游戏界面中会出现多个图案，图案存在多层堆叠的情况，玩家需要点击图案将其抓取放入到槽中。\n- 当抓取到三个相同的图案放入抓取槽时，这三个图案会成功消除。\n- 需要尽量避免抓取槽满的情况，抓取槽满时游戏失败。\n- 游戏通关后继续进入下一关，游戏失败后重新开始游戏。\n\n请严格按照以上游戏规则，开始游戏\n",
                         "options": {
-                            "timeout": 300,
+                            "time_limit": 300,
                             "pre_mark_operation": true
                         }
                     }

examples/game/zhuadae/main_test.go

@@ -50,7 +50,7 @@ func TestGameZhuadaE(t *testing.T) {
 				Android().
 				StartToGoal(userInstruction,
 					option.WithPreMarkOperation(true),
-					option.WithTimeout(300)), // 5 minutes
+					option.WithTimeLimit(300)), // 5 minutes
 			hrp.NewStep("退出抖音 app").
 				Android().
 				AppTerminate("$package_name"),