┌──────────────────────────────────────────────────────────┐
│  browser-test MCP（单进程，59 个工具）                      │
│                                                            │
│  AI 层：browser-use（官方代码原封不动，16 个工具）           │
│    browser_navigate / browser_click / browser_type /       │
│    browser_get_state / retry_with_browser_use_agent ...    │
│  ──────────────────────────────────────────────────────── │
│  精确层：playwright-python（官方 API 薄封装，43 个工具）     │
│    pw_navigate / pw_fill / pw_click / pw_assert_*          │
│    pw_wait_* / pw_screenshot / pw_network / pw_trace ...   │
│  ──────────────────────────────────────────────────────── │
│  共享会话：playwright 启动 chromium（CDP 调试端口）          │
│  browser-use 通过 cdp_url 连接同一浏览器实例                 │
└──────────────────────────────────────────────────────────┘

Reasonix 对话 A ──► browser-test server 进程 A ──► chromium A（CDP 端口: pid 偏移 + 探测）
Reasonix 对话 B ──► browser-test server 进程 B ──► chromium B（CDP 端口: pid 偏移 + 探测）
        │                    │                              │
        └── 各自独立：CDP 端口 / browser-use 数据目录 / 页面会话

pip install -r requirements.txt
playwright install chromium        # 首次下载浏览器（可选：channel=chrome 用系统 Chrome）
python server.py                   # 直接跑（stdio 模式）

// Claude Desktop / Cursor / Reasonix 等
{
  "mcpServers": {
    "browser-test": {
      "command": "python",
      "args": ["/path/to/browser-test-mcp/server.py"],
      "env": {
        "OPENAI_API_KEY": "sk-...",                    // AI 层 Agent 需要（可选）
        "OPENAI_BASE_URL": "https://api.deepseek.com", // OpenAI 兼容 provider（可选）
        "BROWSER_USE_LLM_MODEL": "deepseek-v4-flash",  // AI 层模型（可选）
        "BROWSER_TEST_HEADLESS": "1"                    // 1=无头（默认）0=有头
      }
    }
  }
}

PYTHONIOENCODING=utf-8 python test_smoke.py   # 59 工具 + 共享会话验证
python test_fusion.py                          # 两层交叉操作验证

1. pw_navigate(url)                 打开被测页面
2. pw_wait_for_selector / pw_assert_url   确认页面就绪
3. pw_fill(selector, value)         填表单
4. pw_click(selector)               触发交互
5. pw_wait_for_response / pw_wait_for_url 等待结果（接口/跳转）
6. pw_assert_text / pw_assert_*     断言，记录 PASS/FAIL
7. pw_screenshot                    留证
8. pw_close_browser                 清理

browser-test-mcp/
├── server.py          # MCP stdio 入口
├── fusion_server.py   # 融合层：官方 AI 层工具 + 精确层工具合并
├── pw_bridge.py       # Playwright 精确层（43 工具 + 浏览器生命周期）
├── stealth.py         # 自研反检测模块
├── requirements.txt
├── skill/SKILL.md     # Reasonix skill 手册
├── test_smoke.py      # stdio 冒烟测试（59 工具 + 共享会话断言，CI 使用）
└── test_fusion.py     # 两层交叉操作测试