feat(pyinstaller): M1 - PyInstaller 单文件打包，本地验证通过

- config.py: 新增 BUNDLE_DIR 常量，用 sys.frozen 检测 PyInstaller 环境
  PROJECT_ROOT 打包后指向 exe 所在目录（用户数据），
  BUNDLE_DIR 打包后指向 sys._MEIPASS（代码资源）
- app.py: 导入 PROJECT_ROOT 替换 3 处 Path(__file__)
- routes.py: 导入 PROJECT_ROOT + BUNDLE_DIR 替换 3 处 Path(__file__)
- miniprogram.py: 导入 BUNDLE_DIR 替换 bridge_server 路径
- main.py: frozen 模式传入 app 对象而非字符串，避免动态导入失败
- testpilot_engine.spec: 新增打包配置，含 playwright/driver、alembic、
  小程序 JS 脚本

验证结果: dist/testpilot-engine.exe (62.8MB) 正常启动
  数据库同步  服务绑定 8900  /api/v1/health 返回 healthy

Author: zcj220

main.py

@@ -7,6 +7,8 @@
     poetry run uvicorn src.app:app --reload
 """
 
+import sys
+
 import uvicorn
 
 from src.core.config import get_config
@@ -15,13 +17,26 @@
 def main() -> None:
     """启动 TestPilot AI 核心引擎服务。"""
     config = get_config()
-    uvicorn.run(
-        "src.app:app",
-        host=config.server.host,
-        port=config.server.port,
-        reload=config.server.reload,
-        log_level=config.server.log_level.lower(),
-    )
+
+    if getattr(sys, "frozen", False):
+        # PyInstaller 打包模式：必须传入 app 对象，不支持字符串动态导入
+        from src.app import app as _app
+        uvicorn.run(
+            _app,
+            host=config.server.host,
+            port=config.server.port,
+            reload=False,
+            log_level=config.server.log_level.lower(),
+        )
+    else:
+        # 开发模式：字符串方式支持 --reload 热重载
+        uvicorn.run(
+            "src.app:app",
+            host=config.server.host,
+            port=config.server.port,
+            reload=config.server.reload,
+            log_level=config.server.log_level.lower(),
+        )
 
 
 if __name__ == "__main__":

src/api/routes.py

@@ -40,6 +40,7 @@
 from src.api.websocket import ws_manager
 from src.browser.automator import BrowserAutomator
 from src.core.ai_client import AIClient
+from src.core.config import BUNDLE_DIR, PROJECT_ROOT
 from src.core.exceptions import BrowserError, SandboxError
 from src.memory.store import MemoryStore
 from src.sandbox.manager import SandboxManager
@@ -85,7 +86,7 @@ def _auto_preview_url(base_url: str, blueprint_path: str) -> str:
     # 端口不可达 → 看蓝本所在目录是否在工作区中
     bp_path = Path(blueprint_path).resolve()
     app_dir = bp_path.parent
-    project_root = Path(__file__).resolve().parent.parent.parent
+    project_root = PROJECT_ROOT
 
     # 确保是工作区子目录且含 index.html
     try:
@@ -148,7 +149,7 @@ async def list_preview_apps() -> list[dict]:
         from src.core.config import get_config
         cfg = get_config()
         port = cfg.server.port
-        root = Path(__file__).resolve().parent.parent.parent
+        root = PROJECT_ROOT
         apps = []
         for child in sorted(root.iterdir()):
             if not child.is_dir():
@@ -886,7 +887,7 @@ async def run_miniprogram_blueprint_test(req: dict) -> TestReportResponse:
             tmp_file.write_text(json.dumps(runner_input, ensure_ascii=False), encoding="utf-8")
 
             # 调用Node.js执行器（跟run_blind_test.js一样的逻辑）
-            runner_script = Path(__file__).parent.parent / "controller" / "miniprogram_runner.js"
+            runner_script = BUNDLE_DIR / "controller" / "miniprogram_runner.js"
             if not runner_script.exists():
                 raise RuntimeError(f"执行器脚本不存在: {runner_script}")
 

src/app.py

@@ -15,6 +15,7 @@
 
 from src import __app_name__, __version__
 from src.api.routes import create_router
+from src.core.config import PROJECT_ROOT
 from src.api.websocket import ws_manager
 from src.browser.automator import BrowserAutomator
 from src.core.ai_client import AIClient
@@ -116,7 +117,7 @@ async def websocket_endpoint(ws: WebSocket) -> None:
     #   /preview/{dirname}/  →  对应目录的静态文件
     # 这样用户不需要手动启动 http-server，一键启动引擎即可测试
 
-    project_root = Path(__file__).resolve().parent.parent
+    project_root = PROJECT_ROOT
     _preview_dirs: dict[str, Path] = {}
 
     # 扫描第一层子目录中含蓝本的目录（支持 testpilot.json 或 testpilot/ 子目录）
@@ -179,8 +180,8 @@ async def serve_preview(app_name: str, file_path: str):
 
     # v13.0: 社区门户 / v2.0: Web仪表盘 静态文件服务
     # 优先使用 web/dist（社区门户），回退到 desktop/dist（旧仪表盘）
-    community_dist = Path(__file__).resolve().parent.parent / "web" / "dist"
-    dashboard_dist = Path(__file__).resolve().parent.parent / "desktop" / "dist"
+    community_dist = PROJECT_ROOT / "web" / "dist"
+    dashboard_dist = PROJECT_ROOT / "desktop" / "dist"
     spa_dist = community_dist if community_dist.is_dir() else dashboard_dist
 
     if spa_dist.is_dir():

src/controller/miniprogram.py

@@ -27,6 +27,7 @@
 from loguru import logger
 
 from src.controller.base import BaseController, DeviceInfo, Platform
+from src.core.config import BUNDLE_DIR
 
 
 class MiniProgramConfig:
@@ -174,7 +175,7 @@ async def launch(self) -> None:
         logger.info("启动桥接服务器（v9.0自包含模式）")
         logger.info("项目: {} | WS端口: {} | HTTP端口: {}", project_path, ws_port, self._http_port)
 
-        bridge_server = Path(__file__).parent / "miniprogram_bridge_server.js"
+        bridge_server = BUNDLE_DIR / "controller" / "miniprogram_bridge_server.js"
         if not bridge_server.exists():
             raise RuntimeError(f"桥接服务器脚本不存在: {bridge_server}")
 

src/core/config.py

@@ -5,15 +5,25 @@
 所有敏感信息（API密钥等）通过环境变量注入，绝不硬编码。
 """
 
