@ada-mcp/mcp-server 0.1.7 → 0.1.9

package/README.md

@@ -8,25 +8,25 @@ ADA MCP server package that supports:
 
 ## 标准安装（Cursor / MCP）
 
-请使用 **`@ada-mcp/launcher@0.1.2`** 拉起本包（见 [launcher README](../ada-mcp-launcher/README.md)）：
+请使用 **`@ada-mcp/launcher@0.1.3`** 拉起本包（见 [launcher README](../ada-mcp-launcher/README.md)）：
 
 ```json
 {
   "mcpServers": {
     "ada-mcp": {
       "command": "pnpm",
-      "args": ["dlx", "@ada-mcp/launcher@0.1.2"]
+      "args": ["dlx", "@ada-mcp/launcher@0.1.3"]
     }
   }
 }
 ```
 
-本包版本：**`@ada-mcp/mcp-server@0.1.6`**（由 launcher 默认拉取）。
+本包版本：**`@ada-mcp/mcp-server@0.1.7`**（由 launcher 默认拉取）。
 
 直接调试本包（无 launcher 拉包前测速）：
 
 ```bash
-pnpm dlx @ada-mcp/mcp-server@0.1.6
+pnpm dlx @ada-mcp/mcp-server@0.1.7
 ```
 
 ## 启动时自动安装依赖（默认仅 Playwright）
@@ -81,12 +81,12 @@ pnpm dlx @ada-mcp/mcp-server@0.1.6
 在标准 `args` 后追加，例如安装全部依赖：
 
 ```json
-"args": ["dlx", "@ada-mcp/launcher@0.1.2", "--install-deps=all"]
+"args": ["dlx", "@ada-mcp/launcher@0.1.3", "--install-deps=all"]
 ```
 
 ## Cursor MCP 配置
 
-与上文**标准配置**相同：`pnpm` + `dlx @ada-mcp/launcher@0.1.2`。
+与上文**标准配置**相同：`pnpm` + `dlx @ada-mcp/launcher@0.1.3`。
 
 Windows 若找不到 `pnpm`，可写完整路径，例如 `C:\\Users\\<你>\\AppData\\Roaming\\npm\\pnpm.cmd`，或改用 npx：
 

package/dist/cli.cjs

@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/bootstrap-deps.ts
-var import_node_fs2 = __toESM(require("node:fs"));
+var import_node_fs3 = __toESM(require("node:fs"));
 var import_node_path10 = __toESM(require("node:path"));
 
 // ../ada-agent/dist/config.js
@@ -2720,7 +2720,7 @@ function createJsonLogger(source) {
 }
 
 // ../ada-agent/dist/bundled-config.generated.js
