# 檢查Python版本
python --version

# 如果未安裝，推薦使用 Python 3.11
# 下載地址：https://www.python.org/downloads/

# 創(chuàng)建項(xiàng)目目錄
mkdir auto_ui
cd auto_ui
# 創(chuàng)建虛擬環(huán)境（推薦）
python -m venv venv
# 激活虛擬環(huán)境
.\venv\Scripts\activate
# 如果遇到執(zhí)行策略問(wèn)題
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 安裝Playwright（會(huì)包含測(cè)試框架）
pip install playwright pytest-playwright
# 或者分步安裝
pip install playwright
pip install pytest
pip install pytest-playwright
# 安裝AI集成所需的包（可選）
pip install openai anthropic
pip install python-dotenv

# requirements.txt
playwright==1.58.0
pytest==8.0.0
pytest-playwright==0.4.4
pytest-html==4.1.1
allure-pytest==2.13.2
# YAML配置支持
PyYAML==6.0.1
# AI集成（可選）
openai==1.12.0
anthropic==0.18.0
python-dotenv==1.0.1
# 日志和時(shí)間
python-dateutil==2.8.2

pip install -r requirements.txt

# 安裝Chromium瀏覽器
python -m playwright install chromium

# 安裝所有瀏覽器
python -m playwright install

# 指定安裝位置
python -m playwright install chromium --with-deps

# 檢查系統(tǒng)Chrome路徑
Test-Path "C:\Program Files\Google\Chrome\Application\chrome.exe"

# conftest.py
@pytest.fixture(scope="function")
def browser_context(browser):
    context = browser.new_context(
        no_viewport=True,
        channel='chrome',  # 使用系統(tǒng)Chrome
    )
    context.set_default_timeout(TIMEOUT)
    yield context
    context.close()

# 檢查版本
python -m playwright --version

# 檢查瀏覽器路徑
python -m playwright show-browser-path

# 驗(yàn)證瀏覽器可用
python -c "from playwright.sync_api import sync_playwright; p = sync_playwright().start(); b = p.chromium.launch(); print('Chromium 可用 ?'); b.close(); p.stop()"

# 方式1：直接打開(kāi)項(xiàng)目目錄
# 菜單 File → Open Folder → 選擇項(xiàng)目目錄

# 方式2：命令行打開(kāi)
code .

1. 按 Ctrl+Shift+P 打開(kāi)命令面板
2. 輸入 "Python: Select Interpreter"
3. 選擇項(xiàng)目虛擬環(huán)境中的Python
   路徑類似：項(xiàng)目路徑\venv\Scripts\python.exe

{
    "python.testing.pytestEnabled": true,
    "python.testing.pytestArgs": [
        "tests",
        "-v",
        "--tb=short"
    ],
    "python.testing.unittestEnabled": false,
    "[python]": {
        "editor.defaultFormatter": "charliermarsh.ruff",
        "editor.formatOnSave": true
    }
}

1. 登錄 Trae 賬號(hào)
2. 設(shè)置 → AI → 選擇模型
3. 可選模型：
   - Claude
   - GPT-4
   - Gemini

# OpenAI配置
OPENAI_API_KEY=sk-xxxxx
OPENAI_API_BASE=https://api.openai.com/v1
# Anthropic配置（Claude）
ANTHROPIC_API_KEY=sk-ant-xxxxx
# 國(guó)內(nèi)代理（如果需要）
HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890

# 提示詞示例
"""
請(qǐng)幫我為這個(gè)登錄頁(yè)面寫測(cè)試用例：
頁(yè)面包含：
- 用戶名輸入框
- 密碼輸入框
- 登錄按鈕
- 記住登錄復(fù)選框
請(qǐng)生成：
1. Page Object類結(jié)構(gòu)
2. 正常登錄測(cè)試
3. 錯(cuò)誤密碼測(cè)試
4. 空用戶名測(cè)試
"""

# 當(dāng)測(cè)試失敗時(shí)，讓AI分析
"""
測(cè)試失敗了，日志顯示：
- 錯(cuò)誤：ElementClickInterceptedException
- 截圖已保存
頁(yè)面結(jié)構(gòu)可能發(fā)生了變化，請(qǐng)分析：
1. 可能的原因？
2. 如何修改選擇器？
3. 如何添加重試邏輯？
"""

# utils/ai_logger.py
from openai import OpenAI
import os

class AILogger:
    def __init__(self):
        self.client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))

    def analyze_error(self, error_info: str, screenshot_path: str = None) -> str:
        """使用AI分析測(cè)試錯(cuò)誤"""
        prompt = f"""
        測(cè)試自動(dòng)化執(zhí)行遇到錯(cuò)誤：

        錯(cuò)誤信息：
        {error_info}

        請(qǐng)分析：
        1. 最可能的原因？
        2. 解決方案建議？
        3. 如何避免類似問(wèn)題？
        """

        response = self.client.chat.completions.create(
            model="gpt-4",
            messages=[{"role": "user", "content": prompt}]
        )

        return response.choices[0].message.content

