v0.1.6

feat: add star gif in readme
feat: update deepcrawler crawl function parameters
feat: add mouse action and improve descriptions for actions prompt
feat: implement multi-frame crawler for iframe support

Author: mmmay0722

README.md

@@ -28,6 +28,14 @@
 
 <p align="center"><a href="README.md">English</a> · <a href="README_zh-CN.md">简体中文</a></p>
 
+<p align="center">
+  If you like WebQA Agent, please give us a ⭐ on GitHub!
+  <br/>
+  <a href="https://github.com/MigoXLab/webqa-agent/stargazers" target="_blank">
+    <img src="docs/images/star.gif" alt="Click Star" width="900">
+  </a>
+</p>
+
 <p align="center" itemprop="description">🤖 <strong>WebQA Agent</strong> is an autonomous web browser agent that audits performance, functionality & UX for engineers and vibe-coding creators. ✨</p>
 
 </div>

README_zh-CN.md

@@ -28,6 +28,14 @@
 
 <p align="center"><a href="README.md">English</a> · <a href="README_zh-CN.md">简体中文</a></p>
 
+<p align="center">
+  如果觉得有帮助，欢迎在 GitHub 上点个 ⭐ 支持！
+  <br/>
+  <a href="https://github.com/MigoXLab/webqa-agent/stargazers" target="_blank">
+    <img src="docs/images/star.gif" alt="Click Star" width="900">
+  </a>
+</p>
+
 <p align="center">🤖 <strong>WebQA Agent</strong> 是全自动网页评估测试 Agent，一键完成性能、功能与交互体验的测试评估 ✨</p>
 </div>
 

docs/images/star.gif

@@ -26,9 +26,9 @@ class TestCrawler:
 
     # Different crawl parameter combinations to test
     CRAWL_PARAMS = [
-        {'name': 'highlight_crawl', 'highlight': True, 'highlight_text': False, 'viewport_only': True},
-        {'name': 'text_highlight_crawl', 'highlight': True, 'highlight_text': True, 'viewport_only': True},
-        {'name': 'viewport_highlight_crawl', 'highlight': True, 'highlight_text': False, 'viewport_only': True},
+        {'name': 'highlight_crawl', 'highlight': True, 'filter_text': False, 'viewport_only': True},
+        {'name': 'text_highlight_crawl', 'highlight': True, 'filter_text': True, 'viewport_only': True},
+        {'name': 'viewport_highlight_crawl', 'highlight': True, 'filter_text': False, 'viewport_only': True},
     ]
 
     # Directories (class attributes; accessible via self)
@@ -155,7 +155,7 @@ async def crawl_single_url(self, url: str, params: Dict[str, Any]) -> Dict[str,
         crawl_result = await crawler.crawl(
             page=self.page,
             highlight=params['highlight'],
-            highlight_text=params['highlight_text'],
+            filter_text=params['filter_text'],
             viewport_only=params['viewport_only'],
         )
         crawl_data = crawl_result.element_tree

tests/test_crawler.py

@@ -14,14 +14,13 @@ def __init__(self, action_handler):
             "Clear": self._execute_clear,
             "Scroll": self._execute_scroll,
             "KeyboardPress": self._execute_keyboard_press,
-            "FalsyConditionStatement": self._execute_falsy,
-            "Check": self._execute_check,
             "GetNewPage": self._execute_get_new_page,
             "Upload": self._execute_upload,
             "SelectDropdown": self._execute_select_dropdown,
             "Drag": self._execute_drag,
             "GoToPage": self._execute_go_to_page,  # Added missing action
             "GoBack": self._execute_go_back,  # Added browser back navigation
+            "Mouse": self._execute_mouse, # Added mouse action
         }
 
     async def initialize(self):
@@ -146,14 +145,6 @@ async def _execute_keyboard_press(self, action):
         else:
             return {"success": False, "message": "Keyboard press failed."}
 
-    async def _execute_falsy(self, action):
-        """Execute falsy condition statement."""
-        return {"success": True, "message": "Falsy condition met."}
-
-    async def _execute_check(self, action):
-        """Execute check action."""
-        return {"success": True, "message": "Check action completed."}
-
     async def _execute_get_new_page(self, action):
         """Execute get new page action."""
         success = await self._actions.get_new_page()
