@ada-mcp/mcp-server 0.1.14 → 0.1.16

package/README.md

@@ -1,139 +1,139 @@
-# @ada-mcp/mcp-server
-
-ADA MCP server package that supports:
-
-- Local stdio mode (default) for MCP hosts
-- Remote HTTP mode (`server`) with API key authentication
-- MCP **Streamable HTTP** on `POST|GET|DELETE /mcp` (same port as legacy REST), with optional SSE per MCP spec (`@modelcontextprotocol/sdk` transport)
-
-## 标准安装（Cursor / MCP）
-
-请使用 **`@ada-mcp/launcher@0.1.11`** 拉起本包（见 [launcher README](../ada-mcp-launcher/README.md)）：
-
-```json
-{
-  "mcpServers": {
-    "ada-mcp": {
-      "command": "pnpm",
-      "args": ["dlx", "@ada-mcp/launcher@0.1.11"]
-    }
-  }
-}
-```
-
-本包版本：**`@ada-mcp/mcp-server@0.1.14`**（由 launcher 默认拉取；依赖锁定 `playwright@1.59.1`）。
-
-直接调试本包（无 launcher 拉包前测速）：
-
-```bash
-pnpm dlx @ada-mcp/mcp-server@0.1.14
-# npx 等价：
-npx -y @ada-mcp/mcp-server@0.1.14
-```
-
-## 启动时自动安装依赖（默认仅 Playwright）
-
-进程启动前会按配置自动执行 `install-deps`（日志在 stderr）：
-
-| 配置 | 含义 |
-|------|------|
-| （未配置） | 仅安装 **Playwright + 浏览器** |
-| `playwright` | 仅 Playwright（显式写法，与默认相同） |
-| `selenium` | **仅** Selenium 原生驱动（GeckoDriver/ChromeDriver） |
-| `appium` | **仅** Appium 包 + 移动端驱动 |
-| `playwright,selenium` | 组合（逗号连接多类） |
-| `all` | 上述全部 |
-| `none` / `skip` | 不自动安装 |
-
-**环境变量**
-
-- `ADA_MCP_INSTALL_DEPS`：范围，如 `playwright`、`playwright,selenium`、`all`、`none`
-- `ADA_MCP_SKIP_INSTALL_DEPS=1`：跳过自动安装
-- `ADA_MCP_INSTALL_DEPS_FORCE=1`：强制重装
-- `ADA_MCP_GECKODRIVER_VERSION` / `ADA_MCP_CHROMEDRIVER_VERSION`：Selenium 驱动版本
-- `ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS`：浏览器下载超时（默认 15 分钟）
-- `ADA_INSTALL_STRATEGY_TIMEOUT_MS`：npm 装包超时（默认 2 分钟）
-
-## 代理与镜像（`0.1.10+` 推荐）
-
-| 阶段 | 自动探测最快镜像 |
-|------|------------------|
-| `pnpm dlx @ada-mcp/launcher` | **是** — 拉包前测速（推荐） |
-| `pnpm dlx @ada-mcp/mcp-server` | tarball 仍走本机源；**同次安装的依赖**由 `preinstall` 测速（仅写入官方 Playwright CDN，`0.1.9+`） |
-| 启动后 `install-deps` | 是 — 内置国内镜像测速（**无需配置**） |
-
-默认 npm 探测候选（按优先级，延迟相同取靠前）：阿里云 npmmirror → 腾讯云 → 华为云 → npm 官方。
-
-| 变量 | 说明 |
-|------|------|
-| `npm_config_registry` | 可选；仅加速 **dlx** 拉包（推荐 `https://registry.npmmirror.com`） |
-| `ADA_REGISTRY_CANDIDATES` | 可选；在默认五镜像**之外**追加候选 |
-| `ADA_NPM_PROXY_REGISTRY` / `ADA_PNPM_PROXY_REGISTRY` | 可选；覆盖探测主候选（默认 npmmirror） |
-| `PLAYWRIGHT_DOWNLOAD_HOST` | 可选；Playwright 浏览器 CDN |
-
-详见 [ADA-MCP-接入手册 §3.9.2](../../docs/ADA-MCP-接入手册.md#392-代理与镜像配置)。
-
-**CLI 参数**（写在 MCP `args` 末尾）
-
-- `--install-deps=playwright,selenium`
-- `--skip-install-deps`
-- `--install-deps-force`
-- `--geckodriver-version=latest` `--chromedriver-version=match-chrome`
-
-在标准 `args` 后追加，例如安装全部依赖：
-
-```json
-"args": ["dlx", "@ada-mcp/launcher@0.1.11", "--install-deps=all"]
-```
-
-## Cursor MCP 配置
-
-**pnpm（推荐）**：`pnpm` + `dlx @ada-mcp/launcher@0.1.11`
-
-**npx 等价**（`launcher@0.1.7+`）：`npx` + `-y @ada-mcp/launcher@0.1.11`（内层同样 `npx -y` mcp-server，测速逻辑与 pnpm 一致）
-
-```json
-{
-  "mcpServers": {
-    "ada-mcp": {
-      "command": "npx",
-      "args": ["-y", "@ada-mcp/launcher@0.1.11"]
-    }
-  }
-}
-```
-
-Windows 若找不到 `pnpm`，可将 `command` 改为 `pnpm.cmd` 绝对路径；无 pnpm 时只能直接 `npx -y @ada-mcp/mcp-server@0.1.14`（无 launcher 拉包测速）。
-
-## Remote mode
-
-Set API key in environment variable first:
-
-```bash
-export ADA_MCP_REMOTE_API_KEY=your_token
-```
-
-Windows PowerShell:
-
-```powershell
-$env:ADA_MCP_REMOTE_API_KEY="your_token"
-```
-
-Then run:
-
-```bash
-pnpm dlx @ada-mcp/mcp-server server --host=127.0.0.1 --port=8787 --allow-risky=true --risky-mode=whitelist --risky-commands=custom
-```
-
-### Streamable HTTP (`/mcp`)
-
-- Endpoint: `http://<host>:<port>/mcp` — same API key headers as below (`x-api-key` or `Authorization: Bearer`).
-- First request: `POST /mcp` with JSON-RPC `initialize` (no `Mcp-Session-Id`); server returns a session id in `Mcp-Session-Id` response header.
-- Follow-up: `POST /mcp` with body + `Mcp-Session-Id`; for server-initiated streaming, open `GET /mcp` with `Accept: text/event-stream` and the same session header.
-- Session teardown: `DELETE /mcp` with `Mcp-Session-Id`.
-
-When listening on all interfaces (e.g. `--host=0.0.0.0`), set allowed Host headers to satisfy DNS rebinding checks:
-
-```bash
-pnpm dlx @ada-mcp/mcp-server server --host=0.0.0.0 --port=8787 --api-key=your_token --allowed-hosts=localhost,127.0.0.1
-```
+# @ada-mcp/mcp-server
+
+ADA MCP server package that supports:
+
+- Local stdio mode (default) for MCP hosts
+- Remote HTTP mode (`server`) with API key authentication
+- MCP **Streamable HTTP** on `POST|GET|DELETE /mcp` (same port as legacy REST), with optional SSE per MCP spec (`@modelcontextprotocol/sdk` transport)
+
+## 标准安装（Cursor / MCP）
+
+请使用 **`@ada-mcp/launcher@0.1.13`** 拉起本包（见 [launcher README](../ada-mcp-launcher/README.md)）：
+
+```json
+{
+  "mcpServers": {
+    "ada-mcp": {
+      "command": "pnpm",
+      "args": ["dlx", "@ada-mcp/launcher@0.1.13"]
+    }
+  }
+}
+```
+
+本包版本：**`@ada-mcp/mcp-server@0.1.16`**（由 launcher 默认拉取；依赖锁定 `playwright@1.59.1`）。
+
+直接调试本包（无 launcher 拉包前测速）：
+
+```bash
+pnpm dlx @ada-mcp/mcp-server@0.1.16
+# npx 等价：
+npx -y @ada-mcp/mcp-server@0.1.16
+```
+
+## 启动时自动安装依赖（默认仅 Playwright）
+
+进程启动前会按配置自动执行 `install-deps`（日志在 stderr）：
+
+| 配置 | 含义 |
+|------|------|
+| （未配置） | 仅安装 **Playwright + 浏览器** |
+| `playwright` | 仅 Playwright（显式写法，与默认相同） |
+| `selenium` | **仅** Selenium 原生驱动（GeckoDriver/ChromeDriver） |
+| `appium` | **仅** Appium 包 + 移动端驱动 |
+| `playwright,selenium` | 组合（逗号连接多类） |
+| `all` | 上述全部 |
+| `none` / `skip` | 不自动安装 |
+
+**环境变量**
+
+- `ADA_MCP_INSTALL_DEPS`：范围，如 `playwright`、`playwright,selenium`、`all`、`none`
+- `ADA_MCP_SKIP_INSTALL_DEPS=1`：跳过自动安装
+- `ADA_MCP_INSTALL_DEPS_FORCE=1`：强制重装
+- `ADA_MCP_GECKODRIVER_VERSION` / `ADA_MCP_CHROMEDRIVER_VERSION`：Selenium 驱动版本
+- `ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS`：浏览器下载超时（默认 15 分钟）
+- `ADA_INSTALL_STRATEGY_TIMEOUT_MS`：npm 装包超时（默认 2 分钟）
+
+## 代理与镜像（`0.1.10+` 推荐）
+
+| 阶段 | 自动探测最快镜像 |
+|------|------------------|
+| `pnpm dlx @ada-mcp/launcher` | **是** — 拉包前测速（推荐） |
+| `pnpm dlx @ada-mcp/mcp-server` | tarball 仍走本机源；**同次安装的依赖**由 `preinstall` 测速（仅写入官方 Playwright CDN，`0.1.9+`） |
+| 启动后 `install-deps` | 是 — 内置国内镜像测速（**无需配置**） |
+
+默认 npm 探测候选（按优先级，延迟相同取靠前）：阿里云 npmmirror → 腾讯云 → 华为云 → npm 官方。
+
+| 变量 | 说明 |
+|------|------|
+| `npm_config_registry` | 可选；仅加速 **dlx** 拉包（推荐 `https://registry.npmmirror.com`） |
+| `ADA_REGISTRY_CANDIDATES` | 可选；在默认五镜像**之外**追加候选 |
+| `ADA_NPM_PROXY_REGISTRY` / `ADA_PNPM_PROXY_REGISTRY` | 可选；覆盖探测主候选（默认 npmmirror） |
+| `PLAYWRIGHT_DOWNLOAD_HOST` | 可选；Playwright 浏览器 CDN |
+
+详见 [ADA-MCP-接入手册 §3.9.2](../../docs/ADA-MCP-接入手册.md#392-代理与镜像配置)。
+
+**CLI 参数**（写在 MCP `args` 末尾）
+
+- `--install-deps=playwright,selenium`
+- `--skip-install-deps`
+- `--install-deps-force`
+- `--geckodriver-version=latest` `--chromedriver-version=match-chrome`
+
+在标准 `args` 后追加，例如安装全部依赖：
+
+```json
+"args": ["dlx", "@ada-mcp/launcher@0.1.13", "--install-deps=all"]
+```
+
+## Cursor MCP 配置
+
+**pnpm（推荐）**：`pnpm` + `dlx @ada-mcp/launcher@0.1.13`
+
+**npx 等价**（`launcher@0.1.7+`）：`npx` + `-y @ada-mcp/launcher@0.1.13`（内层同样 `npx -y` mcp-server，测速逻辑与 pnpm 一致）
+
+```json
+{
+  "mcpServers": {
+    "ada-mcp": {
+      "command": "npx",
+      "args": ["-y", "@ada-mcp/launcher@0.1.13"]
+    }
+  }
+}
+```
+
+Windows 若找不到 `pnpm`，可将 `command` 改为 `pnpm.cmd` 绝对路径；无 pnpm 时只能直接 `npx -y @ada-mcp/mcp-server@0.1.16`（无 launcher 拉包测速）。
+
+## Remote mode
+
+Set API key in environment variable first:
+
+```bash
+export ADA_MCP_REMOTE_API_KEY=your_token
+```
+
+Windows PowerShell:
+
+```powershell
+$env:ADA_MCP_REMOTE_API_KEY="your_token"
+```
+
+Then run:
+
+```bash
+pnpm dlx @ada-mcp/mcp-server server --host=127.0.0.1 --port=8787 --allow-risky=true --risky-mode=whitelist --risky-commands=custom
+```
+
+### Streamable HTTP (`/mcp`)
+
+- Endpoint: `http://<host>:<port>/mcp` — same API key headers as below (`x-api-key` or `Authorization: Bearer`).
+- First request: `POST /mcp` with JSON-RPC `initialize` (no `Mcp-Session-Id`); server returns a session id in `Mcp-Session-Id` response header.
+- Follow-up: `POST /mcp` with body + `Mcp-Session-Id`; for server-initiated streaming, open `GET /mcp` with `Accept: text/event-stream` and the same session header.
+- Session teardown: `DELETE /mcp` with `Mcp-Session-Id`.
+
+When listening on all interfaces (e.g. `--host=0.0.0.0`), set allowed Host headers to satisfy DNS rebinding checks:
+
+```bash
+pnpm dlx @ada-mcp/mcp-server server --host=0.0.0.0 --port=8787 --api-key=your_token --allowed-hosts=localhost,127.0.0.1
+```

package/dist/cli.cjs

@@ -2887,7 +2887,7 @@ var init_config = __esm({
         ],
         nativeDriversDir: "dirver",
         geckodriverVersion: "latest",
-        chromedriverVersion: "latest"
+        chromedriverVersion: "match-chrome"
       },
       appium: {
         serverUrl: "http://127.0.0.1:4723",
@@ -3277,30 +3277,164 @@ async function resolveChromedriverCfTVersion(requested) {
   }
   return hit.version;
 }
-async function detectInstalledChromeMajorVersion() {
-  if (process.platform !== "win32") {
+function parseBrowserVersionString(raw) {
+  const match = raw.match(/(\d+\.\d+(?:\.\d+)*(?:\.\d+)?)/);
+  if (!match) {
     return void 0;
   }
-  const candidates = [
-    import_node_path4.default.join(process.env["ProgramFiles"] ?? "C:\\Program Files", "Google", "Chrome", "Application", "chrome.exe"),
-    import_node_path4.default.join(
-      process.env["ProgramFiles(x86)"] ?? "C:\\Program Files (x86)",
-      "Google",
-      "Chrome",
-      "Application",
-      "chrome.exe"
-    )
-  ];
-  for (const chromePath of candidates) {
-    if (!await fileExists(chromePath)) {
+  const version = match[1];
+  return { version, major: version.split(".")[0] };
+}
+async function runCommandCapture(command, args) {
+  return new Promise((resolve) => {
+    const child = (0, import_node_child_process.spawn)(command, args, {
+      stdio: ["ignore", "pipe", "ignore"],
+      shell: process.platform === "win32"
+    });
+    let out = "";
+    child.stdout?.on("data", (chunk) => {
+      out += chunk.toString("utf8");
+    });
+    child.on("exit", (code) => resolve(code === 0 ? out.trim() : void 0));
+    child.on("error", () => resolve(void 0));
+  });
+}
+async function detectChromeFromExecutable(exePath) {
+  if (!await fileExists(exePath)) {
+    return void 0;
+  }
+  if (process.platform === "win32") {
+    const version = await readWindowsFileVersion(exePath);
+    if (!version) {
+      return void 0;
+    }
+    const parsed2 = parseBrowserVersionString(version);
+    if (!parsed2) {
+      return void 0;
+    }
+    return { path: exePath, version: parsed2.version, major: parsed2.major };
+  }
+  const out = await runCommandCapture(exePath, ["--version"]);
+  if (!out) {
+    return void 0;
+  }
+  const parsed = parseBrowserVersionString(out);
+  if (!parsed) {
+    return void 0;
+  }
+  return { path: exePath, version: parsed.version, major: parsed.major };
+}
+async function detectFirefoxFromExecutable(exePath) {
+  if (!await fileExists(exePath)) {
+    return void 0;
+  }
+  if (process.platform === "win32") {
+    const version = await readWindowsFileVersion(exePath);
+    if (!version) {
+      return void 0;
+    }
+    const parsed2 = parseBrowserVersionString(version);
+    if (!parsed2) {
+      return void 0;
+    }
+    return { path: exePath, version: parsed2.version, major: parsed2.major };
+  }
+  const out = await runCommandCapture(exePath, ["--version"]);
+  if (!out) {
+    return void 0;
+  }
+  const parsed = parseBrowserVersionString(out);
+  if (!parsed) {
+    return void 0;
+  }
+  return { path: exePath, version: parsed.version, major: parsed.major };
+}
+async function detectLocalBrowsers() {
+  const result = {};
+  if (process.platform === "win32") {
+    const chromeCandidates = [
+      import_node_path4.default.join(process.env["ProgramFiles"] ?? "C:\\Program Files", "Google", "Chrome", "Application", "chrome.exe"),
+      import_node_path4.default.join(
+        process.env["ProgramFiles(x86)"] ?? "C:\\Program Files (x86)",
+        "Google",
+        "Chrome",
+        "Application",
+        "chrome.exe"
+      ),
+      import_node_path4.default.join(process.env["ProgramFiles"] ?? "C:\\Program Files", "Chromium", "Application", "chrome.exe")
+    ];
+    for (const p of chromeCandidates) {
+      const hit = await detectChromeFromExecutable(p);
+      if (hit) {
+        result.chrome = hit;
+        break;
+      }
+    }
+    const firefoxCandidates = [
+      import_node_path4.default.join(process.env["ProgramFiles"] ?? "C:\\Program Files", "Mozilla Firefox", "firefox.exe"),
+      import_node_path4.default.join(
+        process.env["ProgramFiles(x86)"] ?? "C:\\Program Files (x86)",
+        "Mozilla Firefox",
+        "firefox.exe"
+      )
+    ];
+    for (const p of firefoxCandidates) {
+      const hit = await detectFirefoxFromExecutable(p);
+      if (hit) {
+        result.firefox = hit;
+        break;
+      }
+    }
+    return result;
+  }
+  if (process.platform === "darwin") {
+    const chromePaths = [
+      "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+      "/Applications/Chromium.app/Contents/MacOS/Chromium"
+    ];
+    for (const p of chromePaths) {
+      const hit = await detectChromeFromExecutable(p);
+      if (hit) {
+        result.chrome = hit;
+        break;
+      }
+    }
+    const firefoxPath = "/Applications/Firefox.app/Contents/MacOS/firefox";
+    const ff = await detectFirefoxFromExecutable(firefoxPath);
+    if (ff) {
+      result.firefox = ff;
+    }
+    return result;
+  }
+  const chromeCommands = ["google-chrome-stable", "google-chrome", "chromium-browser", "chromium"];
+  for (const cmd of chromeCommands) {
+    if (!await commandOnPath(cmd)) {
       continue;
     }
-    const version = await readWindowsFileVersion(chromePath);
-    if (version) {
-      return version.split(".")[0];
+    const out = await runCommandCapture(cmd, ["--version"]);
+    const parsed = out ? parseBrowserVersionString(out) : void 0;
+    if (parsed) {
+      result.chrome = { path: cmd, version: parsed.version, major: parsed.major };
+      break;
     }
   }
-  return void 0;
+  if (await commandOnPath("firefox")) {
+    const out = await runCommandCapture("firefox", ["--version"]);
+    const parsed = out ? parseBrowserVersionString(out) : void 0;
+    if (parsed) {
+      result.firefox = { path: "firefox", version: parsed.version, major: parsed.major };
+    }
+  }
+  return result;
+}
+function logSeleniumDriverGuidance(onLogLine) {
+  onLogLine?.(
+    "[selenium] \u5C06\u68C0\u6D4B\u672C\u673A Chrome/Firefox \u5E76\u5C1D\u8BD5\u4E0B\u8F7D\u9A71\u52A8\u81F3\u76EE\u5F55\uFF1B\u5931\u8D25\u53EF\u624B\u52A8\u653E\u5165 geckodriver/chromedriver\uFF08\u89C1\u63A5\u5165\u624B\u518C Selenium \u8282\uFF09"
+  );
+}
+async function detectInstalledChromeMajorVersion() {
+  const browsers = await detectLocalBrowsers();
+  return browsers.chrome?.major;
 }
 async function readWindowsFileVersion(exePath) {
   return new Promise((resolve) => {
@@ -3343,7 +3477,7 @@ async function downloadGeckodriver(driversDir, versionInput, onLogLine) {
   await import_promises4.default.mkdir(driversDir, { recursive: true });
   const zipPath = import_node_path4.default.join(driversDir, `_download_geckodriver_${version}.zip`);
   const extractDir = import_node_path4.default.join(driversDir, `_extract_geckodriver_${version}`);
-  onLogLine?.(`[selenium] \u4E0B\u8F7D geckodriver ${tag} \uFFFD\uFFFD?${driversDir}`);
+  onLogLine?.(`[selenium] \u4E0B\u8F7D geckodriver ${tag} \u2192 ${driversDir}`);
   onLogLine?.(`[selenium] URL: ${url}`);
   await downloadToFile(url, zipPath);
   await import_promises4.default.rm(extractDir, { recursive: true, force: true });
@@ -3356,7 +3490,7 @@ async function downloadGeckodriver(driversDir, versionInput, onLogLine) {
   await copyExecutable(found, dest);
   await import_promises4.default.rm(zipPath, { force: true });
   await import_promises4.default.rm(extractDir, { recursive: true, force: true });
-  onLogLine?.(`[selenium] geckodriver \u5DF2\u5199\uFFFD\uFFFD? ${dest}`);
+  onLogLine?.(`[selenium] geckodriver \u5DF2\u5199\u5165: ${dest}`);
   return { path: dest, version: tag };
 }
 async function downloadChromedriver(driversDir, versionInput, onLogLine) {
@@ -3376,7 +3510,7 @@ async function downloadChromedriver(driversDir, versionInput, onLogLine) {
   await import_promises4.default.mkdir(driversDir, { recursive: true });
   const zipPath = import_node_path4.default.join(driversDir, `_download_chromedriver_${major}.zip`);
   const extractDir = import_node_path4.default.join(driversDir, `_extract_chromedriver_${major}`);
-  onLogLine?.(`[selenium] \u4E0B\u8F7D chromedriver ${fullVersion} (\u4E3B\u7248\uFFFD\uFFFD?${major}) \uFFFD\uFFFD?${driversDir}`);
+  onLogLine?.(`[selenium] \u4E0B\u8F7D chromedriver ${fullVersion} (\u4E3B\u7248\u672C ${major}) \u2192 ${driversDir}`);
   onLogLine?.(`[selenium] URL: ${url}`);
   await downloadToFile(url, zipPath);
   await import_promises4.default.rm(extractDir, { recursive: true, force: true });
@@ -3393,7 +3527,7 @@ async function downloadChromedriver(driversDir, versionInput, onLogLine) {
   }
   await import_promises4.default.rm(zipPath, { force: true });
   await import_promises4.default.rm(extractDir, { recursive: true, force: true });
-  onLogLine?.(`[selenium] chromedriver \u5DF2\u5199\uFFFD\uFFFD? ${destVersioned}`);
+  onLogLine?.(`[selenium] chromedriver \u5DF2\u5199\u5165: ${destVersioned}`);
   return { path: destVersioned, version: fullVersion, major };
 }
 async function saveNativeDriverManifest(manifest, workspaceRoot) {
@@ -3403,38 +3537,91 @@ async function saveNativeDriverManifest(manifest, workspaceRoot) {
   const file = import_node_path4.default.join(dir, "native-drivers.json");
   await import_promises4.default.writeFile(file, JSON.stringify(manifest, null, 2), "utf8");
 }
+function resolveDefaultChromedriverVersion(requested, browsers) {
+  if (requested && requested !== "latest") {
+    return requested;
+  }
+  if (browsers.chrome?.major) {
+    return "match-chrome";
+  }
+  return requested ?? "latest";
+}
+function formatDownloadError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
 async function ensureNativeWebDrivers(options = {}) {
   const root = options.workspaceRoot ?? await resolveWorkspaceRoot3();
   const driversDir = options.driversDir ?? await resolveNativeDriversDir(root);
   await import_promises4.default.mkdir(driversDir, { recursive: true });
   const log2 = options.onLogLine;
+  logSeleniumDriverGuidance(log2);
   log2?.(`[selenium] \u539F\u751F\u9A71\u52A8\u76EE\u5F55: ${driversDir}`);
+  const browsers = await detectLocalBrowsers();
+  if (browsers.chrome) {
+    log2?.(
+      `[selenium] \u68C0\u6D4B\u5230\u672C\u673A Chrome/Chromium: ${browsers.chrome.version} (\u4E3B\u7248\u672C ${browsers.chrome.major}) \u2014 ${browsers.chrome.path}`
+    );
+  } else {
+    log2?.("[selenium] \u672A\u68C0\u6D4B\u5230\u672C\u673A Chrome/Chromium\uFF08chromedriver \u5C06\u4F7F\u7528 latest \u6216\u663E\u5F0F\u6307\u5B9A\u7248\u672C\uFF09");
+  }
+  if (browsers.firefox) {
+    log2?.(
+      `[selenium] \u68C0\u6D4B\u5230\u672C\u673A Firefox: ${browsers.firefox.version} (\u4E3B\u7248\u672C ${browsers.firefox.major}) \u2014 ${browsers.firefox.path}`
+    );
+  } else {
+    log2?.("[selenium] \u672A\u68C0\u6D4B\u5230\u672C\u673A Firefox\uFF08geckodriver \u5C06\u4F7F\u7528 latest \u6216\u663E\u5F0F\u6307\u5B9A\u7248\u672C\uFF09");
+  }
   const localChromeVersions = await listLocalChromedriverVersions(driversDir);
   if (localChromeVersions.length > 0) {
-    log2?.(`[selenium] \u76EE\u5F55\u5185\u5DF2\uFFFD\uFFFD?chromedriver \u7248\u672C: ${localChromeVersions.join(", ")}`);
+    log2?.(`[selenium] \u76EE\u5F55\u5185\u5DF2\u6709 chromedriver \u7248\u672C: ${localChromeVersions.join(", ")}`);
+  }
+  const chromedriverRequest = resolveDefaultChromedriverVersion(options.chromedriverVersion, browsers);
+  if (chromedriverRequest === "match-chrome" && browsers.chrome) {
+    log2?.(
+      `[selenium] chromedriver \u5C06\u5C1D\u8BD5\u5339\u914D\u672C\u673A Chrome \u4E3B\u7248\u672C ${browsers.chrome.major}\uFF08chrome-for-testing \u76EE\u5F55\uFF09`
+    );
   }
   const localGecko = await findGeckodriverInDir(driversDir, options.geckodriverVersion);
   const hasLocalGecko = Boolean(localGecko && await fileExists(localGecko));
   let geckoVersion = options.geckodriverVersion;
   if (options.geckodriverVersion !== "skip" && (options.force || !hasLocalGecko)) {
-    const downloaded = await downloadGeckodriver(driversDir, options.geckodriverVersion ?? "latest", log2);
-    geckoVersion = downloaded.version;
+    try {
+      const downloaded = await downloadGeckodriver(driversDir, options.geckodriverVersion ?? "latest", log2);
+      geckoVersion = downloaded.version;
+    } catch (error) {
+      log2?.(`[selenium][warn] geckodriver \u81EA\u52A8\u4E0B\u8F7D\u5931\u8D25\uFF0C\u5DF2\u8DF3\u8FC7: ${formatDownloadError(error)}`);
+      log2?.(
+        "[selenium][warn] \u8BF7\u5C06 geckodriver \u653E\u5165\u4E0A\u8FF0\u76EE\u5F55\u6216\u914D\u7F6E PATH / ADA_GECKODRIVER_PATH\uFF1B\u53EF\u53C2\u8003 Mozilla \u53D1\u5E03\u9875\u624B\u52A8\u4E0B\u8F7D\u3002"
+      );
+    }
   } else if (hasLocalGecko) {
     log2?.(`[selenium] \u590D\u7528\u5DF2\u6709 geckodriver: ${localGecko}`);
   }
-  const localChrome = await findChromedriverInDir(driversDir, options.chromedriverVersion);
+  const localChrome = await findChromedriverInDir(driversDir, chromedriverRequest);
   const hasLocalChrome = Boolean(localChrome && await fileExists(localChrome.path));
-  if (options.chromedriverVersion !== "skip" && (options.force || !hasLocalChrome)) {
-    await downloadChromedriver(driversDir, options.chromedriverVersion ?? "latest", log2);
+  if (chromedriverRequest !== "skip" && (options.force || !hasLocalChrome)) {
+    try {
+      await downloadChromedriver(driversDir, chromedriverRequest ?? "latest", log2);
+    } catch (error) {
+      log2?.(`[selenium][warn] chromedriver \u81EA\u52A8\u4E0B\u8F7D\u5931\u8D25\uFF0C\u5DF2\u8DF3\u8FC7: ${formatDownloadError(error)}`);
+      if (browsers.chrome) {
+        log2?.(
+          `[selenium][warn] \u672C\u673A Chrome \u4E3B\u7248\u672C\u4E3A ${browsers.chrome.major}\uFF0C\u8BF7\u4E0B\u8F7D\u5339\u914D\u7248\u672C\u7684 chromedriver \u653E\u5165\u76EE\u5F55\u6216\u914D\u7F6E ADA_CHROMEDRIVER_PATH\u3002`
+        );
+      }
+      log2?.(
+        "[selenium][warn] \u53EF\u53C2\u8003 chrome-for-testing / chromedriver.storage \u624B\u52A8\u4E0B\u8F7D\uFF1B\u5DF2\u653E\u5165 dirver/ \u7684\u9A71\u52A8\u4F1A\u5728\u4E0B\u6B21\u542F\u52A8\u65F6\u81EA\u52A8\u590D\u7528\u3002"
+      );
+    }
   } else if (hasLocalChrome) {
-    log2?.(`[selenium] \u590D\u7528\u5DF2\u6709 chromedriver: ${localChrome.path} (\u4E3B\u7248\uFFFD\uFFFD?${localChrome.version})`);
+    log2?.(`[selenium] \u590D\u7528\u5DF2\u6709 chromedriver: ${localChrome.path} (\u4E3B\u7248\u672C ${localChrome.version})`);
   }
   const resolved = await resolveNativeDrivers({
     driversDir,
     workspaceRoot: root,
     selection: {
       geckodriverVersion: geckoVersion,
-      chromedriverVersion: options.chromedriverVersion ?? localChrome?.version
+      chromedriverVersion: chromedriverRequest ?? localChrome?.version
     }
   });
   await saveNativeDriverManifest(
@@ -3449,10 +3636,17 @@ async function ensureNativeWebDrivers(options = {}) {
   if (resolved.geckodriverPath) {
     process.env.ADA_GECKODRIVER_PATH = resolved.geckodriverPath;
     log2?.(`[selenium] \u4F7F\u7528 geckodriver: ${resolved.geckodriverPath}`);
+  } else if (options.geckodriverVersion !== "skip") {
+    log2?.("[selenium][warn] \u672A\u627E\u5230\u53EF\u7528 geckodriver\uFF08\u81EA\u52A8\u4E0B\u8F7D\u5DF2\u8DF3\u8FC7\u6216\u5931\u8D25\uFF0C\u8BF7\u624B\u52A8\u5B89\u88C5\uFF09");
   }
   if (resolved.chromedriverPath) {
     process.env.ADA_CHROMEDRIVER_PATH = resolved.chromedriverPath;
     log2?.(`[selenium] \u4F7F\u7528 chromedriver: ${resolved.chromedriverPath}`);
+  } else if (chromedriverRequest !== "skip") {
+    log2?.("[selenium][warn] \u672A\u627E\u5230\u53EF\u7528 chromedriver\uFF08\u81EA\u52A8\u4E0B\u8F7D\u5DF2\u8DF3\u8FC7\u6216\u5931\u8D25\uFF0C\u8BF7\u624B\u52A8\u5B89\u88C5\uFF09");
+  }
+  if (!resolved.geckodriverOk && !resolved.chromedriverOk) {
+    log2?.("[selenium][warn] \u5F53\u524D\u65E0\u53EF\u7528\u539F\u751F WebDriver\uFF1BSelenium \u4EFB\u52A1\u53EF\u80FD\u5931\u8D25\uFF0C\u8BF7\u6309\u4E0A\u6587\u53C2\u8003\u5730\u5740\u81EA\u884C\u4E0B\u8F7D\u3002");
   }
   return resolved;
 }
@@ -3469,6 +3663,13 @@ var init_src2 = __esm({
 });
 
 // ../ada-agent/src/dependency-installer.ts
+function playwrightInstallPackageSpec() {
+  const fromEnv = process.env.ADA_PLAYWRIGHT_VERSION?.trim();
+  return `playwright@${fromEnv || PINNED_PLAYWRIGHT_VERSION}`;
+}
+function resolveInstallPackageSpecs(packages) {
+  return packages.map((pkg) => pkg === "playwright" ? playwrightInstallPackageSpec() : pkg);
+}
 function shouldUseShell(command) {
   if (process.platform !== "win32") {
     return false;
@@ -3483,6 +3684,69 @@ function hasPackage(packageName) {
     return false;
   }
 }
+function briefErrorMessage(error) {
+  if (error instanceof Error) {
+    return error.message.split(/\r?\n/)[0]?.trim() || error.message;
+  }
+  return String(error).split(/\r?\n/)[0]?.trim() || String(error);
+}
+function shouldEmitPlaywrightCliLine(line) {
+  const t = line.trim();
+  if (!t) {
+    return false;
+  }
+  if (/^\s*at\s/.test(line) || t.includes("coreBundle.js") || t.includes("processTicksAndRejections")) {
+    return false;
+  }
+  if (t.includes("<Error>") || t.includes("NoSuchKey") || t.startsWith("<?xml")) {
+    return false;
+  }
+  if (t.includes("Download failure, code=") && !t.startsWith("Error:")) {
+    return false;
+  }
+  return true;
+}
+function summarizePlaywrightCliLine(line) {
+  const t = line.trim();
+  if (/^Downloading Chrome for Testing/i.test(t) || /^Downloading chromium/i.test(t)) {
+    const from = t.match(/\bfrom\s+(https?:\/\/\S+)/i)?.[1];
+    return from ? `[playwright] \u6B63\u5728\u4E0B\u8F7D Chromium\uFF08${from}\uFF09` : "[playwright] \u6B63\u5728\u4E0B\u8F7D Chromium\u2026";
+  }
+  if (/^Error:\s*Download failed:/i.test(t)) {
+    const code = t.match(/\bcode[=\s]+(\d{3})\b/i)?.[1] ?? t.match(/returned code (\d{3})/i)?.[1];
+    return code ? `[playwright][warn] \u955C\u50CF\u8FD4\u56DE HTTP ${code}\uFF0C\u5C06\u5C1D\u8BD5\u4E0B\u4E00\u4E2A CDN` : "[playwright][warn] \u955C\u50CF\u4E0B\u8F7D\u5931\u8D25\uFF0C\u5C06\u5C1D\u8BD5\u4E0B\u4E00\u4E2A CDN";
+  }
+  if (/^Failed to install browsers/i.test(t) || /^Failed to download Chrome/i.test(t)) {
+    return "[playwright][warn] \u5F53\u524D\u955C\u50CF\u672A\u5B89\u88C5\u6210\u529F";
+  }
+  if (/^Progress:/i.test(t)) {
+    return null;
+  }
+  if (t.length > 200) {
+    return `[playwright] ${t.slice(0, 120)}\u2026`;
+  }
+  return t.startsWith("[playwright]") ? t : `[playwright] ${t}`;
+}
+function createPlaywrightInstallLogSink(onLogLine) {
+  if (!onLogLine) {
+    return void 0;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  return (line) => {
+    if (!shouldEmitPlaywrightCliLine(line)) {
+      return;
+    }
+    const summary = summarizePlaywrightCliLine(line);
+    if (!summary) {
+      return;
+    }
+    if (seen.has(summary)) {
+      return;
+    }
+    seen.add(summary);
+    onLogLine(summary);
+  };
+}
 function runCommand2(command, args, options) {
   return new Promise((resolve, reject) => {
     const onLogLine = options?.onLogLine;
@@ -3507,7 +3771,7 @@ function runCommand2(command, args, options) {
       buf = parts.pop() ?? "";
       for (const line of parts) {
         const t = line.trimEnd();
-        if (t.length > 0) {
+        if (t.length > 0 && (options?.logFilter?.(t) ?? true)) {
           onLogLine(t);
         }
       }
@@ -3543,7 +3807,7 @@ function runCommand2(command, args, options) {
     });
   });
 }
-function runCommandCapture(command, args) {
+function runCommandCapture2(command, args) {
   return new Promise((resolve) => {
     const child = (0, import_node_child_process2.spawn)(command, args, {
       stdio: ["ignore", "pipe", "pipe"],
@@ -3665,7 +3929,7 @@ async function ensureNodeEnvironmentForInstall(onLogLine) {
   const requiredNpmMajor = 10;
   const runtimeNode = process.versions.node;
   const runtimeMajor = majorOf(runtimeNode);
-  const nodeVersion = await runCommandCapture("node", ["-v"]);
+  const nodeVersion = await runCommandCapture2("node", ["-v"]);
   if (nodeVersion.code === 0) {
     const nodeMajor = majorOf(nodeVersion.stdout);
     onLogLine?.(`[deps] Node \u7248\u672C\u68C0\u6D4B\uFF1A\u7CFB\u7EDF=${nodeVersion.stdout}\uFF0C\u5185\u7F6E=${runtimeNode}`);
@@ -3684,7 +3948,7 @@ async function ensureNodeEnvironmentForInstall(onLogLine) {
       `[deps][warn] \u672A\u4ECE PATH \u68C0\u6D4B\u5230 node\uFF0C\u5F53\u524D\u8FD0\u884C\u65F6 Node.js=${runtimeNode}\uFF08\u53EF\u6267\u884C\u7A0B\u5E8F\u5185\u7F6E\uFF09\uFF0C\u7EE7\u7EED\u5C1D\u8BD5\u5B89\u88C5\u3002`
     );
   }
-  const npmVersion = await runCommandCapture("npm", ["-v"]);
+  const npmVersion = await runCommandCapture2("npm", ["-v"]);
   if (npmVersion.code !== 0) {
     const message = "\u672A\u68C0\u6D4B\u5230\u53EF\u7528\u7684 npm\uFF08PATH \u4E2D\u4E0D\u53EF\u7528\uFF09\u3002\u8BF7\u5B89\u88C5 Node.js 22+\uFF08\u542B npm\uFF09\u5E76\u91CD\u542F\u7EC8\u7AEF\u540E\u91CD\u8BD5\u3002";
     onLogLine?.(`[deps] ${message}`);
@@ -3737,7 +4001,7 @@ async function resolveCompatibleDriverSpecs(driver) {
   const preferred = driver === "uiautomator2" ? process.env.ADA_APPIUM_DRIVER_SPEC_UIAUTOMATOR2 ?? `${pkg}@2` : process.env.ADA_APPIUM_DRIVER_SPEC_XCUITEST ?? `${pkg}@7`;
   const fallbackRange = driver === "uiautomator2" ? process.env.ADA_APPIUM_DRIVER_RANGE_UIAUTOMATOR2 ?? "<3" : process.env.ADA_APPIUM_DRIVER_RANGE_XCUITEST ?? "<8";
   const specs = [preferred];
-  const view = await runCommandCapture("npm", ["view", `${pkg}@${fallbackRange}`, "version"]);
+  const view = await runCommandCapture2("npm", ["view", `${pkg}@${fallbackRange}`, "version"]);
   if (view.code === 0 && view.stdout) {
     const version = view.stdout.trim().split(/\r?\n/).pop()?.trim();
     if (version) {
@@ -3758,8 +4022,15 @@ function stepMeta(stage) {
   };
 }
 function progress(stage, details) {
+  if (depsHumanLog) {
+    const label = PROGRESS_HUMAN_LABELS[stage];
+    if (label) {
+      depsHumanLog(label);
+    }
+    return;
+  }
   const meta = stepMeta(stage);
-  log("info", {
+  depsStructuredLog("info", {
     event: "deps.progress",
     details: {
       stage,
@@ -3768,6 +4039,12 @@ function progress(stage, details) {
     }
   });
 }
+function depsStructuredLog(level, payload) {
+  if (depsHumanLog) {
+    return;
+  }
+  log(level, payload);
+}
 function normalizeRegistryUrl(url) {
   return url.replace(/\/$/, "");
 }
@@ -3840,7 +4117,7 @@ async function detectBestRegistry(config, baseProxy) {
     }
   }
   detectedBestRegistryByKey.set(cacheKey, best);
-  log("info", {
+  depsStructuredLog("info", {
     event: "deps.registry.auto-selected",
     details: {
       selected: best,
@@ -3936,11 +4213,14 @@ async function rankPlaywrightHosts(config) {
   const withArtifact = reachable.filter((x) => x.artifactOk);
   const pool = withArtifact.length > 0 ? withArtifact : reachable;
   pool.sort((a, b) => {
-    if (a.artifactOk !== b.artifactOk) {
-      return a.artifactOk ? -1 : 1;
-    }
-    if (a.latency !== b.latency) {
-      return (a.latency ?? 0) - (b.latency ?? 0);
+    if (withArtifact.length > 0) {
+      if (a.artifactOk !== b.artifactOk) {
+        return a.artifactOk ? -1 : 1;
+      }
+      if (a.latency !== b.latency) {
+        return (a.latency ?? 0) - (b.latency ?? 0);
+      }
+      return a.priority - b.priority;
     }
     return a.priority - b.priority;
   });
@@ -3953,37 +4233,43 @@ async function rankPlaywrightHosts(config) {
   return ranked.length > 0 ? ranked : [...candidates];
 }
 async function runInstallWithPriority(config, packages, onLogLine) {
+  const specs = resolveInstallPackageSpecs(packages);
   const npmProxy = await detectBestRegistry(config, npmProxyRegistry());
   const pnpmProxy = await detectBestRegistry(config, pnpmProxyRegistry());
-  progress("packages.install.start", { packages, npmProxy, pnpmProxy });
+  progress("packages.install.start", { packages: specs, npmProxy, pnpmProxy });
+  if (packages.includes("playwright")) {
+    onLogLine?.(
+      `[deps] playwright \u5C06\u5B89\u88C5\u9501\u5B9A\u7248\u672C ${specs.find((s) => s.startsWith("playwright@")) ?? playwrightInstallPackageSpec()}\uFF08\u907F\u514D\u955C\u50CF latest \u4E0E\u6D4F\u89C8\u5668\u5305\u4E0D\u540C\u6B65\uFF09`
+    );
+  }
   onLogLine?.(
-    `[deps] \u5728\u7EBF\u5B89\u88C5\u5305: ${packages.join(" ")} (registry \u63A2\u6D4B: npm=${npmProxy}, pnpm=${pnpmProxy}\uFF1B\u987A\u5E8F: pnpm -> pnpm-proxy -> npm -> npm-proxy)`
+    `[deps] \u5728\u7EBF\u5B89\u88C5\u5305: ${specs.join(" ")} (registry \u63A2\u6D4B: npm=${npmProxy}, pnpm=${pnpmProxy}\uFF1B\u987A\u5E8F: pnpm -> pnpm-proxy -> npm -> npm-proxy)`
   );
   const strategies = [
     {
       name: "pnpm",
-      run: () => runCommand2("pnpm", ["add", ...packages], {
+      run: () => runCommand2("pnpm", ["add", ...specs], {
         timeoutMs: installStrategyTimeoutMs(),
         onLogLine
       })
     },
     {
       name: "pnpm-proxy",
-      run: () => runCommand2("pnpm", ["add", ...packages, "--registry", pnpmProxy], {
+      run: () => runCommand2("pnpm", ["add", ...specs, "--registry", pnpmProxy], {
         timeoutMs: installStrategyTimeoutMs(),
         onLogLine
       })
     },
     {
       name: "npm",
-      run: () => runCommand2("npm", ["install", ...packages], {
+      run: () => runCommand2("npm", ["install", ...specs], {
         timeoutMs: installStrategyTimeoutMs(),
         onLogLine
       })
     },
     {
       name: "npm-proxy",
-      run: () => runCommand2("npm", ["install", ...packages, "--registry", npmProxy], {
+      run: () => runCommand2("npm", ["install", ...specs, "--registry", npmProxy], {
         timeoutMs: installStrategyTimeoutMs(),
         onLogLine
       })
@@ -3992,21 +4278,21 @@ async function runInstallWithPriority(config, packages, onLogLine) {
   let lastError = void 0;
   for (const strategy of strategies) {
     try {
-      log("info", { event: "deps.install.strategy.try", details: { strategy: strategy.name, packages } });
+      depsStructuredLog("info", { event: "deps.install.strategy.try", details: { strategy: strategy.name, packages } });
       await strategy.run();
-      log("info", { event: "deps.install.strategy.ok", details: { strategy: strategy.name } });
+      depsStructuredLog("info", { event: "deps.install.strategy.ok", details: { strategy: strategy.name } });
       progress("packages.install.done", { strategy: strategy.name });
       return;
     } catch (error) {
       lastError = error;
-      log("warn", {
+      depsStructuredLog("warn", {
         event: "deps.install.strategy.fail",
         details: { strategy: strategy.name, message: error instanceof Error ? error.message : String(error) }
       });
     }
   }
-  throw new Error(
-    `Dependency install failed after all strategies: ${lastError instanceof Error ? lastError.message : String(lastError)}`
+  onLogLine?.(
+    `[deps][warn] \u5305\u5B89\u88C5\u672A\u6210\u529F\uFF08${specs.join(" ")}\uFF09: ${briefErrorMessage(lastError)}\uFF1BMCP \u4ECD\u5C06\u542F\u52A8\uFF0C\u53EF\u7A0D\u540E\u91CD\u8BD5\u6216\u914D\u7F6E registry`
   );
 }
 async function runAppiumDriverInstallWithPriority(config, driver, onLogLine) {
@@ -4041,12 +4327,12 @@ async function runAppiumDriverInstallWithPriority(config, driver, onLogLine) {
     ];
     for (const strategy of strategies) {
       try {
-        log("info", {
+        depsStructuredLog("info", {
           event: "appium.driver.install.strategy.try",
           details: { strategy: strategy.name, driver, target }
         });
         await strategy.run();
-        log("info", {
+        depsStructuredLog("info", {
           event: "appium.driver.install.strategy.ok",
           details: { strategy: strategy.name, driver, target }
         });
@@ -4054,7 +4340,7 @@ async function runAppiumDriverInstallWithPriority(config, driver, onLogLine) {
         return;
       } catch (error) {
         lastError = error;
-        log("warn", {
+        depsStructuredLog("warn", {
           event: "appium.driver.install.strategy.fail",
           details: {
             strategy: strategy.name,
@@ -4071,16 +4357,23 @@ async function runAppiumDriverInstallWithPriority(config, driver, onLogLine) {
   );
 }
 async function verifyPlaywrightSelfTest(onLogLine) {
-  onLogLine?.("[playwright] \u81EA\u68C0\uFF1A\u542F\u52A8 Chromium \u7A7A\u767D\u9875");
-  const moduleName = ["play", "wright"].join("");
-  const p = require2(moduleName);
-  const b = await p.chromium.launch({ headless: true });
+  onLogLine?.("[playwright] \u81EA\u68C0\uFF1A\u542F\u52A8 Chromium");
   try {
-    const c = await b.newContext();
-    const page = await c.newPage();
-    await page.goto("about:blank");
-  } finally {
-    await b.close();
+    const moduleName = ["play", "wright"].join("");
+    const p = require2(moduleName);
+    const b = await p.chromium.launch({ headless: true });
+    try {
+      const c = await b.newContext();
+      const page = await c.newPage();
+      await page.goto("about:blank");
+    } finally {
+      await b.close();
+    }
+    onLogLine?.("[playwright] \u81EA\u68C0\u901A\u8FC7");
+    return true;
+  } catch (error) {
+    onLogLine?.(`[playwright][warn] \u81EA\u68C0\u672A\u901A\u8FC7: ${briefErrorMessage(error)}`);
+    return false;
   }
 }
 async function installPlaywrightBrowser(config, onLogLine, options) {
@@ -4104,36 +4397,45 @@ async function installPlaywrightBrowser(config, onLogLine, options) {
   const rankedHosts = await rankPlaywrightHosts(config);
   const timeoutMs = playwrightInstallTimeoutMs();
   onLogLine?.(`[playwright] \u5B89\u88C5\u8D85\u65F6\u4E0A\u9650 ${Math.round(timeoutMs / 1e3)}s\uFF08\u53EF\u7528 ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS \u8C03\u6574\uFF09`);
-  let lastError;
+  let lastHost = "";
   for (let i = 0; i < rankedHosts.length; i++) {
     const host = rankedHosts[i];
+    lastHost = host;
     if (i > 0) {
-      onLogLine?.(`[playwright] \u4E0A\u4E00\u955C\u50CF\u5931\u8D25\uFF0C\u6539\u8BD5 ${host}`);
+      onLogLine?.(`[playwright] \u6362\u955C\u50CF: ${host}`);
+    } else {
+      onLogLine?.(
+        `[playwright] playwright@${version}\uFF0CCDN ${host}\uFF0C\u76EE\u6807 ${targets.length ? targets.join(",") : "chromium"}`
+      );
     }
-    onLogLine?.(
-      `[playwright] \u4F7F\u7528\u5185\u7F6E playwright@${version} CLI\uFF0C\u955C\u50CF ${host}\uFF0C\u76EE\u6807: ${targets.length ? targets.join(",") : "all"}${options?.force ? " (--force)" : ""}`
-    );
     try {
       await runCommand2(command, installArgs, {
         env: { PLAYWRIGHT_DOWNLOAD_HOST: host },
         timeoutMs,
-        onLogLine
+        onLogLine: createPlaywrightInstallLogSink(onLogLine)
       });
       progress("playwright.browser.install.done", { selectedHost: host, attempt: i + 1 });
-      return;
+      onLogLine?.(`[playwright] \u6D4F\u89C8\u5668\u5B89\u88C5\u5B8C\u6210\uFF08${host}\uFF09`);
+      return true;
     } catch (error) {
-      lastError = error;
-      log("warn", {
+      onLogLine?.(`[playwright][warn] \u955C\u50CF ${host} \u5931\u8D25: ${briefErrorMessage(error)}`);
+      depsStructuredLog("warn", {
         event: "deps.playwright.browser.install.host.fail",
         details: {
           host,
           attempt: i + 1,
-          message: error instanceof Error ? error.message : String(error)
+          message: briefErrorMessage(error)
         }
       });
     }
   }
-  throw lastError instanceof Error ? lastError : new Error(String(lastError ?? "playwright browser install failed"));
+  onLogLine?.(
+    `[playwright][warn] \u6D4F\u89C8\u5668\u672A\u5B89\u88C5\u5B8C\u6210\uFF08\u5DF2\u5C1D\u8BD5 ${rankedHosts.length} \u4E2A CDN\uFF09\u3002\u53EF\u8BBE\u7F6E PLAYWRIGHT_DOWNLOAD_HOST=https://cdn.playwright.dev \u540E\u91CD\u8BD5\uFF0C\u6216\u6267\u884C: npx playwright@${PINNED_PLAYWRIGHT_VERSION} install chromium`
+  );
+  if (lastHost) {
+    onLogLine?.(`[playwright][warn] \u6700\u540E\u5C1D\u8BD5: ${lastHost}`);
+  }
+  return false;
 }
 async function checkPlaywrightLaunchable() {
   try {
@@ -4159,7 +4461,7 @@ async function verifyAppiumCommand() {
   }
 }
 async function getInstalledAppiumDrivers() {
-  const check = await runCommandCapture("npm", ["exec", "appium", "driver", "list", "--installed", "--json"]);
+  const check = await runCommandCapture2("npm", ["exec", "appium", "driver", "list", "--installed", "--json"]);
   if (check.code === 0 && check.stdout) {
     try {
       const parsed = JSON.parse(check.stdout);
@@ -4168,7 +4470,7 @@ async function getInstalledAppiumDrivers() {
     } catch {
     }
   }
-  const fallback = await runCommandCapture("npm", ["exec", "appium", "driver", "list", "--installed"]);
+  const fallback = await runCommandCapture2("npm", ["exec", "appium", "driver", "list", "--installed"]);
   if (fallback.code !== 0) {
     return [];
   }
@@ -4376,6 +4678,28 @@ async function saveInstallState(state) {
   await import_promises5.default.writeFile(file, JSON.stringify(state, null, 2), "utf8");
 }
 async function ensureDriverDependencies(config, options) {
+  const previousHumanLog = depsHumanLog;
+  depsHumanLog = options?.onLogLine;
+  try {
+    return await ensureDriverDependenciesImpl(config, options);
+  } catch (error) {
+    options?.onLogLine?.(`[deps][warn] \u4F9D\u8D56\u5B89\u88C5\u5F02\u5E38\u5DF2\u5FFD\u7565: ${briefErrorMessage(error)}`);
+    const only = options?.only ?? "all";
+    return {
+      scope: only,
+      force: options?.force ?? false,
+      elapsedMs: 0,
+      requestedDrivers: [],
+      installedPackages: [],
+      skippedPackages: [],
+      installedDrivers: [],
+      skippedDrivers: []
+    };
+  } finally {
+    depsHumanLog = previousHumanLog;
+  }
+}
+async function ensureDriverDependenciesImpl(config, options) {
   const startedAt = Date.now();
   const only = options?.only ?? "all";
   const force = options?.force === true;
@@ -4416,12 +4740,12 @@ async function ensureDriverDependencies(config, options) {
   }
   if (packagesToInstall.length > 0) {
     progress("deps.package.missing", { missing, installing: packagesToInstall });
-    log("warn", { event: "deps.missing", details: { missing, installing: packagesToInstall } });
+    onLogLine?.(`[deps] \u5C06\u5B89\u88C5: ${packagesToInstall.join(", ")}`);
     await runInstallWithPriority(config, packagesToInstall, onLogLine);
     installedPackages.push(...packagesToInstall);
   } else {
     progress("deps.package.ok", { missing: [] });
-    log("info", { event: "deps.check.ok", details: { missing: [] } });
+    depsStructuredLog("info", { event: "deps.check.ok", details: { missing: [] } });
   }
   if (hasPackage("playwright") && needPlaywright) {
     progress("playwright.selfcheck.start");
@@ -4429,7 +4753,7 @@ async function ensureDriverDependencies(config, options) {
     const reinstallForTargets = force && Boolean(pwOverride?.length);
     const userRequestedBrowserTargets = Boolean(pwOverride?.length);
     if (!launchOk || reinstallForTargets || userRequestedBrowserTargets || force) {
-      log("warn", {
+      depsStructuredLog("warn", {
         event: "deps.playwright.browser.missing",
         details: {
           action: "install-playwright-browser",
@@ -4442,19 +4766,21 @@ async function ensureDriverDependencies(config, options) {
           userRequestedBrowserTargets ? "[playwright] --force\uFF1A\u91CD\u65B0\u5B89\u88C5\u5F53\u524D\u52FE\u9009\u7684\u6D4F\u89C8\u5668\u901A\u9053" : "[playwright] --force\uFF1A\u6309\u914D\u7F6E\u6587\u4EF6\u4E2D\u7684\u76EE\u6807\u91CD\u65B0\u5B89\u88C5\u6D4F\u89C8\u5668"
         );
       }
-      await installPlaywrightBrowser(configForPlaywright, onLogLine, {
+      const browserInstalled = await installPlaywrightBrowser(configForPlaywright, onLogLine, {
         force: force || reinstallForTargets || !launchOk
       });
-      progress("playwright.selfcheck.verify");
-      await verifyPlaywrightSelfTest(onLogLine);
-      state.playwrightReady = true;
-      progress("playwright.selfcheck.done");
+      if (browserInstalled) {
+        progress("playwright.selfcheck.verify");
+        state.playwrightReady = await verifyPlaywrightSelfTest(onLogLine);
+        progress("playwright.selfcheck.done");
+      } else {
+        state.playwrightReady = false;
+      }
     } else if (!force && state.playwrightReady) {
       progress("playwright.selfcheck.skip.cache", { cached: true, healthy: true });
     } else {
       progress("playwright.selfcheck.verify");
-      await verifyPlaywrightSelfTest(onLogLine);
-      state.playwrightReady = true;
+      state.playwrightReady = await verifyPlaywrightSelfTest(onLogLine);
       progress("playwright.selfcheck.done");
     }
   }
@@ -4468,12 +4794,16 @@ async function ensureDriverDependencies(config, options) {
     progress("selenium.check.done", sel);
   }
   if (hasPackage("appium") && needAppium) {
-    progress("appium.selfcheck.start");
-    await verifyAppiumCommand();
-    if (!force && state.appiumReady) {
-      progress("appium.selfcheck.skip.cache", { cached: true, healthy: true });
-    } else {
-      state.appiumReady = true;
+    try {
+      progress("appium.selfcheck.start");
+      await verifyAppiumCommand();
+      if (!force && state.appiumReady) {
+        progress("appium.selfcheck.skip.cache", { cached: true, healthy: true });
+      } else {
+        state.appiumReady = true;
+      }
+    } catch (error) {
+      onLogLine?.(`[appium][warn] ${briefErrorMessage(error)}`);
     }
   }
   if (hasPackage("appium") && needDrivers) {
@@ -4492,11 +4822,15 @@ async function ensureDriverDependencies(config, options) {
           requiredDrivers: required
         }
       };
-      await ensureAppiumDrivers(scopedConfig, onLogLine);
-      installedDrivers.push(...missingBefore);
-      skippedDrivers.push(...required.filter((x) => !missingBefore.includes(x)));
-      state.driversReady = true;
-      progress("appium.driver.ensure.done");
+      try {
+        await ensureAppiumDrivers(scopedConfig, onLogLine);
+        installedDrivers.push(...missingBefore);
+        skippedDrivers.push(...required.filter((x) => !missingBefore.includes(x)));
+        state.driversReady = true;
+        progress("appium.driver.ensure.done");
+      } catch (error) {
+        onLogLine?.(`[appium][warn] \u9A71\u52A8\u5B89\u88C5\u672A\u5B8C\u6210: ${briefErrorMessage(error)}`);
+      }
     }
   }
   state.androidHome = homes.androidHome;
@@ -4504,7 +4838,7 @@ async function ensureDriverDependencies(config, options) {
   await saveInstallState(state);
   const installedPkgs = Array.from(new Set(installedPackages));
   progress("deps.ensure.done", { installedPackages: installedPkgs, missingDetected: missing });
-  log("info", { event: "deps.install.completed", details: { installedPackages: installedPkgs } });
+  depsStructuredLog("info", { event: "deps.install.completed", details: { installedPackages: installedPkgs } });
   const requestedPackages = ["playwright", "appium"].filter((pkg) => pkg === "playwright" ? needPlaywright : needAppium);
   let nativeDriversDir;
   let geckodriverPath;
@@ -4588,7 +4922,7 @@ async function getDependencyHealth(config) {
     missingAppiumDrivers
   };
 }
-var import_node_module, import_node_fs, import_node_child_process2, import_promises5, import_node_path5, require2, DEFAULT_NPM_REGISTRY_CANDIDATES, detectedBestRegistryByKey, PROGRESS_STEPS, DEFAULT_PLAYWRIGHT_HOST_CANDIDATES, PLAYWRIGHT_HOST_FALLBACK, PW_INSTALL_TARGETS;
+var import_node_module, import_node_fs, import_node_child_process2, import_promises5, import_node_path5, require2, PINNED_PLAYWRIGHT_VERSION, depsHumanLog, DEFAULT_NPM_REGISTRY_CANDIDATES, detectedBestRegistryByKey, PROGRESS_STEPS, PROGRESS_HUMAN_LABELS, DEFAULT_PLAYWRIGHT_HOST_CANDIDATES, PLAYWRIGHT_HOST_FALLBACK, PW_INSTALL_TARGETS;
 var init_dependency_installer = __esm({
   "../ada-agent/src/dependency-installer.ts"() {
     import_node_module = require("node:module");
@@ -4600,6 +4934,7 @@ var init_dependency_installer = __esm({
     init_config();
     init_src2();
     require2 = (0, import_node_module.createRequire)(import_node_path5.default.join(process.cwd(), "package.json"));
+    PINNED_PLAYWRIGHT_VERSION = "1.59.1";
     DEFAULT_NPM_REGISTRY_CANDIDATES = [
       "https://registry.npmmirror.com",
       "https://mirrors.cloud.tencent.com/npm",
@@ -4616,6 +4951,15 @@ var init_dependency_installer = __esm({
       "appium.driver.ensure.start",
       "deps.ensure.done"
     ];
+    PROGRESS_HUMAN_LABELS = {
+      "deps.ensure.start": "[deps] \u5F00\u59CB\u68C0\u6D4B\u4F9D\u8D56",
+      "registry.probe.start": "[deps] \u63A2\u6D4B npm \u955C\u50CF\u2026",
+      "packages.install.start": "[deps] \u5B89\u88C5 npm \u5305\u2026",
+      "playwright.host.probe.start": "[playwright] \u63A2\u6D4B\u6D4F\u89C8\u5668 CDN\u2026",
+      "playwright.browser.install.start": "[playwright] \u5B89\u88C5\u6D4F\u89C8\u5668\u2026",
+      "appium.driver.ensure.start": "[appium] \u5B89\u88C5\u9A71\u52A8\u2026",
+      "deps.ensure.done": "[deps] \u4F9D\u8D56\u68C0\u6D4B\u5B8C\u6210"
+    };
     DEFAULT_PLAYWRIGHT_HOST_CANDIDATES = [
       "https://cdn.playwright.dev",
       "https://playwright.azureedge.net",
@@ -9168,9 +9512,15 @@ async function runBootstrapInstallDeps(argv2) {
   console.error(`[ADA-MCP] dependency bootstrap start (scope=${label}, force=${plan.force})`);
   for (const scope of plan.scopes) {
     console.error(`[ADA-MCP] installing: ${scope}`);
-    await installDependencies(scope, plan.force, (line) => {
-      console.error(`[ADA-MCP] ${line}`);
-    }, plan.extras);
+    try {
+      await installDependencies(scope, plan.force, (line) => {
+        console.error(`[ADA-MCP] ${line}`);
+      }, plan.extras);
+    } catch (error) {
+      const msg = error instanceof Error ? error.message.split(/\r?\n/)[0] : String(error);
+      console.error(`[ADA-MCP][warn] ${scope} \u4F9D\u8D56\u5B89\u88C5\u672A\u5B8C\u6210: ${msg}`);
+      console.error("[ADA-MCP][warn] MCP \u4ECD\u5C06\u542F\u52A8\uFF1B\u53EF\u8BBE\u7F6E PLAYWRIGHT_DOWNLOAD_HOST=https://cdn.playwright.dev \u6216 --skip-install-deps");
+    }
   }
   console.error("[ADA-MCP] dependency bootstrap done");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ada-mcp/mcp-server",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "ADA MCP server for web/mobile automation (stdio + remote HTTP)",
   "private": false,
   "type": "commonjs",