@ada-mcp/mcp-server 0.1.13 → 0.1.15

package/dist/cli.cjs

@@ -2728,16 +2728,16 @@ var init_src = __esm({
   }
 });
 
-// ../ada-agent/dist/bundled-config.generated.js
+// ../ada-agent/src/bundled-config.generated.ts
 var bundledDefaultConfigYaml;
 var init_bundled_config_generated = __esm({
-  "../ada-agent/dist/bundled-config.generated.js"() {
+  "../ada-agent/src/bundled-config.generated.ts"() {
     "use strict";
     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
+// ../ada-agent/src/config.ts
 function mergeConfig(base, overrides) {
   return {
     ...base,
@@ -2803,10 +2803,9 @@ function maskToken(token) {
 }
 var import_promises2, import_node_path2, DEFAULT_CONFIG_RELATIVE, LOCAL_DATA_DIR, EFFECTIVE_CONFIG_FILE, defaultConfig;
 var init_config = __esm({
-  "../ada-agent/dist/config.js"() {
-    "use strict";
-    import_promises2 = __toESM(require("node:fs/promises"), 1);
-    import_node_path2 = __toESM(require("node:path"), 1);
+  "../ada-agent/src/config.ts"() {
+    import_promises2 = __toESM(require("node:fs/promises"));
+    import_node_path2 = __toESM(require("node:path"));
     init_js_yaml();
     init_src();
     init_bundled_config_generated();
@@ -2888,7 +2887,7 @@ var init_config = __esm({
         ],
         nativeDriversDir: "dirver",
         geckodriverVersion: "latest",
-        chromedriverVersion: "latest"
+        chromedriverVersion: "match-chrome"
       },
       appium: {
         serverUrl: "http://127.0.0.1:4723",
@@ -2898,7 +2897,7 @@ var init_config = __esm({
   }
 });
 
-// ../ada-agent/dist/secrets.js
+// ../ada-agent/src/secrets.ts
 function resolveProvider(provider) {
   if (provider === "keychain" || provider === "credman") {
     return "file";
@@ -2930,23 +2929,21 @@ async function loadSecret(provider, cwd = process.cwd()) {
 }
 var import_promises3, import_node_path3, SECRET_FILE;
 var init_secrets = __esm({
-  "../ada-agent/dist/secrets.js"() {
-    "use strict";
-    import_promises3 = __toESM(require("node:fs/promises"), 1);
-    import_node_path3 = __toESM(require("node:path"), 1);
+  "../ada-agent/src/secrets.ts"() {
+    import_promises3 = __toESM(require("node:fs/promises"));
+    import_node_path3 = __toESM(require("node:path"));
     init_config();
     SECRET_FILE = "secrets.json";
   }
 });
 
-// ../ada-agent/dist/logger.js
+// ../ada-agent/src/logger.ts
 function log(level, payload) {
   baseLog(level, payload);
 }
 var baseLog;
 var init_logger = __esm({
-  "../ada-agent/dist/logger.js"() {
-    "use strict";
+  "../ada-agent/src/logger.ts"() {
     init_src();
     baseLog = createJsonLogger("ada-agent");
   }
@@ -3280,30 +3277,171 @@ 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] \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"
+  );
+}
+async function detectInstalledChromeMajorVersion() {
+  const browsers = await detectLocalBrowsers();
+  return browsers.chrome?.major;
 }
 async function readWindowsFileVersion(exePath) {
   return new Promise((resolve) => {
@@ -3346,7 +3484,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 });
@@ -3359,7 +3497,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) {
@@ -3379,7 +3517,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 });
@@ -3396,7 +3534,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) {
@@ -3406,38 +3544,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(
@@ -3452,14 +3643,21 @@ 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;
 }
-var import_node_child_process, import_promises4, import_node_path4, DEFAULT_NATIVE_DRIVERS_DIR, CHROME_FOR_TESTING_JSON;
+var import_node_child_process, import_promises4, import_node_path4, DEFAULT_NATIVE_DRIVERS_DIR, CHROME_FOR_TESTING_JSON, SELENIUM_DRIVER_MANUAL_DOWNLOAD_REFERENCES;
 var init_src2 = __esm({
   "../../packages/native-drivers/src/index.ts"() {
     "use strict";
@@ -3468,10 +3666,48 @@ 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/dist/dependency-installer.js
+// ../ada-agent/src/dependency-installer.ts
 function shouldUseShell(command) {
   if (process.platform !== "win32") {
     return false;
@@ -3546,7 +3782,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"],
@@ -3668,20 +3904,26 @@ 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}`);
     if (runtimeMajor !== null && nodeMajor !== null && nodeMajor > runtimeMajor) {
-      onLogLine?.(`[deps][warn] \u7CFB\u7EDF Node.js \u4E3B\u7248\u672C\uFF08${nodeMajor}\uFF09\u9AD8\u4E8E\u5185\u7F6E\u4E3B\u7248\u672C\uFF08${runtimeMajor}\uFF09\u3002\u5B89\u88C5\u5C06\u7EE7\u7EED\uFF0C\u8FD0\u884C\u65F6\u4EE5\u5185\u7F6E Node \u4E3A\u51C6\u3002`);
+      onLogLine?.(
+        `[deps][warn] \u7CFB\u7EDF Node.js \u4E3B\u7248\u672C\uFF08${nodeMajor}\uFF09\u9AD8\u4E8E\u5185\u7F6E\u4E3B\u7248\u672C\uFF08${runtimeMajor}\uFF09\u3002\u5B89\u88C5\u5C06\u7EE7\u7EED\uFF0C\u8FD0\u884C\u65F6\u4EE5\u5185\u7F6E Node \u4E3A\u51C6\u3002`
+      );
     }
     if (nodeMajor === null || nodeMajor < requiredNodeMajor) {
-      onLogLine?.(`[deps][warn] \u7CFB\u7EDF Node.js \u7248\u672C\u4E3A ${nodeVersion.stdout}\uFF08\u5EFA\u8BAE >= ${requiredNodeMajor}\uFF09\uFF0C\u7EE7\u7EED\u5C1D\u8BD5\u5B89\u88C5\u3002`);
+      onLogLine?.(
+        `[deps][warn] \u7CFB\u7EDF Node.js \u7248\u672C\u4E3A ${nodeVersion.stdout}\uFF08\u5EFA\u8BAE >= ${requiredNodeMajor}\uFF09\uFF0C\u7EE7\u7EED\u5C1D\u8BD5\u5B89\u88C5\u3002`
+      );
     }
   } else {
-    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`);
+    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}`);
@@ -3690,7 +3932,9 @@ ${npmVersion.stderr || npmVersion.stdout}`.trim());
   }
   const npmMajor = majorOf(npmVersion.stdout);
   if (npmMajor === null || npmMajor < requiredNpmMajor) {
-    onLogLine?.(`[deps][warn] \u7CFB\u7EDF npm \u7248\u672C\u4E3A ${npmVersion.stdout}\uFF08\u5EFA\u8BAE >= ${requiredNpmMajor}\uFF09\uFF0C\u7EE7\u7EED\u5C1D\u8BD5\u5B89\u88C5\u3002`);
+    onLogLine?.(
+      `[deps][warn] \u7CFB\u7EDF npm \u7248\u672C\u4E3A ${npmVersion.stdout}\uFF08\u5EFA\u8BAE >= ${requiredNpmMajor}\uFF09\uFF0C\u7EE7\u7EED\u5C1D\u8BD5\u5B89\u88C5\u3002`
+    );
   }
 }
 function appiumDriverPackageName(driver) {
@@ -3732,7 +3976,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) {
@@ -3814,18 +4058,19 @@ async function detectBestRegistry(config, baseProxy) {
     return cached;
   }
   progress("registry.probe.start", { candidates });
-  const probeResults = await Promise.all(candidates.map(async (candidate) => {
-    progress("registry.probe.try", { candidate });
-    const latency = await probeRegistryLatency(candidate);
-    progress("registry.probe.result", { candidate, latencyMs: latency });
-    return { candidate, latency };
-  }));
+  const probeResults = await Promise.all(
+    candidates.map(async (candidate) => {
+      progress("registry.probe.try", { candidate });
+      const latency = await probeRegistryLatency(candidate);
+      progress("registry.probe.result", { candidate, latencyMs: latency });
+      return { candidate, latency };
+    })
+  );
   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 === null) continue;
     const priority = registryPriorityIndex(candidates, candidate);
     if (latency < bestLatency || latency === bestLatency && priority < bestPriority) {
       best = candidate;
@@ -3910,20 +4155,22 @@ async function rankPlaywrightHosts(config) {
   const candidates = playwrightHostCandidates(config);
   const browserVersion = resolveChromiumBrowserVersion();
   progress("playwright.host.probe.start", { candidates, browserVersion: browserVersion || void 0 });
-  const probeResults = await Promise.all(candidates.map(async (candidate) => {
-    progress("playwright.host.probe.try", { candidate });
-    const artifactLatency = browserVersion ? await probePlaywrightBrowserArtifact(candidate, browserVersion) : null;
-    const rootLatency = await probePlaywrightHostLatency(candidate);
-    const latency = artifactLatency ?? rootLatency;
-    const artifactOk = artifactLatency !== null;
-    progress("playwright.host.probe.result", {
-      candidate,
-      latencyMs: latency,
-      artifactOk,
-      browserVersion: browserVersion || void 0
-    });
-    return { candidate, latency, artifactOk, priority: playwrightHostPriorityIndex(candidates, candidate) };
-  }));
+  const probeResults = await Promise.all(
+    candidates.map(async (candidate) => {
+      progress("playwright.host.probe.try", { candidate });
+      const artifactLatency = browserVersion ? await probePlaywrightBrowserArtifact(candidate, browserVersion) : null;
+      const rootLatency = await probePlaywrightHostLatency(candidate);
+      const latency = artifactLatency ?? rootLatency;
+      const artifactOk = artifactLatency !== null;
+      progress("playwright.host.probe.result", {
+        candidate,
+        latencyMs: latency,
+        artifactOk,
+        browserVersion: browserVersion || void 0
+      });
+      return { candidate, latency, artifactOk, priority: playwrightHostPriorityIndex(candidates, candidate) };
+    })
+  );
   const reachable = probeResults.filter((x) => x.latency !== null);
   const withArtifact = reachable.filter((x) => x.artifactOk);
   const pool = withArtifact.length > 0 ? withArtifact : reachable;
@@ -3948,7 +4195,9 @@ 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(" ")} (registry \u63A2\u6D4B: npm=${npmProxy}, pnpm=${pnpmProxy}\uFF1B\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",
@@ -3995,7 +4244,9 @@ async function runInstallWithPriority(config, packages, onLogLine) {
       });
     }
   }
-  throw new Error(`Dependency install failed after all strategies: ${lastError instanceof Error ? lastError.message : String(lastError)}`);
+  throw new Error(
+    `Dependency install failed after all strategies: ${lastError instanceof Error ? lastError.message : String(lastError)}`
+  );
 }
 async function runAppiumDriverInstallWithPriority(config, driver, onLogLine) {
   const npmProxy = await detectBestRegistry(config, npmProxyRegistry());
@@ -4054,7 +4305,9 @@ async function runAppiumDriverInstallWithPriority(config, driver, onLogLine) {
       }
     }
   }
-  throw new Error(`Appium driver install failed after all strategies (${driver}): ${lastError instanceof Error ? lastError.message : String(lastError)}`);
+  throw new Error(
+    `Appium driver install failed after all strategies (${driver}): ${lastError instanceof Error ? lastError.message : String(lastError)}`
+  );
 }
 async function verifyPlaywrightSelfTest(onLogLine) {
   onLogLine?.("[playwright] \u81EA\u68C0\uFF1A\u542F\u52A8 Chromium \u7A7A\u767D\u9875");
@@ -4073,7 +4326,9 @@ 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");
+    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");
@@ -4094,7 +4349,9 @@ async function installPlaywrightBrowser(config, onLogLine, options) {
     if (i > 0) {
       onLogLine?.(`[playwright] \u4E0A\u4E00\u955C\u50CF\u5931\u8D25\uFF0C\u6539\u8BD5 ${host}`);
     }
-    onLogLine?.(`[playwright] \u4F7F\u7528\u5185\u7F6E playwright@${version} CLI\uFF0C\u955C\u50CF ${host}\uFF0C\u76EE\u6807: ${targets.length ? targets.join(",") : "all"}${options?.force ? " (--force)" : ""}`);
+    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 },
@@ -4141,7 +4398,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);
@@ -4150,7 +4407,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 [];
   }
@@ -4208,7 +4465,10 @@ function configWithPlaywrightTargets(config, targets) {
 }
 async function ensureSeleniumNativeDrivers(config, options, onLogLine) {
   const root = await resolveWorkspaceRoot2(process.cwd());
-  const driversDir = import_node_path5.default.resolve(root, options?.nativeDriversDir ?? config.dependencies.nativeDriversDir ?? "dirver");
+  const driversDir = import_node_path5.default.resolve(
+    root,
+    options?.nativeDriversDir ?? config.dependencies.nativeDriversDir ?? "dirver"
+  );
   const seleniumWebdriverInstalled = hasPackage("selenium-webdriver");
   if (seleniumWebdriverInstalled) {
     onLogLine?.("[selenium] npm \u5305 selenium-webdriver \u5DF2\u5B89\u88C5");
@@ -4217,11 +4477,16 @@ 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?.(`[selenium] \u53EF\u9009 chromedriver \u4E3B\u7248\u672C\uFF08chrome-for-testing\uFF09: ${catalog.slice(0, 12).map((x) => x.major).join(", ")}${catalog.length > 12 ? "\u2026" : ""}`);
+    onLogLine?.(
+      `[selenium] \u53EF\u9009 chromedriver \u4E3B\u7248\u672C\uFF08chrome-for-testing\uFF09: ${catalog.slice(0, 12).map((x) => x.major).join(", ")}${catalog.length > 12 ? "\u2026" : ""}`
+    );
   } catch (error) {
-    onLogLine?.(`[selenium] \u65E0\u6CD5\u62C9\u53D6 chromedriver \u7248\u672C\u5217\u8868: ${error instanceof Error ? error.message : String(error)}`);
+    onLogLine?.(
+      `[selenium] \u65E0\u6CD5\u62C9\u53D6 chromedriver \u7248\u672C\u5217\u8868: ${error instanceof Error ? error.message : String(error)}`
+    );
   }
   const resolved = await ensureNativeWebDrivers({
     workspaceRoot: root,
@@ -4240,27 +4505,82 @@ async function ensureSeleniumNativeDrivers(config, options, onLogLine) {
     chromedriverPath: resolved.chromedriverPath
   };
 }
-async function prepareInstallHomes(onLogLine) {
+function installScopeNeedsMobileEnv(only) {
+  return only === "all" || only === "appium" || only === "drivers" || only === "mobile" || only === "android" || only === "ios" || only === "harmony";
+}
+async function pathIsExistingDirectory(dirPath) {
+  try {
+    const stat = await import_promises5.default.stat(dirPath);
+    return stat.isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function prepareInstallHomes(onLogLine, options) {
   const root = await resolveWorkspaceRoot2(process.cwd());
-  const projectAndroidHome = import_node_path5.default.join(root, "android-sdk");
-  const projectAppiumHome = import_node_path5.default.join(root, "appium");
+  const projectAndroidHome = import_node_path5.default.join(root, "ANDROID_HOME");
+  const projectAppiumHome = import_node_path5.default.join(root, "APPIUM_HOME");
   const envAndroid = (process.env.ANDROID_HOME ?? process.env.ANDROID_SDK_ROOT ?? "").trim();
   const envAppium = (process.env.APPIUM_HOME ?? "").trim();
-  const androidHome = envAndroid || projectAndroidHome;
-  const appiumHome = envAppium || projectAppiumHome;
-  const usedProjectFallbackAndroid = !envAndroid;
-  const usedProjectFallbackAppium = !envAppium;
-  await import_promises5.default.mkdir(androidHome, { recursive: true });
-  await import_promises5.default.mkdir(appiumHome, { recursive: true });
+  const requireMobile = options?.requireMobileEnv === true;
+  let androidFromSystem = false;
+  let appiumFromSystem = false;
+  let androidHome = projectAndroidHome;
+  let appiumHome = projectAppiumHome;
+  if (envAndroid) {
+    if (await pathIsExistingDirectory(envAndroid)) {
+      androidFromSystem = true;
+      androidHome = envAndroid;
+      onLogLine?.(`[deps] \u4F7F\u7528\u7CFB\u7EDF\u73AF\u5883\u53D8\u91CF ANDROID_HOME=${envAndroid}`);
+    } else {
+      onLogLine?.(`[deps][warn] \u7CFB\u7EDF ANDROID_HOME / ANDROID_SDK_ROOT \u6307\u5411\u7684\u76EE\u5F55\u4E0D\u5B58\u5728: ${envAndroid}`);
+      onLogLine?.(`[deps][warn] \u8BF7\u4FEE\u6B63\u7CFB\u7EDF\u73AF\u5883\u53D8\u91CF\uFF0C\u6216\u5220\u9664\u9519\u8BEF\u914D\u7F6E\u540E\u91CD\u8BD5\u3002`);
+      onLogLine?.(`[deps] \u5B89\u88C5\u8FC7\u7A0B\u5C06\u4F7F\u7528\u9879\u76EE\u9ED8\u8BA4\u76EE\u5F55: ${projectAndroidHome}`);
+    }
+  } else {
+    onLogLine?.("[deps][warn] \u672A\u68C0\u6D4B\u5230\u7CFB\u7EDF\u73AF\u5883\u53D8\u91CF ANDROID_HOME \u6216 ANDROID_SDK_ROOT\u3002");
+    onLogLine?.(
+      "[deps][warn] \u8BF7\u5728\u7CFB\u7EDF/\u7EC8\u7AEF\u914D\u7F6E ANDROID_HOME\uFF08\u6307\u5411 Android SDK \u6839\u76EE\u5F55\uFF0C\u4E14\u5305\u542B platform-tools\uFF09\u3002"
+    );
+    onLogLine?.(`[deps] \u5B89\u88C5\u8FC7\u7A0B\u5C06\u4F7F\u7528\u9879\u76EE\u9ED8\u8BA4\u76EE\u5F55: ${projectAndroidHome}`);
+  }
+  if (envAppium) {
+    if (await pathIsExistingDirectory(envAppium)) {
+      appiumFromSystem = true;
+      appiumHome = envAppium;
+      onLogLine?.(`[deps] \u4F7F\u7528\u7CFB\u7EDF\u73AF\u5883\u53D8\u91CF APPIUM_HOME=${envAppium}`);
+    } else {
+      onLogLine?.(`[deps][warn] \u7CFB\u7EDF APPIUM_HOME \u6307\u5411\u7684\u76EE\u5F55\u4E0D\u5B58\u5728: ${envAppium}`);
+      onLogLine?.(`[deps][warn] \u8BF7\u4FEE\u6B63\u7CFB\u7EDF\u73AF\u5883\u53D8\u91CF\uFF0C\u6216\u5220\u9664\u9519\u8BEF\u914D\u7F6E\u540E\u91CD\u8BD5\u3002`);
+      onLogLine?.(`[deps] \u5B89\u88C5\u8FC7\u7A0B\u5C06\u4F7F\u7528\u9879\u76EE\u9ED8\u8BA4\u76EE\u5F55: ${projectAppiumHome}`);
+    }
+  } else {
+    onLogLine?.("[deps][warn] \u672A\u68C0\u6D4B\u5230\u7CFB\u7EDF\u73AF\u5883\u53D8\u91CF APPIUM_HOME\u3002");
+    onLogLine?.("[deps][warn] \u8BF7\u5728\u7CFB\u7EDF/\u7EC8\u7AEF\u914D\u7F6E APPIUM_HOME\uFF08Appium \u9A71\u52A8\u4E0E\u6269\u5C55\u7684\u5B89\u88C5\u76EE\u5F55\uFF09\u3002");
+    onLogLine?.(`[deps] \u5B89\u88C5\u8FC7\u7A0B\u5C06\u4F7F\u7528\u9879\u76EE\u9ED8\u8BA4\u76EE\u5F55: ${projectAppiumHome}`);
+  }
+  if (requireMobile && !androidFromSystem && !appiumFromSystem) {
+    onLogLine?.(
+      "[deps][warn] \u5F53\u524D\u5B89\u88C5\u5305\u542B Appium/\u79FB\u52A8\u7AEF\u80FD\u529B\uFF0C\u5EFA\u8BAE\u5728\u5B8C\u6210 install-deps \u524D\u914D\u7F6E\u7CFB\u7EDF ANDROID_HOME \u4E0E APPIUM_HOME\u3002"
+    );
+  }
+  await import_promises5.default.mkdir(projectAndroidHome, { recursive: true });
+  await import_promises5.default.mkdir(projectAppiumHome, { recursive: true });
+  if (androidHome !== projectAndroidHome) {
+    await import_promises5.default.mkdir(androidHome, { recursive: true }).catch(() => void 0);
+  }
+  if (appiumHome !== projectAppiumHome) {
+    await import_promises5.default.mkdir(appiumHome, { recursive: true }).catch(() => void 0);
+  }
   process.env.ANDROID_HOME = androidHome;
   process.env.ANDROID_SDK_ROOT = androidHome;
   process.env.APPIUM_HOME = appiumHome;
-  onLogLine?.(`[deps] \u73AF\u5883\u76EE\u5F55: ANDROID_HOME=${androidHome} APPIUM_HOME=${appiumHome}` + (usedProjectFallbackAndroid || usedProjectFallbackAppium ? "\uFF08\u5DF2\u4F7F\u7528\u9879\u76EE\u76EE\u5F55\u515C\u5E95\uFF09" : ""));
+  onLogLine?.(`[deps] \u73AF\u5883\u76EE\u5F55: ANDROID_HOME=${androidHome} APPIUM_HOME=${appiumHome}`);
   return {
     androidHome,
     appiumHome,
-    usedProjectFallbackAndroid,
-    usedProjectFallbackAppium
+    androidFromSystem,
+    appiumFromSystem
   };
 }
 function resolveRequestedDrivers(config, only) {
@@ -4303,14 +4623,16 @@ async function ensureDriverDependencies(config, options) {
   const pwOverride = filterPlaywrightTargetsOverride(options?.playwrightInstallTargetsOverride);
   const configForPlaywright = pwOverride?.length ? configWithPlaywrightTargets(config, pwOverride) : config;
   const state = await loadInstallState();
-  const homes = await prepareInstallHomes(onLogLine);
+  const needPlaywright = only === "all" || only === "playwright";
+  const needSelenium = only === "all" || only === "selenium";
+  const needAppium = only === "all" || only === "appium" || only === "drivers" || only === "mobile" || only === "android" || only === "ios" || only === "harmony";
+  const homes = await prepareInstallHomes(onLogLine, {
+    requireMobileEnv: installScopeNeedsMobileEnv(only)
+  });
   progress("deps.ensure.start");
   onLogLine?.("[deps] \u5F00\u59CB\u68C0\u6D4B / \u5B89\u88C5\u4F9D\u8D56\u2026");
   await ensureNodeEnvironmentForInstall(onLogLine);
   const missing = [];
-  const needPlaywright = only === "all" || only === "playwright";
-  const needSelenium = only === "all" || only === "selenium";
-  const needAppium = only === "all" || only === "appium" || only === "drivers" || only === "mobile" || only === "android" || only === "ios" || only === "harmony";
   const requestedDrivers = options?.appiumRequiredDriversOverride !== void 0 ? normalizeAppiumDriverTokens(options.appiumRequiredDriversOverride) : resolveRequestedDrivers(config, only);
   const needDrivers = requestedDrivers.length > 0;
   const installedPackages = [];
@@ -4356,7 +4678,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");
+        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, {
         force: force || reinstallForTargets || !launchOk
@@ -4428,7 +4752,10 @@ async function ensureDriverDependencies(config, options) {
   let availableChromedriverMajors;
   if (needSelenium) {
     const root = await resolveWorkspaceRoot2(process.cwd());
-    nativeDriversDir = import_node_path5.default.resolve(root, options?.nativeDriversDir ?? config.dependencies.nativeDriversDir ?? "dirver");
+    nativeDriversDir = import_node_path5.default.resolve(
+      root,
+      options?.nativeDriversDir ?? config.dependencies.nativeDriversDir ?? "dirver"
+    );
     availableChromedriverMajors = await listLocalChromedriverVersions(nativeDriversDir);
     const resolved = await resolveNativeDrivers({
       workspaceRoot: root,
@@ -4503,13 +4830,12 @@ async function getDependencyHealth(config) {
 }
 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 init_dependency_installer = __esm({
-  "../ada-agent/dist/dependency-installer.js"() {
-    "use strict";
+  "../ada-agent/src/dependency-installer.ts"() {
     import_node_module = require("node:module");
     import_node_fs = require("node:fs");
     import_node_child_process2 = require("node:child_process");
-    import_promises5 = __toESM(require("node:fs/promises"), 1);
-    import_node_path5 = __toESM(require("node:path"), 1);
+    import_promises5 = __toESM(require("node:fs/promises"));
+    import_node_path5 = __toESM(require("node:path"));
     init_logger();
     init_config();
     init_src2();
@@ -4780,7 +5106,7 @@ var init_src4 = __esm({
   }
 });
 
-// ../ada-agent/dist/plugin-registry.js
+// ../ada-agent/src/plugin-registry.ts
 function buildPluginHost() {
   const host = new PluginHost();
   registerRuntimePlugins(host);
@@ -4791,13 +5117,12 @@ function listBuiltInPluginManifests() {
   return registerRuntimePlugins(host);
 }
 var init_plugin_registry = __esm({
-  "../ada-agent/dist/plugin-registry.js"() {
-    "use strict";
+  "../ada-agent/src/plugin-registry.ts"() {
     init_src4();
   }
 });
 
-// ../ada-agent/dist/doctor.js
+// ../ada-agent/src/doctor.ts
 async function dirExists2(dirPath) {
   try {
     const stat = await import_promises6.default.stat(dirPath);
@@ -4974,11 +5299,10 @@ async function checkAppiumServer(serverUrl) {
 }
 var import_promises6, import_node_net, import_node_path7, import_node_url, import_node_child_process3;
 var init_doctor = __esm({
-  "../ada-agent/dist/doctor.js"() {
-    "use strict";
-    import_promises6 = __toESM(require("node:fs/promises"), 1);
-    import_node_net = __toESM(require("node:net"), 1);
-    import_node_path7 = __toESM(require("node:path"), 1);
+  "../ada-agent/src/doctor.ts"() {
+    import_promises6 = __toESM(require("node:fs/promises"));
+    import_node_net = __toESM(require("node:net"));
+    import_node_path7 = __toESM(require("node:path"));
     import_node_url = require("node:url");
     import_node_child_process3 = require("node:child_process");
     init_dependency_installer();
@@ -4987,7 +5311,7 @@ var init_doctor = __esm({
   }
 });
 
-// ../ada-agent/dist/setup-cli.js
+// ../ada-agent/src/setup-cli.ts
 function parseTags(raw) {
   return raw.split(",").map((s) => s.trim()).filter(Boolean);
 }
@@ -5001,7 +5325,9 @@ async function runSetupCli() {
   const rl = import_promises7.default.createInterface({ input: import_node_process.stdin, output: import_node_process.stdout });
   try {
     console.log("[ADA-AGENT] setup wizard (CLI mode)");
-    const serverUrl = ensureServerUrl((await rl.question("Server URL (e.g. https://ada-control.example.com): ")).trim());
+    const serverUrl = ensureServerUrl(
+      (await rl.question("Server URL (e.g. https://ada-control.example.com): ")).trim()
+    );
     const tenant = (await rl.question("Tenant [default]: ")).trim() || "default";
     const environment = (await rl.question("Environment [prod]: ")).trim() || "prod";
     const authTypeInput = (await rl.question("Auth type [token/device_code] (default token): ")).trim();
@@ -5030,14 +5356,13 @@ async function runSetupCli() {
 }
 var import_promises7, import_node_process;
 var init_setup_cli = __esm({
-  "../ada-agent/dist/setup-cli.js"() {
-    "use strict";
-    import_promises7 = __toESM(require("node:readline/promises"), 1);
+  "../ada-agent/src/setup-cli.ts"() {
+    import_promises7 = __toESM(require("node:readline/promises"));
     import_node_process = require("node:process");
   }
 });
 
-// ../ada-agent/dist/setup-native.js
+// ../ada-agent/src/setup-native.ts
 function normalizeOutput(raw) {
   const parsed = JSON.parse(raw);
   if (!parsed.serverUrl || !parsed.tenant || !parsed.environment) {
@@ -5100,13 +5425,12 @@ async function runSetupNative(config) {
 }
 var import_node_child_process4;
 var init_setup_native = __esm({
-  "../ada-agent/dist/setup-native.js"() {
-    "use strict";
+  "../ada-agent/src/setup-native.ts"() {
     import_node_child_process4 = require("node:child_process");
   }
 });
 
-// ../ada-agent/dist/setup-state.js
+// ../ada-agent/src/setup-state.ts
 function normalizePlaywrightTargets(raw) {
   const list = (raw ?? []).map((x) => String(x).toLowerCase().trim()).filter((x) => PW_TARGET.has(x));
   if (list.includes("all")) {
@@ -5174,8 +5498,7 @@ async function persistAgentSetup(config, input2) {
 }
 var PW_TARGET;
 var init_setup_state = __esm({
-  "../ada-agent/dist/setup-state.js"() {
-    "use strict";
+  "../ada-agent/src/setup-state.ts"() {
     init_config();
     init_secrets();
     PW_TARGET = /* @__PURE__ */ new Set([
@@ -5189,7 +5512,7 @@ var init_setup_state = __esm({
   }
 });
 
-// ../ada-agent/dist/bootstrap-ui.js
+// ../ada-agent/src/bootstrap-ui.ts
 function parseDependencyInstallScope(value) {
   if (value === "all" || value === "playwright" || value === "mobile" || value === "android" || value === "ios" || value === "harmony" || value === "appium" || value === "drivers") {
     return value;
@@ -5575,7 +5898,10 @@ async function runSetupUi(config) {
             try {
               saved = await persistAgentSetup(config, payload);
             } catch (error) {
-              abortSetup(500, error instanceof Error ? error.message : String(error));
+              abortSetup(
+                500,
+                error instanceof Error ? error.message : String(error)
+              );
               return;
             }
             res.writeHead(200, {
@@ -5682,9 +6008,8 @@ async function openBrowser(url) {
 }
 var import_node_http, import_node_crypto, import_node_url2;
 var init_bootstrap_ui = __esm({
-  "../ada-agent/dist/bootstrap-ui.js"() {
-    "use strict";
-    import_node_http = __toESM(require("node:http"), 1);
+  "../ada-agent/src/bootstrap-ui.ts"() {
+    import_node_http = __toESM(require("node:http"));
     import_node_crypto = require("node:crypto");
     import_node_url2 = require("node:url");
     init_setup_state();
@@ -5888,7 +6213,7 @@ var init_src6 = __esm({
   }
 });
 
-// ../ada-agent/dist/transport-client.js
+// ../ada-agent/src/transport-client.ts
 function joinUrl(base, suffix) {
   const normalizedBase = base.replace(/\/$/, "");
   if (!suffix.startsWith("/")) {
@@ -5986,14 +6311,11 @@ async function createRuntimeTransport(config, secret) {
 }
 var TransportExecutor;
 var init_transport_client = __esm({
-  "../ada-agent/dist/transport-client.js"() {
-    "use strict";
+  "../ada-agent/src/transport-client.ts"() {
     init_src5();
     init_src6();
     init_logger();
     TransportExecutor = class {
-      transport;
-      mode;
       constructor(transport, mode) {
         this.transport = transport;
         this.mode = mode;
@@ -6024,7 +6346,7 @@ var init_transport_client = __esm({
   }
 });
 
-// ../ada-agent/dist/task-loader.js
+// ../ada-agent/src/task-loader.ts
 function isObject3(value) {
   return typeof value === "object" && value !== null;
 }
@@ -6064,9 +6386,8 @@ async function loadTaskFile(filePath) {
 }
 var import_promises8, allowedCommands;
 var init_task_loader = __esm({
-  "../ada-agent/dist/task-loader.js"() {
-    "use strict";
-    import_promises8 = __toESM(require("node:fs/promises"), 1);
+  "../ada-agent/src/task-loader.ts"() {
+    import_promises8 = __toESM(require("node:fs/promises"));
     allowedCommands = /* @__PURE__ */ new Set([
       "click",
       "type",
@@ -6347,7 +6668,7 @@ var init_src7 = __esm({
   }
 });
 
-// ../ada-agent/dist/monitoring.js
+// ../ada-agent/src/monitoring.ts
 function shouldMonitorCommand(command, config, index) {
   if (!config.monitoring.enabled) {
     return false;
@@ -6440,7 +6761,7 @@ async function captureOperationMonitor(command, result, index, context) {
 }
 var import_promises9, import_node_path8, import_jimp;
 var init_monitoring = __esm({
-  "../ada-agent/dist/monitoring.js"() {
+  "../ada-agent/src/monitoring.ts"() {
     "use strict";
     import_promises9 = __toESM(require("node:fs/promises"), 1);
     import_node_path8 = __toESM(require("node:path"), 1);
@@ -6449,7 +6770,7 @@ var init_monitoring = __esm({
   }
 });
 
-// ../ada-agent/dist/runtime.js
+// ../ada-agent/src/runtime.ts
 async function runTaskset(commands, options = {}) {
   const executor = new TaskExecutor(buildPluginHost());
   const results = [];
@@ -6466,12 +6787,14 @@ async function runTaskset(commands, options = {}) {
         executeLocal
       });
       if (options.config.monitoring.nonBlocking) {
-        monitorJobs.push(monitorJob.catch((error) => {
-          log("warn", {
-            event: "monitor.capture.unhandled",
-            details: { requestId: cmd.requestId, message: error instanceof Error ? error.message : String(error) }
-          });
-        }));
+        monitorJobs.push(
+          monitorJob.catch((error) => {
+            log("warn", {
+              event: "monitor.capture.unhandled",
+              details: { requestId: cmd.requestId, message: error instanceof Error ? error.message : String(error) }
+            });
+          })
+        );
       } else {
         await monitorJob;
       }
@@ -6483,22 +6806,25 @@ async function runTaskset(commands, options = {}) {
   return results;
 }
 async function runDemoTaskset(options = {}) {
-  await runTaskset([
-    {
-      requestId: "req-web-1",
-      sessionId: "session-web",
-      platform: "web",
-      command: "click",
-      payload: { locator: { testId: "login-btn" } }
-    },
-    {
-      requestId: "req-ios-1",
-      sessionId: "session-ios",
-      platform: "ios",
-      command: "swipe",
-      payload: { from: [0.5, 0.8], to: [0.5, 0.2] }
-    }
-  ], options);
+  await runTaskset(
+    [
+      {
+        requestId: "req-web-1",
+        sessionId: "session-web",
+        platform: "web",
+        command: "click",
+        payload: { locator: { testId: "login-btn" } }
+      },
+      {
+        requestId: "req-ios-1",
+        sessionId: "session-ios",
+        platform: "ios",
+        command: "swipe",
+        payload: { from: [0.5, 0.8], to: [0.5, 0.2] }
+      }
+    ],
+    options
+  );
 }
 async function runForegroundLoop(skipDemo = false, options = {}) {
   log("info", { event: "agent.runtime.ready", details: { mode: "foreground" } });
@@ -6508,8 +6834,7 @@ async function runForegroundLoop(skipDemo = false, options = {}) {
   await runDemoTaskset(options);
 }
 var init_runtime = __esm({
-  "../ada-agent/dist/runtime.js"() {
-    "use strict";
+  "../ada-agent/src/runtime.ts"() {
     init_src7();
     init_plugin_registry();
     init_logger();
@@ -6517,7 +6842,7 @@ var init_runtime = __esm({
   }
 });
 
-// ../ada-agent/dist/queue-runner.js
+// ../ada-agent/src/queue-runner.ts
 async function ensureDirs(config) {
   await import_promises10.default.mkdir(config.queue.inboxDir, { recursive: true });
   await import_promises10.default.mkdir(config.queue.processedDir, { recursive: true });
@@ -6612,10 +6937,9 @@ async function watchQueue(config, shouldStop, options = {}) {
 }
 var import_promises10, import_node_path9;
 var init_queue_runner = __esm({
-  "../ada-agent/dist/queue-runner.js"() {
-    "use strict";
-    import_promises10 = __toESM(require("node:fs/promises"), 1);
-    import_node_path9 = __toESM(require("node:path"), 1);
+  "../ada-agent/src/queue-runner.ts"() {
+    import_promises10 = __toESM(require("node:fs/promises"));
+    import_node_path9 = __toESM(require("node:path"));
     init_task_loader();
     init_runtime();
     init_logger();