v10.2: start_command自动启动应用+预览服务器适配testpilot/目录+提示词更新(947 passed)

Author: zcj220

extension/src/sidebarProvider.ts

@@ -359,12 +359,13 @@ export class SidebarProvider implements vscode.WebviewViewProvider {
   }
 
   private async _handleCopyBlueprintPrompt(): Promise<void> {
-    const prompt = `请帮我为当前项目生成 testpilot.json 测试蓝本文件，放在项目根目录。要求：
+    const prompt = `请帮我为当前项目生成 testpilot.json 测试蓝本文件，放在项目的 testpilot/ 文件夹下。要求：
 1. 分析源代码中所有可操作 UI 元素（按钮/表单/导航/弹窗）
 2. 选择器使用代码中的真实 id（如 #login-btn）或稳定 class，禁止用 div:nth-child(3) 这类脆弱选择器
 3. 每个功能页面对应一个场景，覆盖正常流程和异常场景（空表单提交、错误输入）
 4. 每个 fill 操作后必须有 assert_text 或 screenshot 验证
 5. 每次 navigate 必须有断言验证页面已正确加载
+6. 如果应用需要命令行启动（如 npm start、python app.py），必须填写 start_command 字段；纯HTML静态应用留空即可
 
 格式：
 {
@@ -373,6 +374,8 @@ export class SidebarProvider implements vscode.WebviewViewProvider {
   "base_url": "http://localhost:端口",
   "version": "1.0",
   "platform": "web",
+  "start_command": "npm start 或 python app.py（纯HTML留空）",
+  "start_cwd": "./（启动命令的工作目录，默认项目根目录）",
   "pages": [
     {
       "url": "/",

src/api/routes.py

@@ -151,12 +151,18 @@ async def list_preview_apps() -> list[dict]:
         root = Path(__file__).resolve().parent.parent.parent
         apps = []
         for child in sorted(root.iterdir()):
+            if not child.is_dir():
+                continue
             bp_file = child / "testpilot.json"
-            if child.is_dir() and bp_file.exists():
+            tp_dir = child / "testpilot"
+            has_bp = bp_file.exists()
+            if not has_bp and tp_dir.is_dir():
+                has_bp = any(tp_dir.glob("*.json"))
+            if has_bp:
                 apps.append({
                     "name": child.name,
                     "path": str(child),
-                    "blueprint": str(bp_file),
+                    "blueprint_dir": str(tp_dir) if tp_dir.is_dir() else str(bp_file.parent),
                     "preview_url": f"http://localhost:{port}/preview/{child.name}/",
                 })
         return apps

src/app.py

@@ -113,9 +113,15 @@ async def websocket_endpoint(ws: WebSocket) -> None:
     project_root = Path(__file__).resolve().parent.parent
     _preview_dirs: dict[str, Path] = {}
 
-    # 扫描第一层子目录中的 testpilot.json
+    # 扫描第一层子目录中含蓝本的目录（支持 testpilot.json 或 testpilot/ 子目录）
     for child in project_root.iterdir():
-        if child.is_dir() and (child / "testpilot.json").exists():
+        if not child.is_dir():
+            continue
+        has_bp = (child / "testpilot.json").exists()
+        tp_dir = child / "testpilot"
+        if not has_bp and tp_dir.is_dir():
+            has_bp = any(tp_dir.glob("*.json"))
+        if has_bp:
             _preview_dirs[child.name] = child
 
     if _preview_dirs:

src/testing/blueprint.py

@@ -60,6 +60,8 @@ class Blueprint(BaseModel):
     pages: list[BlueprintPage] = Field(default_factory=list, description="页面列表")
     global_elements: dict[str, str] = Field(default_factory=dict, description="全局元素映射（所有页面共享）")
     permissions: list[str] = Field(default_factory=list, description="Android权限列表，launch时通过adb批量授权，如 android.permission.CAMERA")
+    start_command: str = Field(default="", description="应用启动命令（如 npm start / python app.py），纯HTML应用留空使用内置预览服务器")
+    start_cwd: str = Field(default="", description="启动命令的工作目录（相对于蓝本文件所在目录，默认为蓝本所在项目根目录）")
     app_package: str = Field(default="", description="Android应用包名（手机测试时用）")
     app_activity: str = Field(default="", description="Android启动Activity（手机测试时用）")
 

src/testing/blueprint_runner.py

@@ -96,6 +96,11 @@ async def run(
                      blueprint.total_steps,
                      "开启" if smart_repair_enabled else "关闭")
 
+        # v10.2：如果蓝本有 start_command，先启动被测应用并等待就绪
+        self._app_started_by_runner = False
+        if getattr(blueprint, "start_command", "") and blueprint.start_command.strip():
+            await self._auto_start_app(blueprint)
+
         # v2.0：通知控制器测试开始
         if self._controller:
             self._controller.start(total_steps=blueprint.total_steps)
@@ -638,3 +643,54 @@ def _generate_markdown(
         ])
 
         return "\n".join(lines)
+
+    # ── v10.2：自动启动被测应用 ────────────────────────
+
+    async def _auto_start_app(self, blueprint: Blueprint) -> None:
+        """根据蓝本中的 start_command 自动启动被测应用并等待就绪。"""
+        import urllib.request
+        import urllib.error
+        from pathlib import Path
+
+        cmd = blueprint.start_command.strip()
+        cwd = blueprint.start_cwd.strip() or "."
+        base_url = blueprint.base_url.strip()
+
+        logger.info("自动启动被测应用 | cmd={} | cwd={} | base_url={}", cmd, cwd, base_url)
+
+        # 先检查 base_url 是否已经可访问（应用可能已在运行）
+        if base_url and await self._check_url_ready(base_url):
+            logger.info("被测应用已在运行: {}", base_url)
+            return
+
+        # 通过 process_runner 启动应用
+        from src.testing.process_runner import process_runner
+        success = await process_runner.start(cmd, cwd)
+        if not success:
+            logger.warning("应用启动失败或已在运行: {}", cmd)
+            return
+
+        self._app_started_by_runner = True
+
+        # 等待 base_url 可访问（最多30秒）
+        if base_url:
+            logger.info("等待应用就绪: {}", base_url)
+            import asyncio
+            for i in range(30):
+                if await self._check_url_ready(base_url):
+                    logger.info("应用已就绪（等待{}秒）: {}", i + 1, base_url)
+                    return
+                await asyncio.sleep(1)
+            logger.warning("应用启动超时（30秒），继续测试: {}", base_url)
+
+    @staticmethod
+    async def _check_url_ready(url: str) -> bool:
+        """检查URL是否可访问。"""
+        import urllib.request
+        import urllib.error
+        try:
+            req = urllib.request.Request(url, method="HEAD")
+            with urllib.request.urlopen(req, timeout=2):
+                return True
+        except Exception:
+            return False