-var bundledDefaultConfigYaml = 'agent:\r\n  id: "ada-agent-local"\r\n  mode: "foreground"\r\n  setupOnFirstRun: true\r\n\r\nbootstrapUI:\r\n  enabled: true\r\n  mode: "auto" # auto | cli | gui\r\n  host: "127.0.0.1"\r\n  port: 17650\r\n  autoOpenBrowser: true\r\n  sessionTtlSec: 600\r\n  secretsProvider: "auto" # auto | keychain | credman | file\r\n  native:\r\n    enabled: false\r\n    command: "" # e.g. ./bootstrap-ui / .\\bootstrap-ui.exe\r\n    args: []\r\n    timeoutMs: 120000\r\n    fallbackToWeb: true\r\n\r\ntransport:\r\n  mode: "auto"\r\n  streamProtocol: "websocket"\r\n  requestPath: "/api/v1/execute"\r\n  healthPath: "/health"\r\n  streamPath: "/ws"\r\n  requestTimeoutMs: 15000\r\n\r\ngraphics:\r\n  enabled: false\r\n  fallbackOnSemanticFailure: false\r\n  minConfidence: 0.8\r\n\r\nmonitoring:\r\n  enabled: false\r\n  platforms: ["web", "android", "ios", "harmony"] # \u53EF\u9009\u5B50\u96C6\r\n  sampleEvery: 1 # \u6BCF N \u6761\u64CD\u4F5C\u91C7\u6837\u4E00\u6B21\uFF0C1 \u8868\u793A\u5168\u91CF\r\n  outputDir: "artifacts/monitoring"\r\n  onFailureOnly: false # true \u65F6\u4EC5\u5931\u8D25\u64CD\u4F5C\u6293\u56FE\uFF0C\u6027\u80FD\u66F4\u4F18\r\n  groupBySession: true # \u6309 sessionId/requestId \u5206\u5C42\u5F52\u6863\r\n  nonBlocking: true # true \u65F6\u76D1\u63A7\u5F02\u6B65\u6267\u884C\uFF0C\u4E0D\u963B\u585E\u4E3B\u94FE\u8DEF\r\n  resolution:\r\n    maxWidth: 1280\r\n    maxHeight: 720\r\n    keepAspectRatio: true # \u4FDD\u6301\u6BD4\u4F8B\uFF0C\u907F\u514D\u76D1\u63A7\u56FE\u50CF\u53D8\u5F62\r\n\r\nqueue:\r\n  inboxDir: "tasks/inbox"\r\n  processedDir: "tasks/processed"\r\n  failedDir: "tasks/failed"\r\n  pollIntervalMs: 3000\r\n  maxFileRetryAttempts: 2\r\n\r\ndependencies:\r\n  autoInstallOnStart: true\r\n  playwrightBrowser: "chromium" # chromium | firefox | webkit | all\r\n  playwrightInstallTargets: ["chrome"] # chromium | chrome | msedge | firefox | webkit | all\r\n  playwrightDownloadHost: "https://npmmirror.com/mirrors/playwright"\r\n  npmRegistryCandidates:\r\n    - "https://registry.npmmirror.com"\r\n    - "https://mirrors.cloud.tencent.com/npm"\r\n    - "https://repo.huaweicloud.com/repository/npm"\r\n    - "https://registry.npmjs.org"\r\n  playwrightHostCandidates:\r\n    - "https://npmmirror.com/mirrors/playwright"\r\n    - "https://playwright.azureedge.net"\r\n  # \u539F\u751F WebDriver\uFF08geckodriver / chromedriver\uFF09\u7EDF\u4E00\u653E\u5728\u9879\u76EE dirver \u76EE\u5F55\r\n  nativeDriversDir: "dirver"\r\n  geckodriverVersion: "latest" # \u5982 0.36.0\uFF1Binstall-deps --only=selenium \u65F6\u4E0B\u8F7D\u5230\u6B64\u76EE\u5F55\r\n  chromedriverVersion: "latest" # \u5982 137\u3001135\u3001match-chrome\uFF08\u5339\u914D\u672C\u673A Chrome \u4E3B\u7248\u672C\uFF09\r\n\r\nappium:\r\n  serverUrl: "http://127.0.0.1:4723"\r\n  requiredDrivers: ["uiautomator2", "xcuitest", "harmonyos"]\r\n';
+var bundledDefaultConfigYaml = 'agent:\r\n  id: "ada-agent-local"\r\n  mode: "foreground"\r\n  setupOnFirstRun: true\r\n\r\nbootstrapUI:\r\n  enabled: true\r\n  mode: "auto" # auto | cli | gui\r\n  host: "127.0.0.1"\r\n  port: 17650\r\n  autoOpenBrowser: true\r\n  sessionTtlSec: 600\r\n  secretsProvider: "auto" # auto | keychain | credman | file\r\n  native:\r\n    enabled: false\r\n    command: "" # e.g. ./bootstrap-ui / .\\bootstrap-ui.exe\r\n    args: []\r\n    timeoutMs: 120000\r\n    fallbackToWeb: true\r\n\r\ntransport:\r\n  mode: "auto"\r\n  streamProtocol: "websocket"\r\n  requestPath: "/api/v1/execute"\r\n  healthPath: "/health"\r\n  streamPath: "/ws"\r\n  requestTimeoutMs: 15000\r\n\r\ngraphics:\r\n  enabled: false\r\n  fallbackOnSemanticFailure: false\r\n  minConfidence: 0.8\r\n\r\nmonitoring:\r\n  enabled: false\r\n  platforms: ["web", "android", "ios", "harmony"] # \u53EF\u9009\u5B50\u96C6\r\n  sampleEvery: 1 # \u6BCF N \u6761\u64CD\u4F5C\u91C7\u6837\u4E00\u6B21\uFF0C1 \u8868\u793A\u5168\u91CF\r\n  outputDir: "artifacts/monitoring"\r\n  onFailureOnly: false # true \u65F6\u4EC5\u5931\u8D25\u64CD\u4F5C\u6293\u56FE\uFF0C\u6027\u80FD\u66F4\u4F18\r\n  groupBySession: true # \u6309 sessionId/requestId \u5206\u5C42\u5F52\u6863\r\n  nonBlocking: true # true \u65F6\u76D1\u63A7\u5F02\u6B65\u6267\u884C\uFF0C\u4E0D\u963B\u585E\u4E3B\u94FE\u8DEF\r\n  resolution:\r\n    maxWidth: 1280\r\n    maxHeight: 720\r\n    keepAspectRatio: true # \u4FDD\u6301\u6BD4\u4F8B\uFF0C\u907F\u514D\u76D1\u63A7\u56FE\u50CF\u53D8\u5F62\r\n\r\nqueue:\r\n  inboxDir: "tasks/inbox"\r\n  processedDir: "tasks/processed"\r\n  failedDir: "tasks/failed"\r\n  pollIntervalMs: 3000\r\n  maxFileRetryAttempts: 2\r\n\r\ndependencies:\r\n  autoInstallOnStart: true\r\n  playwrightBrowser: "chromium" # chromium | firefox | webkit | all\r\n  playwrightInstallTargets: ["chromium"] # chromium | chrome | msedge | firefox | webkit | all\r\n  playwrightDownloadHost: "https://cdn.playwright.dev"\r\n  # \u56FD\u5185 npm \u955C\u50CF\uFF08\u6309\u4F18\u5148\u7EA7\uFF1Binstall-deps \u542F\u52A8\u65F6\u6D4B\u901F\u9009\u6700\u5FEB\uFF0C\u65E0\u9700\u7528\u6237\u914D\u7F6E\uFF09\r\n  npmRegistryCandidates:\r\n    - "https://registry.npmmirror.com" # \u963F\u91CC\u4E91 / npmmirror\uFF08\u63A8\u8350\uFF09\r\n    - "https://mirrors.cloud.tencent.com/npm" # \u817E\u8BAF\u4E91\r\n    - "https://repo.huaweicloud.com/repository/npm" # \u534E\u4E3A\u4E91\r\n    - "https://registry.npmjs.org" # \u5B98\u65B9\u515C\u5E95\r\n  playwrightHostCandidates:\r\n    - "https://cdn.playwright.dev"\r\n    - "https://playwright.azureedge.net"\r\n    - "https://npmmirror.com/mirrors/playwright"\r\n    - "https://cdn.npmmirror.com/binaries/playwright"\r\n  # \u539F\u751F WebDriver\uFF08geckodriver / chromedriver\uFF09\u7EDF\u4E00\u653E\u5728\u9879\u76EE dirver \u76EE\u5F55\r\n  nativeDriversDir: "dirver"\r\n  geckodriverVersion: "latest" # \u5982 0.36.0\uFF1Binstall-deps --only=selenium \u65F6\u4E0B\u8F7D\u5230\u6B64\u76EE\u5F55\r\n  chromedriverVersion: "latest" # \u5982 137\u3001135\u3001match-chrome\uFF08\u5339\u914D\u672C\u673A Chrome \u4E3B\u7248\u672C\uFF09\r\n\r\nappium:\r\n  serverUrl: "http://127.0.0.1:4723"\r\n  requiredDrivers: ["uiautomator2", "xcuitest", "harmonyos"]\r\n';
 
 // ../ada-agent/dist/config.js
 var DEFAULT_CONFIG_RELATIVE = import_node_path2.default.join("config", "default.yaml");
