@ada-mcp/mcp-server 0.1.17 → 0.1.19

package/README.md

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

package/dist/cli.cjs

@@ -3671,7 +3671,132 @@ function playwrightInstallPackageSpec() {
   return `playwright@${fromEnv || PINNED_PLAYWRIGHT_VERSION}`;
 }
 function resolveInstallPackageSpecs(packages) {
-  return packages.map((pkg) => pkg === "playwright" ? playwrightInstallPackageSpec() : pkg);
+  const out = [];
+  for (const pkg of packages) {
+    if (pkg === "playwright") {
+      out.push(playwrightInstallPackageSpec());
+      continue;
+    }
+    if (pkg === "zod") {
+      const fromEnv = process.env.ADA_ZOD_VERSION?.trim();
+      out.push(`zod@${fromEnv || PINNED_ZOD_VERSION}`);
+      continue;
+    }
+    out.push(pkg);
+  }
+  return out;
+}
+function skipConflictRemoval() {
+  const v = process.env.ADA_DEPS_SKIP_CONFLICT_REMOVAL?.trim().toLowerCase();
+  return v === "1" || v === "true" || v === "yes";
+}
+function readInstalledPackageVersion(packageName) {
+  try {
+    const pkgPath = require2.resolve(`${packageName}/package.json`);
+    const raw = (0, import_node_fs.readFileSync)(pkgPath, "utf8");
+    return String(JSON.parse(raw).version ?? "").trim() || void 0;
+  } catch {
+    return void 0;
+  }
+}
+function zodExportsV3Subpath(version2) {
+  try {
+    const pkgPath = require2.resolve("zod/package.json");
+    const raw = (0, import_node_fs.readFileSync)(pkgPath, "utf8");
+    const exportsField = JSON.parse(raw).exports;
+    if (exportsField && "./v3" in exportsField) {
+      return true;
+    }
+  } catch {
+  }
+  const major = Number(version2.split(".")[0]);
+  const minor = Number(version2.split(".")[1]);
+  if (major > 3) {
+    return true;
+  }
+  return major === 3 && minor >= 25;
+}
+function detectWorkspacePackageConflicts(packages) {
+  const conflicts = [];
+  const expectedPlaywright = process.env.ADA_PLAYWRIGHT_VERSION?.trim() || PINNED_PLAYWRIGHT_VERSION;
+  const expectedZod = process.env.ADA_ZOD_VERSION?.trim() || PINNED_ZOD_VERSION;
+  if (packages.includes("playwright") && hasPackage("playwright")) {
+    const installed = readInstalledPackageVersion("playwright");
+    if (installed && installed !== expectedPlaywright) {
+      conflicts.push({
+        name: "playwright",
+        installed,
+        expected: expectedPlaywright,
+        reason: "\u4E0E ADA \u9501\u5B9A\u7684 Playwright \u6D4F\u89C8\u5668\u5305\u7248\u672C\u4E0D\u4E00\u81F4"
+      });
+    }
+  }
+  if (hasPackage("@modelcontextprotocol/sdk") && hasPackage("zod")) {
+    const zodVer = readInstalledPackageVersion("zod");
+    if (zodVer && !zodExportsV3Subpath(zodVer)) {
+      conflicts.push({
+        name: "zod",
+        installed: zodVer,
+        expected: expectedZod,
+        reason: "\u5F53\u524D zod \u4E0D\u652F\u6301 zod/v3\uFF0C\u4E0E @modelcontextprotocol/sdk \u51B2\u7A81"
+      });
+    }
+  }
+  return conflicts;
+}
+function packagesToRemoveForConflicts(conflicts) {
+  const names = /* @__PURE__ */ new Set();
+  for (const c of conflicts) {
+    names.add(c.name);
+    if (c.name === "playwright") {
+      names.add("playwright-core");
+    }
+  }
+  return Array.from(names);
+}
+async function removeWorkspacePackages(names, onLogLine) {
+  const unique = Array.from(new Set(names)).filter(Boolean);
+  if (unique.length === 0) {
+    return true;
+  }
+  const timeoutMs = installStrategyTimeoutMs();
+  const attempts = [
+    { tool: "pnpm", args: ["remove", ...unique] },
+    { tool: "npm", args: ["uninstall", ...unique] }
+  ];
+  for (const { tool, args } of attempts) {
+    try {
+      await runCommand2(tool, args, { timeoutMs, onLogLine });
+      return true;
+    } catch {
+    }
+  }
+  return false;
+}
+async function reconcileWorkspacePackageConflicts(packages, onLogLine) {
+  if (skipConflictRemoval()) {
+    return [];
+  }
+  const conflicts = detectWorkspacePackageConflicts(packages);
+  if (conflicts.length === 0) {
+    return [];
+  }
+  for (const c of conflicts) {
+    onLogLine?.(`[deps] \u68C0\u6D4B\u5230\u51B2\u7A81 ${c.name}@${c.installed}\uFF0C\u76EE\u6807 ${c.expected}\uFF08${c.reason}\uFF09`);
+  }
+  const toRemove = packagesToRemoveForConflicts(conflicts);
+  onLogLine?.(`[deps] \u6B63\u5728\u5378\u8F7D: ${toRemove.join(", ")}`);
+  const removed = await removeWorkspacePackages(toRemove, onLogLine);
+  if (!removed) {
+    onLogLine?.("[deps][warn] \u81EA\u52A8\u5378\u8F7D\u672A\u5B8C\u6210\uFF0C\u8BF7\u624B\u52A8\u6267\u884C: pnpm remove " + toRemove.join(" "));
+  } else {
+    onLogLine?.("[deps] \u51B2\u7A81\u5305\u5DF2\u5378\u8F7D\uFF0C\u5C06\u5B89\u88C5\u9501\u5B9A\u7248\u672C");
+  }
+  const extraInstall = [];
+  if (conflicts.some((c) => c.name === "zod") && hasPackage("@modelcontextprotocol/sdk")) {
+    extraInstall.push("zod");
+  }
+  return extraInstall;
 }
 function shouldUseShell(command) {
   if (process.platform !== "win32") {
@@ -3693,7 +3818,14 @@ function briefErrorMessage(error2) {
   }
   return String(error2).split(/\r?\n/)[0]?.trim() || String(error2);
 }
+function depsVerboseEnabled() {
+  return isTruthyEnv("ADA_DEPS_VERBOSE");
+}
 function shouldEmitPlaywrightCliLine(line) {
+  if (depsVerboseEnabled()) {
+    const t2 = line.trim();
+    return t2.length > 0 && !/^\s*at\s/.test(t2) && !t2.includes("processTicksAndRejections");
+  }
   const t = line.trim();
   if (!t) {
     return false;
@@ -3723,7 +3855,8 @@ function summarizePlaywrightCliLine(line) {
     return "[playwright][warn] \u5F53\u524D\u955C\u50CF\u672A\u5B89\u88C5\u6210\u529F";
   }
   if (/^Progress:/i.test(t)) {
-    return null;
+    const pct = t.match(/(\d{1,3})%/)?.[1];
+    return pct ? `[playwright] \u4E0B\u8F7D\u8FDB\u5EA6 ${pct}%` : "[playwright] \u4E0B\u8F7D\u4E2D\u2026";
   }
   if (t.length > 200) {
     return `[playwright] ${t.slice(0, 120)}\u2026`;
@@ -3735,15 +3868,27 @@ function createPlaywrightInstallLogSink(onLogLine) {
     return void 0;
   }
   const seen = /* @__PURE__ */ new Set();
+  let lastProgressEmitAt = 0;
   return (line) => {
     if (!shouldEmitPlaywrightCliLine(line)) {
       return;
     }
+    if (depsVerboseEnabled()) {
+      onLogLine(line.trimEnd());
+      return;
+    }
     const summary = summarizePlaywrightCliLine(line);
     if (!summary) {
       return;
     }
-    if (seen.has(summary)) {
+    const isProgress = /^Progress:/i.test(line.trim());
+    if (isProgress) {
+      const now = Date.now();
+      if (now - lastProgressEmitAt < 12e3) {
+        return;
+      }
+      lastProgressEmitAt = now;
+    } else if (seen.has(summary)) {
       return;
     }
     seen.add(summary);
@@ -3920,7 +4065,13 @@ function installStrategyTimeoutMs() {
   return parsePositiveMs(process.env.ADA_INSTALL_STRATEGY_TIMEOUT_MS, 12e4);
 }
 function playwrightInstallTimeoutMs() {
-  return parsePositiveMs(process.env.ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS, 9e5);
+  return parsePositiveMs(process.env.ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS, 18e5);
+}
+function playwrightInstallAttemptTimeoutMs(attemptIndex, baseTimeoutMs) {
+  if (attemptIndex <= 0) {
+    return baseTimeoutMs;
+  }
+  return Math.min(baseTimeoutMs, 6e5);
 }
 function majorOf(versionLike) {
   const text = versionLike.trim().replace(/^v/i, "");
@@ -4024,12 +4175,73 @@ function stepMeta(stage) {
     stepTotal: PROGRESS_STEPS.length
   };
 }
+function formatProgressDetail(stage, details) {
+  if (!details) {
+    return null;
+  }
+  if (stage === "registry.probe.result") {
+    const candidate = String(details.candidate ?? "");
+    const latency = details.latencyMs;
+    return `[deps] npm \u955C\u50CF ${candidate} -> ${latency === null || latency === void 0 ? "fail" : `${latency}ms`}`;
+  }
+  if (stage === "playwright.host.probe.result") {
+    const candidate = String(details.candidate ?? "");
+    const latency = details.latencyMs;
+    const artifactOk = details.artifactOk === true;
+    const tail = artifactOk ? "\uFF0C\u6D4F\u89C8\u5668\u5305\u53EF\u4E0B\u8F7D" : latency === null || latency === void 0 ? "" : "\uFF0C\u4EC5\u8FDE\u901A";
+    return `[playwright] CDN ${candidate} -> ${latency === null || latency === void 0 ? "fail" : `${latency}ms`}${tail}`;
+  }
+  if (stage === "packages.install.done") {
+    const strategy = String(details.strategy ?? "");
+    return strategy ? `[deps] \u5305\u5B89\u88C5\u5B8C\u6210\uFF08${strategy}\uFF09` : null;
+  }
+  if (stage === "playwright.browser.install.done") {
+    const host = String(details.selectedHost ?? "");
+    const attempt = details.attempt;
+    return host ? `[playwright] \u6D4F\u89C8\u5668\u5B89\u88C5\u5B8C\u6210\uFF08${host}${attempt ? `\uFF0C\u7B2C ${attempt} \u4E2A\u955C\u50CF` : ""}\uFF09` : null;
+  }
+  return null;
+}
+function structuredLogToHuman(level, payload) {
+  const { event, details } = payload;
+  const d = details && typeof details === "object" ? details : {};
+  if (event === "deps.playwright.browser.install.host.fail") {
+    return `[playwright][warn] \u955C\u50CF ${d.host} \u5931\u8D25 (${d.attempt}): ${d.message}`;
+  }
+  if (event === "deps.install.strategy.try") {
+    return `[deps] \u5C1D\u8BD5\u5B89\u88C5\u7B56\u7565: ${d.strategy}`;
+  }
+  if (event === "deps.install.strategy.ok") {
+    return `[deps] \u5305\u5B89\u88C5\u6210\u529F: ${d.strategy}`;
+  }
+  if (event === "deps.install.strategy.fail") {
+    return `[deps][warn] \u5B89\u88C5\u7B56\u7565\u5931\u8D25 (${d.strategy}): ${d.message}`;
+  }
+  if (event === "deps.registry.auto-selected") {
+    return `[deps] \u9009\u7528 npm \u955C\u50CF: ${d.selected}`;
+  }
+  if (event === "deps.playwright.host.auto-selected") {
+    return `[playwright] CDN \u6D4B\u901F\u6392\u5E8F: ${Array.isArray(d.ranked) ? d.ranked.join(" -> ") : d.selected}`;
+  }
+  if (level === "warn" || level === "error") {
+    const msg = d.message ?? d.detail;
+    return `[deps][${level}] ${event}${msg ? `: ${msg}` : ""}`;
+  }
+  if (depsVerboseEnabled()) {
+    return `[deps] ${event}${Object.keys(d).length > 0 ? ` ${JSON.stringify(d)}` : ""}`;
+  }
+  return null;
+}
 function progress(stage, details) {
   if (depsHumanLog) {
     const label = PROGRESS_HUMAN_LABELS[stage];
     if (label) {
       depsHumanLog(label);
     }
+    const detail = formatProgressDetail(stage, details);
+    if (detail) {
+      depsHumanLog(detail);
+    }
     return;
   }
   const meta3 = stepMeta(stage);
@@ -4044,6 +4256,10 @@ function progress(stage, details) {
 }
 function depsStructuredLog(level, payload) {
   if (depsHumanLog) {
+    const human = structuredLogToHuman(level, payload);
+    if (human) {
+      depsHumanLog(human);
+    }
     return;
   }
   log(level, payload);
@@ -4142,12 +4358,42 @@ function playwrightProbeUrls(host) {
   }
   return [h];
 }
+function isChinaFriendlyNpmRegistry(registry2) {
+  const r = registry2.toLowerCase();
+  return CHINA_NPM_REGISTRY_HINTS.some((hint) => r.includes(hint));
+}
+function isTruthyEnv(name) {
+  const s = String(process.env[name] ?? "").trim().toLowerCase();
+  return s === "1" || s === "true" || s === "yes" || s === "on";
+}
+function playwrightHostConfiguredByUser(config2) {
+  if (process.env.ADA_PLAYWRIGHT_HOST_FROM_PREINSTALL === "1") {
+    return "";
+  }
+  const raw = process.env.PLAYWRIGHT_DOWNLOAD_HOST?.trim() || playwrightDownloadHost(config2).trim();
+  return raw ? normalizeHostUrl(raw) : "";
+}
+function preferPlaywrightHostsForNpmRegistry(ranked, npmRegistry) {
+  if (!isTruthyEnv("ADA_PLAYWRIGHT_PREFER_CN_MIRROR") && !isChinaFriendlyNpmRegistry(npmRegistry)) {
+    return ranked;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const url2 of [...CHINA_PLAYWRIGHT_HOST_PRIORITY, ...ranked]) {
+    const n = normalizeHostUrl(url2);
+    if (!seen.has(n)) {
+      seen.add(n);
+      out.push(n);
+    }
+  }
+  return out;
+}
 function playwrightHostCandidates(config2) {
-  const configured = normalizeHostUrl(playwrightDownloadHost(config2));
+  const configured = playwrightHostConfiguredByUser(config2);
   const fromConfig = Array.isArray(config2.dependencies.playwrightHostCandidates) ? config2.dependencies.playwrightHostCandidates.map((x) => normalizeHostUrl(String(x).trim())).filter(Boolean) : [];
   const configuredList = fromConfig.length > 0 ? fromConfig : [...DEFAULT_PLAYWRIGHT_HOST_CANDIDATES];
   const extra = process.env.ADA_PLAYWRIGHT_HOST_CANDIDATES ? process.env.ADA_PLAYWRIGHT_HOST_CANDIDATES.split(",").map((x) => normalizeHostUrl(x.trim())).filter(Boolean) : [];
-  const ordered = [configured, ...configuredList, ...extra];
+  const ordered = configured ? [configured, ...configuredList, ...extra] : [...configuredList, ...extra];
   const seen = /* @__PURE__ */ new Set();
   const out = [];
   for (const url2 of ordered) {
@@ -4236,7 +4482,9 @@ async function rankPlaywrightHosts(config2) {
   return ranked.length > 0 ? ranked : [...candidates];
 }
 async function runInstallWithPriority(config2, packages, onLogLine) {
-  const specs = resolveInstallPackageSpecs(packages);
+  const extraFromReconcile = await reconcileWorkspacePackageConflicts(packages, onLogLine);
+  const allPackages = Array.from(/* @__PURE__ */ new Set([...packages, ...extraFromReconcile]));
+  const specs = resolveInstallPackageSpecs(allPackages);
   const npmProxy = await detectBestRegistry(config2, npmProxyRegistry());
   const pnpmProxy = await detectBestRegistry(config2, pnpmProxyRegistry());
   progress("packages.install.start", { packages: specs, npmProxy, pnpmProxy });
@@ -4281,6 +4529,7 @@ async function runInstallWithPriority(config2, packages, onLogLine) {
   let lastError = void 0;
   for (const strategy of strategies) {
     try {
+      onLogLine?.(`[deps] \u5C1D\u8BD5 ${strategy.name} \u5B89\u88C5\u5305\u2026`);
       depsStructuredLog("info", { event: "deps.install.strategy.try", details: { strategy: strategy.name, packages } });
       await strategy.run();
       depsStructuredLog("info", { event: "deps.install.strategy.ok", details: { strategy: strategy.name } });
@@ -4397,24 +4646,32 @@ async function installPlaywrightBrowser(config2, onLogLine, options) {
   if (targets.length > 0) {
     installArgs.push(...targets);
   }
-  const rankedHosts = await rankPlaywrightHosts(config2);
-  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`);
+  const npmRegistry = await detectBestRegistry(config2, npmProxyRegistry());
+  let rankedHosts = await rankPlaywrightHosts(config2);
+  rankedHosts = preferPlaywrightHostsForNpmRegistry(rankedHosts, npmRegistry);
+  const baseTimeoutMs = playwrightInstallTimeoutMs();
+  onLogLine?.(
+    `[playwright] \u5B89\u88C5\u8D85\u65F6\uFF1A\u9996\u4E2A\u955C\u50CF ${Math.round(baseTimeoutMs / 1e3)}s\uFF0C\u540E\u7EED\u955C\u50CF\u81F3\u591A 600s\uFF08ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS \u53EF\u8C03\uFF09`
+  );
+  if (isChinaFriendlyNpmRegistry(npmRegistry) || isTruthyEnv("ADA_PLAYWRIGHT_PREFER_CN_MIRROR")) {
+    onLogLine?.(`[playwright] \u56FD\u5185 npm \u6E90 ${npmRegistry}\uFF0C\u4F18\u5148 npmmirror Playwright CDN`);
+  }
   let lastHost = "";
   for (let i = 0; i < rankedHosts.length; i++) {
     const host = rankedHosts[i];
+    const attemptTimeoutMs = playwrightInstallAttemptTimeoutMs(i, baseTimeoutMs);
     lastHost = host;
     if (i > 0) {
-      onLogLine?.(`[playwright] \u6362\u955C\u50CF: ${host}`);
+      onLogLine?.(`[playwright] \u6362\u955C\u50CF (${i + 1}/${rankedHosts.length}): ${host}`);
     } else {
       onLogLine?.(
-        `[playwright] playwright@${version2}\uFF0CCDN ${host}\uFF0C\u76EE\u6807 ${targets.length ? targets.join(",") : "chromium"}`
+        `[playwright] playwright@${version2}\uFF0CCDN ${host}\uFF08${i + 1}/${rankedHosts.length}\uFF09\uFF0C\u76EE\u6807 ${targets.length ? targets.join(",") : "chromium"}`
       );
     }
     try {
       await runCommand2(command, installArgs, {
         env: { PLAYWRIGHT_DOWNLOAD_HOST: host },
-        timeoutMs,
+        timeoutMs: attemptTimeoutMs,
         onLogLine: createPlaywrightInstallLogSink(onLogLine)
       });
       progress("playwright.browser.install.done", { selectedHost: host, attempt: i + 1 });
@@ -4433,7 +4690,7 @@ async function installPlaywrightBrowser(config2, onLogLine, options) {
     }
   }
   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`
+    `[playwright][warn] \u6D4F\u89C8\u5668\u672A\u5B89\u88C5\u5B8C\u6210\uFF08\u5DF2\u5C1D\u8BD5 ${rankedHosts.length} \u4E2A CDN\uFF09\u3002\u56FD\u5185\u5EFA\u8BAE: set PLAYWRIGHT_DOWNLOAD_HOST=https://cdn.npmmirror.com/binaries/playwright \u5E76\u589E\u5927 ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS=1800000\uFF1B\u6216\u624B\u52A8: npx playwright@${PINNED_PLAYWRIGHT_VERSION} install chromium`
   );
   if (lastHost) {
     onLogLine?.(`[playwright][warn] \u6700\u540E\u5C1D\u8BD5: ${lastHost}`);
@@ -4925,7 +5182,7 @@ async function getDependencyHealth(config2) {
     missingAppiumDrivers
   };
 }
-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 import_node_module, import_node_fs, import_node_child_process2, import_promises5, import_node_path5, require2, PINNED_PLAYWRIGHT_VERSION, PINNED_ZOD_VERSION, depsHumanLog, DEFAULT_NPM_REGISTRY_CANDIDATES, detectedBestRegistryByKey, PROGRESS_STEPS, PROGRESS_HUMAN_LABELS, DEFAULT_PLAYWRIGHT_HOST_CANDIDATES, CHINA_NPM_REGISTRY_HINTS, CHINA_PLAYWRIGHT_HOST_PRIORITY, PLAYWRIGHT_HOST_FALLBACK, PW_INSTALL_TARGETS;
 var init_dependency_installer = __esm({
   "../ada-agent/src/dependency-installer.ts"() {
     import_node_module = require("node:module");
@@ -4938,6 +5195,7 @@ var init_dependency_installer = __esm({
     init_src2();
     require2 = (0, import_node_module.createRequire)(import_node_path5.default.join(process.cwd(), "package.json"));
     PINNED_PLAYWRIGHT_VERSION = "1.59.1";
+    PINNED_ZOD_VERSION = "3.25.76";
     DEFAULT_NPM_REGISTRY_CANDIDATES = [
       "https://registry.npmmirror.com",
       "https://mirrors.cloud.tencent.com/npm",
@@ -4958,9 +5216,16 @@ var init_dependency_installer = __esm({
       "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",
+      "packages.install.done": "[deps] npm \u5305\u5B89\u88C5\u5B8C\u6210",
       "playwright.host.probe.start": "[playwright] \u63A2\u6D4B\u6D4F\u89C8\u5668 CDN\u2026",
       "playwright.browser.install.start": "[playwright] \u5B89\u88C5\u6D4F\u89C8\u5668\u2026",
+      "playwright.browser.install.done": "[playwright] \u6D4F\u89C8\u5668\u5B89\u88C5\u5B8C\u6210",
+      "playwright.selfcheck.start": "[playwright] \u81EA\u68C0\u2026",
+      "playwright.selfcheck.done": "[playwright] \u81EA\u68C0\u5B8C\u6210",
       "appium.driver.ensure.start": "[appium] \u5B89\u88C5\u9A71\u52A8\u2026",
+      "appium.driver.ensure.done": "[appium] \u9A71\u52A8\u5B89\u88C5\u5B8C\u6210",
+      "selenium.check.start": "[selenium] \u68C0\u6D4B\u539F\u751F\u9A71\u52A8\u2026",
+      "selenium.check.done": "[selenium] \u68C0\u6D4B\u5B8C\u6210",
       "deps.ensure.done": "[deps] \u4F9D\u8D56\u68C0\u6D4B\u5B8C\u6210"
     };
     DEFAULT_PLAYWRIGHT_HOST_CANDIDATES = [
@@ -4969,6 +5234,11 @@ var init_dependency_installer = __esm({
       "https://npmmirror.com/mirrors/playwright",
       "https://cdn.npmmirror.com/binaries/playwright"
     ];
+    CHINA_NPM_REGISTRY_HINTS = ["npmmirror.com", "tencent", "huaweicloud", "huawei.com"];
+    CHINA_PLAYWRIGHT_HOST_PRIORITY = [
+      "https://cdn.npmmirror.com/binaries/playwright",
+      "https://npmmirror.com/mirrors/playwright"
+    ];
     PLAYWRIGHT_HOST_FALLBACK = DEFAULT_PLAYWRIGHT_HOST_CANDIDATES[0];
     PW_INSTALL_TARGETS = /* @__PURE__ */ new Set([
       "chromium",
@@ -32848,7 +33118,9 @@ function resolveBootstrapInstallDeps(argv2) {
 }
 var PREINSTALL_PLAYWRIGHT_HOST_ALLOW = /* @__PURE__ */ new Set([
   "https://cdn.playwright.dev",
-  "https://playwright.azureedge.net"
+  "https://playwright.azureedge.net",
+  "https://cdn.npmmirror.com/binaries/playwright",
+  "https://npmmirror.com/mirrors/playwright"
 ]);
 function normalizePlaywrightHost(url2) {
   return url2.replace(/\/$/, "");
@@ -32866,7 +33138,8 @@ function applyPreinstallPlaywrightHostFile() {
       const host = normalizePlaywrightHost(import_node_fs3.default.readFileSync(file2, "utf8").trim());
       if (host.length > 0 && PREINSTALL_PLAYWRIGHT_HOST_ALLOW.has(host)) {
         process.env.PLAYWRIGHT_DOWNLOAD_HOST = host;
-        console.error(`[ADA-MCP] using playwright CDN from ${file2}: ${host}`);
+        process.env.ADA_PLAYWRIGHT_HOST_FROM_PREINSTALL = "1";
+        console.error(`[ADA-MCP] using playwright CDN from ${file2}: ${host} (install-deps \u5C06\u91CD\u65B0\u6D4B\u901F\u6392\u5E8F)`);
         return;
       }
       if (host.length > 0) {
@@ -32884,7 +33157,7 @@ function ensureDefaultInstallTimeouts() {
     process.env.ADA_INSTALL_STRATEGY_TIMEOUT_MS = "120000";
   }
   if (!process.env.ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS?.trim()) {
-    process.env.ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS = "900000";
+    process.env.ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS = "1800000";
   }
 }
 async function runBootstrapInstallDeps(argv2) {

package/package.json

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

package/scripts/preinstall-probes.mjs

@@ -62,11 +62,16 @@ async function main() {
     console.error(`[ada-mcp preinstall]   registry ${candidate} -> ${latency === null ? "fail" : `${latency}ms`}`);
   }
 
-  /** preinstall 阶段依赖尚未安装，无法校验浏览器包是否存在；仅测官方 CDN，避免写入国内镜像后 404 */
-  const pwCandidates = [
-    "https://cdn.playwright.dev",
-    "https://playwright.azureedge.net"
-  ];
+  const chinaRegistry = /npmmirror|tencent|huaweicloud|huawei\.com/i.test(reg.best);
+  /** preinstall 无 playwright 包时无法 HEAD 浏览器包；国内 registry 时优先写入 npmmirror CDN */
+  const pwCandidates = chinaRegistry
+    ? [
+        "https://cdn.npmmirror.com/binaries/playwright",
+        "https://npmmirror.com/mirrors/playwright",
+        "https://cdn.playwright.dev",
+        "https://playwright.azureedge.net"
+      ]
+    : ["https://cdn.playwright.dev", "https://playwright.azureedge.net"];
   const pw = await detectBestPlaywrightHost(pwCandidates);
   const hostFile = path.join(root, ".ada-mcp-playwright-host");
   fs.writeFileSync(hostFile, `${pw.best}\n`, "utf8");