auto_ui/
├── config/                 # 配置目錄
│   ├── __init__.py
│   ├── settings.py       # Python配置
│   └── config.yaml      # YAML配置
├── pages/                # 頁(yè)面對(duì)象
│   ├── __init__.py
│   ├── base_page.py
│   └── login_page.py
├── tests/                # 測(cè)試用例
│   ├── __init__.py
│   └── test_*.py
├── utils/               # 工具函數(shù)
│   ├── __init__.py
│   ├── logger.py
│   └── decorators.py
├── conftest.py          # pytest配置
├── pytest.ini           # pytest設(shè)置
└── requirements.txt     # 依賴清單

# config/config.yaml
base_url: "https://test.example.com"
timeout: 30000
headless: false
browser: "chromium"
wait_timeouts:
  short: 2000
  medium: 3000
  long: 5000
  page_load: 30000
reports:
  output_dir: "reports"
  logs_dir: "logs"
  screenshots_dir: "screenshots"
test_user:
  username: "test@example.com"
  password: "password123"

# config/settings.py
import os
import yaml
from pathlib import Path

BASE_DIR = Path(__file__).parent.parent

# 加載YAML配置
CONFIG_FILE = BASE_DIR / "config" / "config.yaml"

with open(CONFIG_FILE, "r", encoding="utf-8") as f:
    _config = yaml.safe_load(f)

# 配置項(xiàng)
BASE_URL = _config.get("base_url")
TIMEOUT = _config.get("timeout", 30000)
HEADLESS = _config.get("headless", False)
BROWSER = _config.get("browser", "chromium")

# pytest.ini
[pytest]
testpaths = tests
python_files = test_*.py
python_classes = Test*
python_functions = test_*
addopts =
    -v
    --tb=short
    --strict-markers
    --html=reports/report.html
    --self-contained-html
markers =
    ui: UI自動(dòng)化測(cè)試
    smoke: 冒煙測(cè)試
    regression: 回歸測(cè)試

# conftest.py
import pytest
from playwright.sync_api import sync_playwright
from config.settings import *

@pytest.fixture(scope="session")
def browser_type_launch_args(browser_type_launch_args):
    return {
        **browser_type_launch_args,
        "headless": HEADLESS,
        "slow_mo": SLOW_MO,
        "args": ["--start-maximized"],
    }

@pytest.fixture(scope="function")
def browser_context(browser):
    context = browser.new_context(no_viewport=True)
    context.set_default_timeout(TIMEOUT)
    yield context
    context.close()

@pytest.fixture(scope="function")
def page(browser_context):
    page = browser_context.new_page()
    page.set_default_timeout(TIMEOUT)
    # 窗口最大化
    page.evaluate("""
        window.moveTo(0, 0);
        window.resizeTo(window.screen.availWidth, window.screen.availHeight);
    """)
    yield page
    page.close()

# 方案1：使用代理
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
python -m playwright install chromium

# 方案2：使用系統(tǒng)Chrome（跳過(guò)下載）
# 修改conftest.py，添加 channel='chrome'

# 方案1：以管理員身份運(yùn)行
# 右鍵PowerShell → 以管理員身份運(yùn)行

# 方案2：清理后重試
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\ms-playwright"
python -m playwright install chromium

# 檢查依賴
python -m playwright install-deps

# 或者手動(dòng)安裝Visual C++ Redistributable

# 增加超時(shí)時(shí)間
page.set_default_timeout(60000)  # 60秒

# 或在配置中修改
TIMEOUT = 60000

# 添加等待
page.wait_for_load_state("networkidle")

# 或顯式等待
page.wait_for_selector(".element", timeout=5000)

# 確保目錄存在
import os
os.makedirs("screenshots", exist_ok=True)

# 保存截圖
page.screenshot(path="screenshots/error.png")

# 檢查API Key是否正確
echo $OPENAI_API_KEY

# 檢查網(wǎng)絡(luò)連接
curl https://api.openai.com/v1/models

# 添加超時(shí)設(shè)置
response = self.client.chat.completions.create(
    model="gpt-4",
    messages=messages,
    timeout=30  # 30秒超時(shí)
)

# 安裝腳本
Write-Host "開(kāi)始安裝 Playwright 測(cè)試環(huán)境..." -ForegroundColor Cyan

# 1. 創(chuàng)建虛擬環(huán)境
python -m venv venv
.\venv\Scripts\activate

# 2. 安裝依賴
pip install -r requirements.txt

# 3. 安裝瀏覽器
python -m playwright install chromium

# 4. 驗(yàn)證安裝
python -c "from playwright.sync_api import sync_playwright; print('安裝成功 ?')"

Write-Host "環(huán)境安裝完成！" -ForegroundColor Green

# 激活環(huán)境
.\venv\Scripts\activate

# 運(yùn)行測(cè)試
pytest tests/ -v

# 只運(yùn)行冒煙測(cè)試
pytest -m smoke -v

# 生成HTML報(bào)告
pytest --html=reports/report.html --self-contained-html

1. 打開(kāi)項(xiàng)目
2. 按 Ctrl+Shift+P
3. 輸入 "Python: Run All Tests"
4. 查看測(cè)試結(jié)果