v10.1: 蓝本自动生成+Preview服务器+MCP工具+插件更新+932测试

Author: zcj220

.cursorrules

@@ -0,0 +1,13 @@
+# TestPilot AI - 项目编码规范
+
+## 蓝本文件（testpilot.json）管理规则
+
+当你需要为某个被测应用生成或修改测试蓝本时，**必须遵守以下规则**：
+
+1. **只允许存在一个蓝本文件**：每个被测应用目录下只保留一个 `testpilot.json`。
+2. **更新而非新建**：若该目录已存在 `testpilot.json`，直接覆盖更新，**不得**创建 `testpilot_v2.json`、`testpilot_new.json`、`testpilot_backup.json` 等任何变体文件。
+3. **文件放置位置**：蓝本文件必须放在被测应用的**根目录**，固定命名为 `testpilot.json`。
+   - ✅ 正确：`shop-demo/testpilot.json`
+   - ❌ 错误：`shop-demo/testpilot_v2.json`、`shop-demo/blueprints/test.json`
+
+这样 TestPilot AI 插件才能自动扫描并选中正确的蓝本。

.env.example

@@ -0,0 +1,29 @@
+# TestPilot AI 环境变量配置
+# 复制此文件为 .env 并填入实际值
+
+# ── 服务配置 ──
+TP_SERVER_HOST=127.0.0.1
+TP_SERVER_PORT=8900
+TP_SERVER_RELOAD=true
+TP_SERVER_LOG_LEVEL=DEBUG
+
+# ── 沙箱配置 ──
+TP_SANDBOX_IMAGE=ghcr.io/agent-infra/sandbox:latest
+TP_SANDBOX_APP_PORT=3000
+
+# ── 浏览器配置 ──
+TP_BROWSER_HEADLESS=true
+TP_BROWSER_VIEWPORT_WIDTH=1280
+TP_BROWSER_VIEWPORT_HEIGHT=720
+
+# ── AI API 配置（必填） ──
+# 方舟平台 API 密钥（通过 OpenAI SDK 兼容接口调用）
+TP_AI_API_KEY=你的方舟平台API密钥
+TP_AI_API_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
+# Doubao-Seed-1.8 统一模型（文本生成 + 视觉理解 + Agent）
+TP_AI_MODEL=doubao-seed-1-8-251228
+# 思考深度：minimal / low / medium / high
+TP_AI_REASONING_EFFORT=medium
+
+# ── 调试模式 ──
+DEBUG=false

.github/copilot-instructions.md

