@ada-mcp/mcp-server 0.1.15 → 0.1.16

package/README.md

@@ -8,27 +8,27 @@ ADA MCP server package that supports:
 
 ## 标准安装（Cursor / MCP）
 
-请使用 **`@ada-mcp/launcher@0.1.12`** 拉起本包（见 [launcher README](../ada-mcp-launcher/README.md)）：
+请使用 **`@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.12"]
+      "args": ["dlx", "@ada-mcp/launcher@0.1.13"]
     }
   }
 }
 ```
 
-本包版本：**`@ada-mcp/mcp-server@0.1.15`**（由 launcher 默认拉取；依赖锁定 `playwright@1.59.1`）。
+本包版本：**`@ada-mcp/mcp-server@0.1.16`**（由 launcher 默认拉取；依赖锁定 `playwright@1.59.1`）。
 
 直接调试本包（无 launcher 拉包前测速）：
 
 ```bash
-pnpm dlx @ada-mcp/mcp-server@0.1.15
+pnpm dlx @ada-mcp/mcp-server@0.1.16
 # npx 等价：
-npx -y @ada-mcp/mcp-server@0.1.15
+npx -y @ada-mcp/mcp-server@0.1.16
 ```
 
 ## 启动时自动安装依赖（默认仅 Playwright）
@@ -83,27 +83,27 @@ npx -y @ada-mcp/mcp-server@0.1.15
 在标准 `args` 后追加，例如安装全部依赖：
 
 ```json
-"args": ["dlx", "@ada-mcp/launcher@0.1.12", "--install-deps=all"]
+"args": ["dlx", "@ada-mcp/launcher@0.1.13", "--install-deps=all"]
 ```
 
 ## Cursor MCP 配置
 
-**pnpm（推荐）**：`pnpm` + `dlx @ada-mcp/launcher@0.1.12`
+**pnpm（推荐）**：`pnpm` + `dlx @ada-mcp/launcher@0.1.13`
 