@@ -335,4 +326,68 @@ async def _execute_go_back(self, action):
                 return {"success": False, "message": "Go back action not supported by action handler"}
         except Exception as e:
             logging.error(f"Go back action failed: {str(e)}")
-            return {"success": False, "message": f"Go back failed: {str(e)}", "playwright_error": str(e)}
+            return {"success": False, "message": f"Go back failed: {str(e)}", "playwright_error": str(e)}
+    
+    async def _execute_mouse(self, action):
+        """Unified mouse action supporting move and wheel.
+
+        Accepted param formats:
+        - { op: "move", x: number, y: number }
+        - { op: "wheel", deltaX: number, deltaY: number }
+        - Back-compat: if op is omitted, decide by presence of keys
+        """
+        try:
+            param = action.get("param")
+            if not param or not isinstance(param, dict):
+                return {"success": False, "message": "Missing or invalid param for mouse action"}
+            
+            op = param.get("op")
+            
+            # Auto-detect if op not provided or empty
+            if not op:
+                if "x" in param and "y" in param:
+                    op = "move"
+                elif "deltaX" in param or "deltaY" in param:
+                    op = "wheel"
+                else:
+                    return {"success": False, "message": "Missing mouse operation parameters (x/y or deltaX/deltaY)"}
+
+            if op == "move":
+                if not self._validate_params(action, ["param.x", "param.y"]):
+                    return {"success": False, "message": "Missing x or y coordinates for mouse move"}
+                
+                x = param.get("x")
+                y = param.get("y")
+                
+                # Validate coordinates are numbers
+                if not isinstance(x, (int, float)) or not isinstance(y, (int, float)):
+                    return {"success": False, "message": "x and y coordinates must be numbers"}
+                
+                success = await self._actions.mouse_move(x, y)
+                if success:
+                    return {"success": True, "message": f"Mouse moved to ({x}, {y})"}
+                else:
+                    return {"success": False, "message": "Mouse move action failed"}
+
+            elif op == "wheel":
+                # Default missing keys to 0
+                dx = param.get("deltaX", 0)
+                dy = param.get("deltaY", 0)
+                
+                # Validate deltas are numbers
+                if not isinstance(dx, (int, float)) or not isinstance(dy, (int, float)):
+                    return {"success": False, "message": "deltaX and deltaY must be numbers"}
+                
+                success = await self._actions.mouse_wheel(dx, dy)
+                if success:
+                    return {"success": True, "message": f"Mouse wheel scrolled (deltaX: {dx}, deltaY: {dy})"}
+                else:
+                    return {"success": False, "message": "Mouse wheel action failed"}
+
+            else:
+                logging.error(f"Unknown mouse op: {op}. Expected 'move' or 'wheel'.")
+                return {"success": False, "message": f"Unknown mouse operation: {op}. Expected 'move' or 'wheel'"}
+                
+        except Exception as e:
+            logging.error(f"Mouse action execution failed: {str(e)}")
+            return {"success": False, "message": f"Mouse action failed with an exception: {e}"}

webqa_agent/actions/action_executor.py

@@ -1429,3 +1429,30 @@ async def drag(self, source_coords, target_coords):
         except Exception as e:
             logging.error(f'Drag action failed: {str(e)}')
             return False
+    
+    async def mouse_move(self, x: int | float, y: int | float) -> bool:
+        """Move mouse to absolute coordinates (x, y)."""
+        try:
+            # Coerce to numbers in case strings are provided
+            target_x = float(x)
+            target_y = float(y)
+            await self.page.mouse.move(target_x, target_y)
+            logging.info(f"mouse move to ({target_x}, {target_y})")
+            await asyncio.sleep(0.1)
+            return True
+        except Exception as e:
+            logging.error(f"Mouse move failed: {str(e)}")
+            return False
+
+    async def mouse_wheel(self, delta_x: int | float = 0, delta_y: int | float = 0) -> bool:
+        """Scroll the mouse wheel by delta values."""
+        try:
+            dx = float(delta_x) if delta_x is not None else 0.0
+            dy = float(delta_y) if delta_y is not None else 0.0
+            await self.page.mouse.wheel(dx, dy)
+            logging.info(f"mouse wheel by (deltaX={dx}, deltaY={dy})")
+            await asyncio.sleep(0.1)
+            return True
+        except Exception as e:
+            logging.error(f"Mouse wheel failed: {str(e)}")
+            return False