v0.1.3

Add English/Chinese UI switching.
Enhance test case management and update README.
Abort test case early when failure is unrecoverable.
Refresh Gradio i18n locales for zh-CN and en-US.

Author: mmmay0722

Dockerfile

@@ -1,9 +1,9 @@
 FROM mcr.microsoft.com/playwright/python:v1.52.0-noble
 
-# 设置工作目录
+# Set working directory
 WORKDIR /app
 
-# 安装 Node.js 和 npm，以及必要的工具
+# Install Node.js, npm, and necessary tools
 RUN apt-get update && apt-get install -y \
     curl \
     unzip \
@@ -12,13 +12,13 @@ RUN apt-get update && apt-get install -y \
     && apt-get install -y nodejs \
     && rm -rf /var/lib/apt/lists/*
 
-# 优化pip配置和网络设置
+# Optimize pip configuration and network settings
 RUN pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple && \
     pip config set global.trusted-host mirrors.tuna.tsinghua.edu.cn && \
     pip config set global.timeout 300 && \
     pip config set global.retries 5
 
-# 1. 先安装nuclei
+# 1. Install nuclei first
 RUN ARCH=$(dpkg --print-architecture) && \
     if [ "$ARCH" = "amd64" ]; then \
         NUCLEI_ARCH="amd64"; \
@@ -35,19 +35,19 @@ RUN ARCH=$(dpkg --print-architecture) && \
     chmod +x /usr/local/bin/nuclei && \
     rm -rf /tmp/nuclei /tmp/nuclei.zip
 
-# 2. 复制Python依赖文件并安装
+# 2. Copy Python dependency file and install
 COPY requirements.txt /app/
 RUN pip install --no-cache-dir --default-timeout=300 -r requirements.txt
 
-# 3. 复制Node.js依赖文件并安装
+# 3. Copy Node.js dependency file and install
 COPY package.json /app/
 RUN npm install
 
-# 4. 复制项目文件
+# 4. Copy project files
 COPY . /app
 
-# 更新nuclei模板
+# Update nuclei templates
 RUN nuclei -ut -v
 
-# 设置运行webqa-agent
+# Set to run webqa-agent
 CMD ["python", "webqa-agent.py"]

README.md

@@ -1,17 +1,22 @@
-# WebQA Agent
+<h1 align="center">WebQA Agent</h1>
 
 <!-- badges -->
-<p align="left">
+<p align="center">
   <a href="https://github.com/MigoXLab/webqa-agent/blob/main/LICENSE"><img src="https://img.shields.io/github/license/MigoXLab/webqa-agent" alt="License"></a>
   <a href="https://github.com/MigoXLab/webqa-agent/stargazers"><img src="https://img.shields.io/github/stars/MigoXLab/webqa-agent" alt="GitHub stars"></a>
   <a href="https://github.com/MigoXLab/webqa-agent/network/members"><img src="https://img.shields.io/github/forks/MigoXLab/webqa-agent" alt="GitHub forks"></a>
   <a href="https://github.com/MigoXLab/webqa-agent/issues"><img src="https://img.shields.io/github/issues/MigoXLab/webqa-agent" alt="GitHub issues"></a>
   <a href="https://deepwiki.com/MigoXLab/webqa-agent"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
-[English](README.md) · [简体中文](README_zh-CN.md) 
+<p align="center">
+  Try Demo 🤗<a href="https://huggingface.co/spaces/mmmay0722/WebQA-Agent">HuggingFace</a> | 🚀<a href="https://modelscope.cn/studios/mmmmei22/WebQA-Agent/summary">ModelScope</a><br>
+  Join us on 🎮<a href="https://discord.gg/K5TtkVcx">Discord</a> | 💬<a href="https://aicarrier.feishu.cn/docx/NRNXdIirXoSQEHxhaqjchUfenzd">WeChat</a>
+</p>
+
+<p align="center"><a href="README.md">English</a> · <a href="README_zh-CN.md">简体中文</a></p>
 
-**WebQA Agent** is an autonomous web agent that audits performance, functionality, and UX for any web product.
+<p align="center">🤖 <strong>WebQA Agent</strong> is an autonomous web browser agent that audits performance, functionality & UX for engineers and vibe-coding creators. ✨</p>
 
 ## 🚀 Core Features
 
@@ -101,7 +106,9 @@ python webqa-agent.py
 
 ## Online Demo
 
-Experience online: [WebQA-Agent on ModelScope](https://modelscope.cn/studios/mmmmei22/WebQA-Agent/summary)
+🚀 **Try WebQA Agent Online:**
+- **Hugging Face Spaces**: [WebQA-Agent on Hugging Face](https://huggingface.co/spaces/mmmay0722/WebQA-Agent)
+- **ModelScope Studio**: [WebQA-Agent on ModelScope](https://modelscope.cn/studios/mmmmei22/WebQA-Agent/summary)
 
 ## Usage
 

README_zh-CN.md

@@ -1,17 +1,22 @@
-# WebQA Agent
+<h1 align="center">WebQA Agent</h1>
 
 <!-- badges -->
-<p align="left">
+<p align="center">
   <a href="https://github.com/MigoXLab/webqa-agent/blob/main/LICENSE"><img src="https://img.shields.io/github/license/MigoXLab/webqa-agent" alt="License"></a>
   <a href="https://github.com/MigoXLab/webqa-agent/stargazers"><img src="https://img.shields.io/github/stars/MigoXLab/webqa-agent" alt="GitHub stars"></a>
   <a href="https://github.com/MigoXLab/webqa-agent/network/members"><img src="https://img.shields.io/github/forks/MigoXLab/webqa-agent" alt="GitHub forks"></a>
   <a href="https://github.com/MigoXLab/webqa-agent/issues"><img src="https://img.shields.io/github/issues/MigoXLab/webqa-agent" alt="GitHub issues"></a>
   <a href="https://deepwiki.com/MigoXLab/webqa-agent"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
-[English](README.md) · [简体中文](README_zh-CN.md) 
+<p align="center">
+  体验Demo 🤗<a href="https://huggingface.co/spaces/mmmay0722/WebQA-Agent">HuggingFace</a> | 🚀<a href="https://modelscope.cn/studios/mmmmei22/WebQA-Agent/summary">ModelScope</a><br>
+  加入我们 🎮<a href="https://discord.gg/K5TtkVcx">Discord</a> | 💬<a href="https://aicarrier.feishu.cn/docx/NRNXdIirXoSQEHxhaqjchUfenzd">微信群</a>
+</p>
 
-**WebQA Agent** 是全自动网页评估测试 Agent，一键诊断性能、安全、功能与交互体验
+<p align="center"><a href="README.md">English</a> · <a href="README_zh-CN.md">简体中文</a></p>
+
+<p align="center">🤖 <strong>WebQA Agent</strong> 是全自动网页评估测试 Agent，一键完成性能、功能与交互体验的测试评估 ✨</p>
 
 ## 🚀 核心特性
 
@@ -104,7 +109,9 @@ python webqa-agent.py
 
 ## 在线演示
 
-进入ModelScope体验：[WebQA-Agent on ModelScope](https://modelscope.cn/studios/mmmmei22/WebQA-Agent/summary)
+🚀 **在线体验 WebQA Agent:**
+- **Hugging Face Spaces**: [WebQA-Agent on Hugging Face](https://huggingface.co/spaces/mmmay0722/WebQA-Agent)
+- **ModelScope Studio**: [WebQA-Agent on ModelScope](https://modelscope.cn/studios/mmmmei22/WebQA-Agent/summary)
 
 ## 使用说明
 
@@ -139,7 +146,6 @@ browser_config:
   headless: False                                 # Docker环境会自动覆盖为True
   language: zh-CN
   cookies: []
-
 ```
 
 在配置和运行测试时，请注意以下重要事项：

app.py

@@ -1,27 +1,43 @@
 #!/usr/bin/env python3
 """
-WebQA Agent Gradio启动脚本
+WebQA Agent Gradio Launch Script
 """
 
 import sys
 import os
 import subprocess
 import asyncio
 
-# 添加项目路径到Python路径
-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+# Add project path to Python path
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 
-# 导入并启动Gradio应用
+# Language configuration from environment variable
+def get_gradio_language():
+    """Get Gradio interface language from environment variable with validation"""
+    supported_languages = ["zh-CN", "en-US"]
+    env_lang = os.getenv("GRADIO_LANGUAGE", "en-US")  # Default to English
+    
+    if env_lang in supported_languages:
+        return env_lang
+    else:
+        print(f"⚠️  Warning: Unsupported language '{env_lang}', falling back to 'en-US'")
+        return "en-US"
+
+GRADIO_LANGUAGE = get_gradio_language()
+
+# Import and launch Gradio application
 if __name__ == "__main__":
     try:
-        from demo_gradio import create_gradio_interface, queue_manager, process_queue
+        from app_gradio.demo_gradio import create_gradio_interface, queue_manager, process_queue
         import threading
         from playwright.async_api import async_playwright, Error as PlaywrightError
 
-        print("🚀 启动WebQA Agent Gradio界面...")
-        print("📱 界面将在 http://localhost:7860 启动")
-        print("⚠️  注意：请确保已安装所有依赖包 (pip install -r requirements.txt)")
-        print("🔍 正在检查 Playwright 浏览器依赖...")
+        print("🚀 Starting WebQA Agent Gradio interface...")
+        print("📱 Interface will start at http://localhost:7860")
+        print(f"🌐 Interface language: {GRADIO_LANGUAGE}")
+        print("💡 Tip: Set environment variable GRADIO_LANGUAGE=en-US for English or GRADIO_LANGUAGE=zh-CN for Chinese")
+        print("⚠️  Note: Please ensure all dependencies are installed (pip install -r requirements.txt)")
+        print("🔍 Checking Playwright browser dependencies...")
 
         async def _check_playwright():
             try:
@@ -36,53 +52,53 @@ async def _check_playwright():
 
         ok = asyncio.run(_check_playwright())
         if not ok:
-            print("⚠️  检测到 Playwright 浏览器未安装，正在自动安装...")
+            print("⚠️  Detected Playwright browsers not installed, installing automatically...")
             try:
                 cmd = [sys.executable, "-m", "playwright", "install"]
                 result = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True)
                 print(result.stdout)
             except Exception as e:
-                print(f"❌ 自动安装失败：{e}\n请手动执行：playwright install")
+                print(f"❌ Automatic installation failed: {e}\nPlease run manually: playwright install")
                 sys.exit(1)
 
-            # 安装后再次校验
+            # Verify again after installation
             ok_after = asyncio.run(_check_playwright())
             if not ok_after:
-                print("❌ Playwright 浏览器仍不可用，请手动执行：playwright install")
+                print("❌ Playwright browsers still unavailable, please run manually: playwright install")
                 sys.exit(1)
-        print("✅ Playwright 浏览器可用")
+        print("✅ Playwright browsers available")
 
-        # 启动队列处理器
+        # Start queue processor
         def run_queue_processor():
-            """在后台线程中运行队列处理器"""
+            """Run queue processor in background thread"""
             loop = asyncio.new_event_loop()
             asyncio.set_event_loop(loop)
             loop.run_until_complete(process_queue())
 
         queue_thread = threading.Thread(target=run_queue_processor, daemon=True)
         queue_thread.start()
-        print("✅ 任务队列处理器已启动")
+        print("✅ Task queue processor started")
 
-        # 创建并启动Gradio应用
-        app = create_gradio_interface()
-        print("✅ Gradio界面已创建")
+        # Create and launch Gradio application with language configuration
+        app = create_gradio_interface(language=GRADIO_LANGUAGE)
+        print(f"✅ Gradio interface created with language: {GRADIO_LANGUAGE}")
 
         app.launch(
             server_name="0.0.0.0",
             server_port=7860,
             share=False,
             show_error=True,
-            inbrowser=True  # 自动打开浏览器
+            inbrowser=True  # Auto open browser
         )
 
     except ImportError as e:
-        print(f"❌ 导入错误: {e}")
-        print("请确保已安装所有依赖包:")
+        print(f"❌ Import error: {e}")
+        print("Please ensure all dependencies are installed:")
         print("pip install -r requirements.txt")
         sys.exit(1)
 
     except Exception as e:
-        print(f"❌ 启动失败: {e}")
+        print(f"❌ Startup failed: {e}")
         import traceback
         traceback.print_exc()
         sys.exit(1)