@@ -2785,8 +2785,8 @@ var defaultConfig = {
   dependencies: {
     autoInstallOnStart: true,
     playwrightBrowser: "chromium",
-    playwrightInstallTargets: ["chrome"],
-    playwrightDownloadHost: "https://npmmirror.com/mirrors/playwright",
+    playwrightInstallTargets: ["chromium"],
+    playwrightDownloadHost: "https://cdn.playwright.dev",
     npmRegistryCandidates: [
       "https://registry.npmmirror.com",
       "https://mirrors.cloud.tencent.com/npm",
@@ -2794,8 +2794,10 @@ var defaultConfig = {
       "https://registry.npmjs.org"
     ],
     playwrightHostCandidates: [
+      "https://cdn.playwright.dev",
+      "https://playwright.azureedge.net",
       "https://npmmirror.com/mirrors/playwright",
-      "https://playwright.azureedge.net"
+      "https://cdn.npmmirror.com/binaries/playwright"
     ],
     nativeDriversDir: "dirver",
     geckodriverVersion: "latest",
@@ -2906,6 +2908,7 @@ async function loadSecret(provider, cwd = process.cwd()) {
 
 // ../ada-agent/dist/dependency-installer.js
 var import_node_module = require("node:module");
+var import_node_fs = require("node:fs");
 var import_node_child_process2 = require("node:child_process");
 var import_promises5 = __toESM(require("node:fs/promises"), 1);
 var import_node_path5 = __toESM(require("node:path"), 1);
@@ -3544,19 +3547,51 @@ function playwrightInstallTargets(config) {
   const legacy = browserArg(config);
   return legacy ? [legacy] : [];
 }
+function expandPlaywrightInstallTargets(targets) {
+  if (targets.length === 0) {
+    return targets;
+  }
+  const lower = targets.map((x) => x.toLowerCase());
+  if (lower.includes("chromium") || lower.includes("firefox") || lower.includes("webkit")) {
+    return lower;
+  }
+  const channelOnly = lower.every((x) => x === "chrome" || x === "msedge");
+  if (channelOnly) {
+    return ["chromium", ...lower];
+  }
+  return lower;
+}
+function resolveBundledPlaywrightCli() {
+  const pkgPath = require2.resolve("playwright/package.json");
+  const root = import_node_path5.default.dirname(pkgPath);
+  const raw = (0, import_node_fs.readFileSync)(pkgPath, "utf8");
+  const version = String(JSON.parse(raw).version ?? "");
+  return { command: "node", cliArgs: [import_node_path5.default.join(root, "cli.js")], version };
+}
 function requiredAppiumDrivers(config) {
   return Array.from(new Set(config.appium.requiredDrivers ?? []));
 }
+var DEFAULT_NPM_REGISTRY_CANDIDATES = [
+  "https://registry.npmmirror.com",
+  "https://mirrors.cloud.tencent.com/npm",
+  "https://repo.huaweicloud.com/repository/npm",
+  "https://registry.npmjs.org"
+];
 function npmProxyRegistry() {
-  return process.env.ADA_NPM_PROXY_REGISTRY ?? "https://registry.npmmirror.com";
+  return process.env.ADA_NPM_PROXY_REGISTRY ?? DEFAULT_NPM_REGISTRY_CANDIDATES[0];
 }
 function pnpmProxyRegistry() {
   return process.env.ADA_PNPM_PROXY_REGISTRY ?? npmProxyRegistry();
 }
+function parsePositiveMs(raw, fallback) {
+  const parsed = raw ? Number(raw) : fallback;
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
 function installStrategyTimeoutMs() {
-  const raw = process.env.ADA_INSTALL_STRATEGY_TIMEOUT_MS;
-  const parsed = raw ? Number(raw) : 2e4;
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : 2e4;
+  return parsePositiveMs(process.env.ADA_INSTALL_STRATEGY_TIMEOUT_MS, 12e4);
+}
+function playwrightInstallTimeoutMs() {
+  return parsePositiveMs(process.env.ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS, 9e5);
 }
 function majorOf(versionLike) {
   const text = versionLike.trim().replace(/^v/i, "");
@@ -3679,10 +3714,23 @@ function normalizeRegistryUrl(url) {
 }
 function registryCandidates(config, baseProxy) {
   const primary = normalizeRegistryUrl(baseProxy);
-  const configured = Array.isArray(config.dependencies.npmRegistryCandidates) ? config.dependencies.npmRegistryCandidates.map((x) => normalizeRegistryUrl(String(x).trim())).filter(Boolean) : [];
-  const fallback = "https://registry.npmjs.org";
+  const fromConfig = Array.isArray(config.dependencies.npmRegistryCandidates) ? config.dependencies.npmRegistryCandidates.map((x) => normalizeRegistryUrl(String(x).trim())).filter(Boolean) : [];
+  const configured = fromConfig.length > 0 ? fromConfig : [...DEFAULT_NPM_REGISTRY_CANDIDATES];
   const extra = process.env.ADA_REGISTRY_CANDIDATES ? process.env.ADA_REGISTRY_CANDIDATES.split(",").map((x) => normalizeRegistryUrl(x.trim())).filter(Boolean) : [];
-  return Array.from(/* @__PURE__ */ new Set([primary, ...configured, ...extra, fallback]));
+  const ordered = [primary, ...configured, ...extra];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const url of ordered) {
+    if (!seen.has(url)) {
+      seen.add(url);
+      out.push(url);
+    }
+  }
+  return out;
+}
+function registryPriorityIndex(candidates, registry) {
+  const idx = candidates.indexOf(normalizeRegistryUrl(registry));
+  return idx >= 0 ? idx : Number.POSITIVE_INFINITY;
 }
 async function probeRegistryLatency(registry) {
   const target = `${normalizeRegistryUrl(registry)}/appium`;
@@ -3718,14 +3766,17 @@ async function detectBestRegistry(config, baseProxy) {
     progress("registry.probe.result", { candidate, latencyMs: latency });
     return { candidate, latency };
   }));
-  let best = normalizeRegistryUrl(baseProxy);
+  let best = candidates[0] ?? normalizeRegistryUrl(baseProxy);
   let bestLatency = Number.POSITIVE_INFINITY;
+  let bestPriority = Number.POSITIVE_INFINITY;
   for (const { candidate, latency } of probeResults) {
     if (latency === null)
       continue;
-    if (latency < bestLatency) {
+    const priority = registryPriorityIndex(candidates, candidate);
+    if (latency < bestLatency || latency === bestLatency && priority < bestPriority) {
       best = candidate;
       bestLatency = latency;
+      bestPriority = priority;
     }
   }
   detectedBestRegistryByKey.set(cacheKey, best);
@@ -3744,19 +3795,46 @@ function playwrightDownloadHost(config) {
 function normalizeHostUrl(url) {
   return url.replace(/\/$/, "");
 }
+var DEFAULT_PLAYWRIGHT_HOST_CANDIDATES = [
+  "https://cdn.playwright.dev",
+  "https://playwright.azureedge.net",
+  "https://npmmirror.com/mirrors/playwright",
+  "https://cdn.npmmirror.com/binaries/playwright"
+];
+var PLAYWRIGHT_HOST_FALLBACK = DEFAULT_PLAYWRIGHT_HOST_CANDIDATES[0];
+function playwrightProbeUrls(host) {
+  const h = normalizeHostUrl(host);
+  if (h.includes("npmmirror.com/mirrors/playwright")) {
+    return [h, "https://cdn.npmmirror.com/binaries/playwright"];
+  }
+  return [h];
+}
 function playwrightHostCandidates(config) {
   const configured = normalizeHostUrl(playwrightDownloadHost(config));
-  const configuredCandidates = Array.isArray(config.dependencies.playwrightHostCandidates) ? config.dependencies.playwrightHostCandidates.map((x) => normalizeHostUrl(String(x).trim())).filter(Boolean) : [];
-  const fallback = "https://playwright.azureedge.net";
+  const fromConfig = Array.isArray(config.dependencies.playwrightHostCandidates) ? config.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) : [];
-  return Array.from(/* @__PURE__ */ new Set([configured, ...configuredCandidates, ...extra, fallback]));
+  const ordered = [configured, ...configuredList, ...extra];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const url of ordered) {
+    if (!seen.has(url)) {
+      seen.add(url);
+      out.push(url);
+    }
+  }
+  return out;
 }
-async function probeHostLatency(host) {
+function playwrightHostPriorityIndex(candidates, host) {
+  const idx = candidates.indexOf(normalizeHostUrl(host));
+  return idx >= 0 ? idx : Number.POSITIVE_INFINITY;
+}
+async function probeUrlLatency(url) {
   const started = Date.now();
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), 5e3);
   try {
-    const response = await fetch(host, {
+    const response = await fetch(url, {
       method: "GET",
       redirect: "manual",
       signal: controller.signal
@@ -3771,6 +3849,16 @@ async function probeHostLatency(host) {
     clearTimeout(timer);
   }
 }
+async function probePlaywrightHostLatency(host) {
+  let best = null;
+  for (const url of playwrightProbeUrls(host)) {
+    const latency = await probeUrlLatency(url);
+    if (latency !== null && (best === null || latency < best)) {
+      best = latency;
+    }
+  }
+  return best;
+}
 async function detectBestPlaywrightHost(config) {
   if (detectedBestPlaywrightHost) {
     return detectedBestPlaywrightHost;
@@ -3779,18 +3867,21 @@ async function detectBestPlaywrightHost(config) {
   progress("playwright.host.probe.start", { candidates });
   const probeResults = await Promise.all(candidates.map(async (candidate) => {
     progress("playwright.host.probe.try", { candidate });
-    const latency = await probeHostLatency(candidate);
+    const latency = await probePlaywrightHostLatency(candidate);
     progress("playwright.host.probe.result", { candidate, latencyMs: latency });
     return { candidate, latency };
   }));
-  let best = normalizeHostUrl(playwrightDownloadHost(config));
+  let best = candidates[0] ?? PLAYWRIGHT_HOST_FALLBACK;
   let bestLatency = Number.POSITIVE_INFINITY;
+  let bestPriority = Number.POSITIVE_INFINITY;
   for (const { candidate, latency } of probeResults) {
     if (latency === null)
       continue;
-    if (latency < bestLatency) {
+    const priority = playwrightHostPriorityIndex(candidates, candidate);
+    if (latency < bestLatency || latency === bestLatency && priority < bestPriority) {
       best = candidate;
       bestLatency = latency;
+      bestPriority = priority;
     }
   }
   detectedBestPlaywrightHost = best;
@@ -3807,7 +3898,7 @@ async function runInstallWithPriority(config, packages, onLogLine) {
   const npmProxy = await detectBestRegistry(config, npmProxyRegistry());
   const pnpmProxy = await detectBestRegistry(config, pnpmProxyRegistry());
   progress("packages.install.start", { packages, npmProxy, pnpmProxy });
-  onLogLine?.(`[deps] \u5728\u7EBF\u5B89\u88C5\u5305: ${packages.join(" ")} (\u987A\u5E8F: pnpm -> pnpm-proxy -> npm -> npm-proxy)`);
+  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)`);
   const strategies = [
     {
       name: "pnpm",
@@ -3928,16 +4019,29 @@ async function verifyPlaywrightSelfTest(onLogLine) {
     await b.close();
   }
 }
-async function installPlaywrightBrowser(config, onLogLine) {
-  const targets = playwrightInstallTargets(config);
+async function installPlaywrightBrowser(config, onLogLine, options) {
+  const rawTargets = playwrightInstallTargets(config);
+  const targets = expandPlaywrightInstallTargets(rawTargets);
+  if (rawTargets.length > 0 && targets.length > rawTargets.length) {
+    onLogLine?.("[playwright] \u914D\u7F6E\u4EC5\u542B chrome/msedge \u901A\u9053\uFF0C\u5DF2\u81EA\u52A8\u52A0\u5165 chromium\uFF08\u81EA\u68C0\u9700 Playwright \u5185\u7F6E\u6D4F\u89C8\u5668\uFF09");
+  }
   progress("playwright.browser.install.start", { targets: targets.length > 0 ? targets : ["all"] });
   onLogLine?.("[playwright] \u5F00\u59CB\u5728\u7EBF\u5B89\u88C5\u6D4F\u89C8\u5668");
-  const args = targets.length > 0 ? ["exec", "playwright", "install", ...targets] : ["exec", "playwright", "install"];
+  const { command, cliArgs, version } = resolveBundledPlaywrightCli();
+  const installArgs = [...cliArgs, "install"];
+  if (options?.force) {
+    installArgs.push("--force");
+  }
+  if (targets.length > 0) {
+    installArgs.push(...targets);
+  }
   const selectedHost = await detectBestPlaywrightHost(config);
-  onLogLine?.(`[playwright] \u4E0B\u8F7D\u6D4F\u89C8\u5668\uFF08\u955C\u50CF ${selectedHost}\uFF09\uFF0C\u76EE\u6807: ${targets.length ? targets.join(",") : "all"}`);
-  await runCommand2("npm", args, {
+  onLogLine?.(`[playwright] \u4F7F\u7528\u5185\u7F6E playwright@${version} CLI\uFF0C\u955C\u50CF ${selectedHost}\uFF0C\u76EE\u6807: ${targets.length ? targets.join(",") : "all"}${options?.force ? " (--force)" : ""}`);
+  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`);
+  await runCommand2(command, installArgs, {
     env: { PLAYWRIGHT_DOWNLOAD_HOST: selectedHost },
-    timeoutMs: installStrategyTimeoutMs(),
+    timeoutMs,
     onLogLine
   });
   progress("playwright.browser.install.done", { selectedHost });
@@ -4191,7 +4295,9 @@ async function ensureDriverDependencies(config, options) {
       if (force) {
         onLogLine?.(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);
+      await installPlaywrightBrowser(configForPlaywright, onLogLine, {
+        force: force || reinstallForTargets || !launchOk
+      });
       progress("playwright.selfcheck.verify");
       await verifyPlaywrightSelfTest(onLogLine);
       state.playwrightReady = true;
@@ -4364,7 +4470,7 @@ function getString(value) {
 }
 
 // ../../packages/plugin-host/src/index.ts
-var import_node_fs = __toESM(require("node:fs"), 1);
+var import_node_fs2 = __toESM(require("node:fs"), 1);
 var import_node_path6 = __toESM(require("node:path"), 1);
 var import_node_module2 = require("node:module");
 function assertManifest(plugin) {
@@ -4516,10 +4622,10 @@ function loadPluginFromModule(requireFn, moduleId) {
   }
 }
 function registerPluginsFromDirectory(host, pluginDir) {
-  if (!import_node_fs.default.existsSync(pluginDir)) {
+  if (!import_node_fs2.default.existsSync(pluginDir)) {
     return [];
   }
-  const entries = import_node_fs.default.readdirSync(pluginDir, { withFileTypes: true }).filter((ent) => ent.isFile() && (ent.name.endsWith(".cjs") || ent.name.endsWith(".js"))).map((ent) => import_node_path6.default.join(pluginDir, ent.name)).sort((a, b) => a.localeCompare(b));
+  const entries = import_node_fs2.default.readdirSync(pluginDir, { withFileTypes: true }).filter((ent) => ent.isFile() && (ent.name.endsWith(".cjs") || ent.name.endsWith(".js"))).map((ent) => import_node_path6.default.join(pluginDir, ent.name)).sort((a, b) => a.localeCompare(b));
   if (entries.length === 0) {
     return [];
   }
@@ -4874,7 +4980,7 @@ function normalizePlaywrightTargets(raw) {
     return { playwrightBrowser: "all", playwrightInstallTargets: ["all"] };
   }
   if (list.length === 0) {
-    return { playwrightBrowser: "chromium", playwrightInstallTargets: ["chrome"] };
+    return { playwrightBrowser: "chromium", playwrightInstallTargets: ["chromium"] };
   }
   const ordered = ["chromium", "chrome", "firefox", "webkit", "msedge"].filter((x) => list.includes(x));
   const primary = ordered.find((x) => x === "chromium" || x === "firefox" || x === "webkit") ?? "chromium";
@@ -6518,6 +6624,13 @@ function resolveBootstrapInstallDeps(argv2) {
   if (nativeDir) extras.nativeDriversDir = nativeDir;
   return { skip: false, scopes, force, extras };
 }
+var PREINSTALL_PLAYWRIGHT_HOST_ALLOW = /* @__PURE__ */ new Set([
+  "https://cdn.playwright.dev",
+  "https://playwright.azureedge.net"
+]);
+function normalizePlaywrightHost(url) {
+  return url.replace(/\/$/, "");
+}
 function applyPreinstallPlaywrightHostFile() {
   if (process.env.PLAYWRIGHT_DOWNLOAD_HOST?.trim()) {
     return;
@@ -6528,12 +6641,18 @@ function applyPreinstallPlaywrightHostFile() {
   for (const root of roots) {
     const file = import_node_path10.default.join(root, ".ada-mcp-playwright-host");
     try {
-      const host = import_node_fs2.default.readFileSync(file, "utf8").trim();
-      if (host.length > 0) {
+      const host = normalizePlaywrightHost(import_node_fs3.default.readFileSync(file, "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 ${file}: ${host}`);
         return;
       }
+      if (host.length > 0) {
+        console.error(
+          `[ADA-MCP] ignore preinstall playwright CDN (runtime will re-probe): ${host}`
+        );
+        return;
+      }
     } catch {
     }
   }
@@ -6567,7 +6686,7 @@ async function runBootstrapInstallDeps(argv2) {
 
 // src/main.ts
 var import_promises13 = __toESM(require("node:fs/promises"));
-var import_node_fs4 = require("node:fs");
+var import_node_fs5 = require("node:fs");
 var import_node_net2 = __toESM(require("node:net"));
 var import_node_path14 = __toESM(require("node:path"));
 var import_node_child_process5 = require("node:child_process");
@@ -6577,7 +6696,7 @@ var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 var import_types = require("@modelcontextprotocol/sdk/types.js");
 
 // src/executor.ts
-var import_node_fs3 = require("node:fs");
+var import_node_fs4 = require("node:fs");
 var import_node_path11 = __toESM(require("node:path"));
 var import_node_url3 = require("node:url");
 var import_meta = {};
@@ -6596,7 +6715,7 @@ function ensureBundledPluginDir() {
     candidates.push(import_node_path11.default.join(dirname, "..", "plugins"));
   }
   for (const dir of candidates) {
-    if ((0, import_node_fs3.existsSync)(dir)) {
+    if ((0, import_node_fs4.existsSync)(dir)) {
       process.env.ADA_PLUGIN_DIR = dir;
       return;
     }
@@ -6752,7 +6871,7 @@ function parseServerEndpoint(serverUrl) {
 }
 function commandAvailable(command) {
   if (import_node_path14.default.isAbsolute(command)) {
-    return (0, import_node_fs4.existsSync)(command);
+    return (0, import_node_fs5.existsSync)(command);
   }
   const checker = process.platform === "win32" ? "where.exe" : "which";
   const checked = (0, import_node_child_process5.spawnSync)(checker, [command], {
@@ -6796,7 +6915,7 @@ function resolveAppiumNodeEntrypoint() {
     import_node_path14.default.join(process.cwd(), "..", "..", "node_modules", "appium", "build", "lib", "main.js")
   ];
   for (const p of candidates) {
-    if ((0, import_node_fs4.existsSync)(p)) {
+    if ((0, import_node_fs5.existsSync)(p)) {
       return p;
     }
   }
@@ -6815,11 +6934,11 @@ function loadPersistedHomes() {
     import_node_path14.default.join(process.cwd(), "..", ".ada-agent", "deps-install-state.json")
   ];
   for (const file of candidates) {
-    if (!(0, import_node_fs4.existsSync)(file)) {
+    if (!(0, import_node_fs5.existsSync)(file)) {
       continue;
     }
     try {
-      const raw = (0, import_node_fs4.readFileSync)(file, "utf8");
+      const raw = (0, import_node_fs5.readFileSync)(file, "utf8");
       const parsed = JSON.parse(raw);
       const androidHome = typeof parsed.androidHome === "string" ? parsed.androidHome.trim() : "";
       const appiumHome = typeof parsed.appiumHome === "string" ? parsed.appiumHome.trim() : "";
@@ -6852,11 +6971,11 @@ function resolveAndroidSdkRoot() {
     process.env.USERPROFILE ? import_node_path14.default.join(process.env.USERPROFILE, "AppData", "Local", "Android", "Sdk") : null
   ].map((v) => typeof v === "string" ? v.trim() : "").filter(Boolean);
   for (const sdkRoot of candidates) {
-    if (persisted.androidHome && sdkRoot === persisted.androidHome && (0, import_node_fs4.existsSync)(sdkRoot)) {
+    if (persisted.androidHome && sdkRoot === persisted.androidHome && (0, import_node_fs5.existsSync)(sdkRoot)) {
       return sdkRoot;
     }
     const platformTools = import_node_path14.default.join(sdkRoot, "platform-tools");
-    if ((0, import_node_fs4.existsSync)(platformTools)) {
+    if ((0, import_node_fs5.existsSync)(platformTools)) {
       return sdkRoot;
     }
   }
@@ -6867,11 +6986,11 @@ function getAppiumExtensionsFile(homeDir) {
 }
 function hasAppiumDriver(homeDir, driverName) {
   const file = getAppiumExtensionsFile(homeDir);
-  if (!(0, import_node_fs4.existsSync)(file)) {
+  if (!(0, import_node_fs5.existsSync)(file)) {
     return false;
   }
   try {
-    const text = (0, import_node_fs4.readFileSync)(file, "utf8");
+    const text = (0, import_node_fs5.readFileSync)(file, "utf8");
     return text.toLowerCase().includes(driverName.toLowerCase());
   } catch {
     return false;
@@ -6894,7 +7013,7 @@ function resolveAppiumHome(platform) {
     }
   }
   for (const candidate of uniq) {
-    if ((0, import_node_fs4.existsSync)(getAppiumExtensionsFile(candidate))) {
+    if ((0, import_node_fs5.existsSync)(getAppiumExtensionsFile(candidate))) {
       return candidate;
     }
   }
@@ -8358,7 +8477,7 @@ async function startMcpServer() {
     mcpServers: {
       "ada-mcp": {
         command: "pnpm",
-        args: ["dlx", "@ada-mcp/launcher@0.1.2"]
+        args: ["dlx", "@ada-mcp/launcher@0.1.3"]
       }
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ada-mcp/mcp-server",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "ADA MCP server for web/mobile automation (stdio + remote HTTP)",
   "private": false,
   "type": "commonjs",
@@ -35,7 +35,7 @@
     "express": "^5.2.1",
     "jimp": "^1.6.0",
     "js-yaml": "^4.1.0",
-    "playwright": "^1.59.1",
+    "playwright": "1.59.1",
     "selenium-webdriver": "^4.34.0"
   },
   "devDependencies": {

package/scripts/preinstall-probes.mjs

@@ -62,7 +62,11 @@ async function main() {
     console.error(`[ada-mcp preinstall]   registry ${candidate} -> ${latency === null ? "fail" : `${latency}ms`}`);
   }
 
-  const pwCandidates = playwrightHostCandidateList();
+  /** preinstall 阶段依赖尚未安装，无法校验浏览器包是否存在；仅测官方 CDN，避免写入国内镜像后 404 */
+  const pwCandidates = [
+    "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");