@@ -0,0 +1,69 @@
+# TestPilot AI - 项目编码规范
+
+## 蓝本文件（testpilot.json）管理规则
+
+当你需要为某个被测应用生成或修改测试蓝本时，**必须遵守以下规则**：
+
+1. **只允许存在一个蓝本文件**：每个被测应用目录下只保留一个 `testpilot.json`。
+2. **更新而非新建**：若该目录已存在 `testpilot.json`，直接覆盖更新，**不得**创建 `testpilot_v2.json`、`testpilot_new.json`、`testpilot_backup.json` 等任何变体文件。
+3. **文件放置位置**：蓝本文件必须放在被测应用的**根目录**，固定命名为 `testpilot.json`。
+   - ✅ 正确：`shop-demo/testpilot.json`
+   - ❌ 错误：`shop-demo/testpilot_v2.json`、`shop-demo/blueprints/test.json`
+
+这样 TestPilot AI 插件才能自动扫描并选中正确的蓝本。
+
+## 编程完成后必须生成/更新蓝本
+
+**每次完成编程任务后，你必须同时生成或更新被测应用的 `testpilot.json`**。
+
+这是因为你是最了解自己代码的人——你知道每个元素的 ID、class、功能逻辑，你生成的蓝本最精准、覆盖最全面。
+
+### 蓝本生成时机
+
+- ✅ **新建应用**：代码写完后，立即生成完整 `testpilot.json`
+- ✅ **修改功能**：新增/修改/删除任何 UI 元素或业务逻辑后，同步更新蓝本对应场景和选择器
+- ✅ **修复 Bug 后**：确认代码修复正确，更新蓝本中对应的 expected 断言
+- ❌ **不允许跳过**：不得以"稍后再写"为由跳过蓝本生成
+
+### 蓝本质量要求
+
+生成蓝本时，遵守以下规则：
+
+1. **功能全覆盖**：每个可操作的功能（按钮/表单/导航/弹窗）必须有对应场景
+2. **使用精确选择器**：直接使用代码中的 `id`（`#login-btn`）或稳定 `class`，不要用 `div:nth-child(3)` 这类脆弱选择器
+3. **逐字段断言**：`fill` 之后要有 `assert_text` 或 `screenshot` 验证，不能只操作不验证
+4. **边界场景**：包含空表单提交、错误输入、权限不足等异常场景
+5. **页面跳转显式化**：每次 `navigate` 必须有对应的 `assert_text` 或 `screenshot` 验证页面已正确加载
+
+### 快速生成模板
+
+```json
+{
+  "app_name": "你的应用名",
+  "base_url": "http://localhost:你的端口",
+  "version": "1.0",
+  "pages": [
+    {
+      "url": "/",
+      "title": "页面标题",
+      "elements": {
+        "元素描述": "#实际CSS选择器"
+      },
+      "scenarios": [
+        {
+          "name": "功能场景名",
+          "steps": [
+            {"action": "navigate", "value": "http://localhost:端口"},
+            {"action": "fill", "target": "#input-id", "value": "测试值"},
+            {"action": "click", "target": "#submit-btn"},
+            {"action": "assert_text", "target": "#result", "expected": "预期文本"}
+          ]
+        }
+      ]
+    }
+  ]
+}
+```
+
+支持的 action：`navigate` / `click` / `fill` / `select` / `wait` / `screenshot` / `assert_text` / `assert_visible` / `hover` / `scroll`
+

.github/workflows/test.yml

@@ -0,0 +1,36 @@
+name: TestPilot AI Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install Poetry
+        run: |
+          pip install "poetry>=2.0,<3.0"
+          poetry --version
+
+      - name: Install dependencies
+        run: |
+          poetry config virtualenvs.in-project true
+          poetry install --with dev -v
+
+      - name: Run tests
+        run: poetry run pytest -x -q --tb=long 2>&1 | tail -80
+        env:
+          OPENAI_API_KEY: "sk-test-placeholder"
+          TESTPILOT_ENV: "ci"

.gitignore

@@ -0,0 +1,55 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+*.egg
+
+# 虚拟环境
+.venv/
+venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# 环境变量（含密钥，绝不提交）
+.env
+
+# 日志
+logs/
+
+# 数据文件（截图、录屏等）
+data/
+screenshots/
+
+# 系统文件
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Poetry
+poetry.toml
+
+# Playwright
+playwright-report/
+test-results/
+
+# VSCode Extension
+extension/node_modules/
+extension/out/
+extension/*.vsix
+
+# Desktop App (React + Vite)
+desktop/node_modules/
+desktop/dist/
+
+# Tauri (Rust桌面应用)
+desktop/src-tauri/target/

Dockerfile

@@ -0,0 +1,40 @@
+# TestPilot AI CI Runner 镜像（v4.0）
+#
+# 用途：CI/CD 环境中运行 TestPilot AI 测试
+#
+# 构建：docker build -t testpilot/runner .
+# 使用：docker run --rm -v ./testpilot.json:/app/blueprint.json testpilot/runner run -b /app/blueprint.json
+#
+
+FROM python:3.11-slim
+
+# 安装系统依赖（Playwright 需要）
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# 安装 Poetry
+RUN pip install --no-cache-dir poetry
+
+WORKDIR /app
+
+# 复制依赖文件
+COPY pyproject.toml poetry.lock* ./
+
+# 安装 Python 依赖
+RUN poetry config virtualenvs.create false \
+    && poetry install --no-interaction --no-root
+
+# 安装 Playwright 浏览器
+RUN playwright install chromium \
+    && playwright install-deps chromium
+
+# 复制项目文件
+COPY . .
+
+# 暴露引擎端口
+EXPOSE 8900
+
+# 默认命令：启动引擎
+ENTRYPOINT ["python", "cli.py"]
+CMD ["serve", "--host", "0.0.0.0"]