+import sys
 from pathlib import Path
 from typing import Optional
 
 from pydantic import Field
 from pydantic_settings import BaseSettings, SettingsConfigDict
 
 
-# 项目根目录（pyproject.toml 所在目录）
-PROJECT_ROOT = Path(__file__).resolve().parent.parent.parent
+# ── PyInstaller 兼容路径 ─────────────────────────────────────────────────────
+# 打包后 __file__ 指向临时解压目录，需用不同基准：
+#   PROJECT_ROOT  → exe 旁边的目录（用户数据：.env、data/、logs/）
+#   BUNDLE_DIR    → 临时解压目录（代码文件：JS 脚本等打包资源）
+if getattr(sys, "frozen", False):
+    PROJECT_ROOT = Path(sys.executable).parent
+    BUNDLE_DIR: Path = Path(sys._MEIPASS)  # type: ignore[attr-defined]
+else:
+    PROJECT_ROOT = Path(__file__).resolve().parent.parent.parent
+    BUNDLE_DIR = PROJECT_ROOT
+# ─────────────────────────────────────────────────────────────────────────────
 
 
 class ServerConfig(BaseSettings):

testpilot_engine.spec

@@ -0,0 +1,122 @@
+# -*- mode: python ; coding: utf-8 -*-
+"""
+TestPilot AI 引擎打包配置
+用法: poetry run pyinstaller testpilot_engine.spec
+"""
+
+import os
+import sys
+from pathlib import Path
+
+# ── 基本路径 ──────────────────────────────────────────────────
+project_dir = Path(SPECPATH)
+venv_site_packages = project_dir / '.venv' / 'lib' / 'site-packages'
+
+# ── 需要随二进制一起携带的数据目录 ────────────────────────────
+datas = [
+    # playwright driver（含 node.exe 和 package/）
+    (str(venv_site_packages / 'playwright' / 'driver'), 'playwright/driver'),
+    # alembic 迁移脚本（数据库升级用）
+    (str(project_dir / 'alembic'), 'alembic'),
+    # alembic.ini
+    (str(project_dir / 'alembic.ini'), '.'),
+    # 小程序 JS 脚本（BUNDLE_DIR/controller/ 下可找到）
+    (str(project_dir / 'src' / 'controller' / 'miniprogram_runner.js'), 'controller'),
+    (str(project_dir / 'src' / 'controller' / 'miniprogram_bridge_server.js'), 'controller'),
+]
+
+# ── 隐式导入（动态加载的模块，分析器找不到）────────────────────
+hiddenimports = [
+    # FastAPI / Starlette
+    'uvicorn.logging',
+    'uvicorn.loops',
+    'uvicorn.loops.auto',
+    'uvicorn.loops.asyncio',
+    'uvicorn.loops.uvloop',
+    'uvicorn.protocols',
+    'uvicorn.protocols.http',
+    'uvicorn.protocols.http.auto',
+    'uvicorn.protocols.http.h11_impl',
+    'uvicorn.protocols.http.httptools_impl',
+    'uvicorn.protocols.websockets',
+    'uvicorn.protocols.websockets.auto',
+    'uvicorn.protocols.websockets.websockets_impl',
+    'uvicorn.protocols.websockets.wsproto_impl',
+    'uvicorn.lifespan',
+    'uvicorn.lifespan.on',
+    'uvicorn.lifespan.off',
+    'starlette.routing',
+    'starlette.middleware',
+    'starlette.middleware.cors',
+    # Playwright
+    'playwright',
+    'playwright.sync_api',
+    'playwright.async_api',
+    # SQLAlchemy
+    'sqlalchemy.dialects.sqlite',
+    # jose
+    'jose',
+    'jose.jwt',
+    # multipart
+    'multipart',
+    # email_validator (fastapi opt-dep)
+    'email_validator',
+    # passlib
+    'passlib.handlers.bcrypt',
+    'passlib.handlers.sha2_crypt',
+    # websockets
+    'websockets',
+    'websockets.legacy',
+    'websockets.legacy.server',
+]
+
+a = Analysis(
+    ['main.py'],
+    pathex=[str(project_dir)],
+    binaries=[],
+    datas=datas,
+    hiddenimports=hiddenimports,
+    hookspath=[],
+    hooksconfig={},
+    runtime_hooks=[],
+    excludes=[
+        # 排除用不到的大型包，减小体积
+        'tkinter',
+        'matplotlib',
+        'numpy',
+        'pandas',
+        'scipy',
+        'PIL',
+        'IPython',
+        'notebook',
+        'pytest',
+        'sphinx',
+    ],
+    noarchive=False,
+    optimize=0,
+)
+
+pyz = PYZ(a.pure)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.datas,
+    [],
+    name='testpilot-engine',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=False,         # UPX 压缩在某些杀毒软件中会误报，关闭
+    upx_exclude=[],
+    runtime_tmpdir=None,
+    console=True,      # 保留控制台，方便用户看启动日志
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=None,
+    entitlements_file=None,
+    # 图标（可选，后续替换为实际 .ico 文件）
+    # icon='resources/icon.ico',
+)