-**npx 等价**（`launcher@0.1.7+`）：`npx` + `-y @ada-mcp/launcher@0.1.12`（内层同样 `npx -y` mcp-server，测速逻辑与 pnpm 一致）
+**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.12"]
+      "args": ["-y", "@ada-mcp/launcher@0.1.13"]
     }
   }
 }
 ```
 
-Windows 若找不到 `pnpm`，可将 `command` 改为 `pnpm.cmd` 绝对路径；无 pnpm 时只能直接 `npx -y @ada-mcp/mcp-server@0.1.15`（无 launcher 拉包测速）。
+Windows 若找不到 `pnpm`，可将 `command` 改为 `pnpm.cmd` 绝对路径；无 pnpm 时只能直接 `npx -y @ada-mcp/mcp-server@0.1.16`（无 launcher 拉包测速）。
 
 ## Remote mode
 

package/dist/cli.cjs

@@ -3429,14 +3429,7 @@ async function detectLocalBrowsers() {
 }
 function logSeleniumDriverGuidance(onLogLine) {
   onLogLine?.(
-    "[selenium] \u5B89\u88C5\u524D\u4F1A\u68C0\u6D4B\u672C\u673A Chrome/Chromium \u4E0E Firefox \u7248\u672C\uFF1B\u9A71\u52A8\u653E\u5165\u9879\u76EE\u76EE\u5F55\u540E\u53EF\u81EA\u884C\u66FF\u6362\u8986\u76D6\u3002"
-  );
-  onLogLine?.("[selenium] \u5404\u6D4F\u89C8\u5668\u9A71\u52A8\u624B\u52A8\u4E0B\u8F7D\u53C2\u8003\uFF1A");
-  for (const ref of SELENIUM_DRIVER_MANUAL_DOWNLOAD_REFERENCES) {
-    onLogLine?.(`[selenium]   ${ref.browser} (${ref.platforms}) \u2014 ${ref.vendor}: ${ref.url}`);
-  }
-  onLogLine?.(
-    "[selenium] \u81EA\u52A8\u4E0B\u8F7D\u5931\u8D25\u65F6\u5C06\u8DF3\u8FC7\u5BF9\u5E94\u9A71\u52A8\u5E76\u7EE7\u7EED\uFF0C\u8BF7\u6309\u4E0A\u8868\u81EA\u884C\u4E0B\u8F7D\u540E\u653E\u5165\u9A71\u52A8\u76EE\u5F55\u6216\u914D\u7F6E PATH/ADA_GECKODRIVER_PATH/ADA_CHROMEDRIVER_PATH\u3002"
+    "[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() {
@@ -3657,7 +3650,7 @@ async function ensureNativeWebDrivers(options = {}) {
   }
   return resolved;
 }
-var import_node_child_process, import_promises4, import_node_path4, DEFAULT_NATIVE_DRIVERS_DIR, CHROME_FOR_TESTING_JSON, SELENIUM_DRIVER_MANUAL_DOWNLOAD_REFERENCES;
+var import_node_child_process, import_promises4, import_node_path4, DEFAULT_NATIVE_DRIVERS_DIR, CHROME_FOR_TESTING_JSON;
 var init_src2 = __esm({
   "../../packages/native-drivers/src/index.ts"() {
     "use strict";
@@ -3666,48 +3659,17 @@ var init_src2 = __esm({
     import_node_path4 = __toESM(require("node:path"), 1);
     DEFAULT_NATIVE_DRIVERS_DIR = "dirver";
     CHROME_FOR_TESTING_JSON = "https://googlechromelabs.github.io/chrome-for-testing/known-good-versions-with-downloads.json";
-    SELENIUM_DRIVER_MANUAL_DOWNLOAD_REFERENCES = [
-      {
-        browser: "Chrome/Chromium",
-        platforms: "Windows/Linux/macOS",
-        vendor: "\u8C37\u6B4C",
-        url: "https://chromedriver.storage.googleapis.com/index.html"
-      },
-      {
-        browser: "Firefox",
-        platforms: "Windows/Linux/macOS",
-        vendor: "Mozilla",
-        url: "https://github.com/mozilla/geckodriver/releases"
-      },
-      {
-        browser: "Edge",
-        platforms: "win10",
-        vendor: "\u5FAE\u8F6F",
-        url: "https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/"
-      },
-      {
-        browser: "Internet Explorer",
-        platforms: "Windows",
-        vendor: "Selenium \u9879\u76EE\u7EC4",
-        url: "https://selenium-release.storage.googleapis.com/index.html"
-      },
-      {
-        browser: "Safari",
-        platforms: "macOS El Capitan \u53CA\u66F4\u9AD8\u7248\u672C",
-        vendor: "\u82F9\u679C",
-        url: "\uFF08\u7CFB\u7EDF\u5185\u7F6E\uFF0C\u65E0\u9700\u5355\u72EC\u4E0B\u8F7D\uFF09"
-      },
-      {
-        browser: "Opera",
-        platforms: "Windows/macOS/Linux",
-        vendor: "Opera",
-        url: "https://github.com/operasoftware/operachromiumdriver/releases"
-      }
-    ];
   }
 });
 
 // ../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;
@@ -3722,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;
@@ -3746,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);
         }
       }
@@ -3997,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,
@@ -4007,6 +4039,12 @@ function progress(stage, details) {
     }
   });
 }
+function depsStructuredLog(level, payload) {
+  if (depsHumanLog) {
+    return;
+  }
+  log(level, payload);
+}
 function normalizeRegistryUrl(url) {
   return url.replace(/\/$/, "");
 }
@@ -4079,7 +4117,7 @@ async function detectBestRegistry(config, baseProxy) {
     }
   }
   detectedBestRegistryByKey.set(cacheKey, best);
-  log("info", {
+  depsStructuredLog("info", {
     event: "deps.registry.auto-selected",
     details: {
       selected: best,
@@ -4175,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;
   });
@@ -4192,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
       })
@@ -4231,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) {
@@ -4280,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 }
         });
@@ -4293,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,
@@ -4310,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) {
@@ -4343,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 {
@@ -4477,7 +4540,6 @@ async function ensureSeleniumNativeDrivers(config, options, onLogLine) {
   }
   const geckoVer = options?.geckodriverVersion ?? config.dependencies.geckodriverVersion ?? "latest";
   const chromeVer = options?.chromedriverVersion ?? config.dependencies.chromedriverVersion ?? "latest";
-  onLogLine?.("[selenium] \u5C06\u68C0\u6D4B\u672C\u673A Chrome/Firefox \u7248\u672C\u5E76\u5C1D\u8BD5\u5339\u914D\u9A71\u52A8\uFF1B\u4E0B\u8F7D\u5931\u8D25\u65F6\u8DF3\u8FC7\u5E76\u63D0\u793A\u624B\u52A8\u4E0B\u8F7D\uFF08\u89C1\u5B89\u88C5\u65E5\u5FD7\u53C2\u8003\u5730\u5740\uFF09\u3002");
   try {
     const catalog = await listChromedriverCfTVersions();
     onLogLine?.(
@@ -4616,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;
@@ -4656,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");
@@ -4669,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",
@@ -4682,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");
     }
   }
@@ -4708,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) {
@@ -4732,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;
@@ -4744,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;
@@ -4828,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");
@@ -4840,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",
@@ -4856,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",
@@ -9408,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.15",
+  "version": "0.1.16",
   "description": "ADA MCP server for web/mobile automation (stdio + remote HTTP)",
   "private": false,
   "type": "commonjs",