@xbrowser/cli 1.14.0 → 1.15.0

package/dist/daemon-main.js

@@ -30,10 +30,13 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-ZD4OSYOX.js";
+} from "./chunk-XQ4KOZ37.js";
 import {
-  createRuleEngine
-} from "./chunk-UPAWITVM.js";
+  createRuleEngine,
+  rand,
+  sleep,
+  wheelDelta
+} from "./chunk-UXDGEDT7.js";
 import {
   queryJS
 } from "./chunk-3FWLW7FS.js";
@@ -312,7 +315,8 @@ var gotoCommand = registerCommand({
   parameters: z.object({
     url: z.string(),
     waitUntil: z.enum(["load", "domcontentloaded", "networkidle", "commit"]).optional(),
-    timeout: z.number().optional()
+    timeout: z.number().optional(),
+    referrer: z.string().optional()
   }),
   result: z.object({
     url: z.string(),
@@ -333,7 +337,9 @@ var gotoCommand = registerCommand({
     try {
       response = await ctx.page.goto(url, {
         waitUntil: p.waitUntil || "domcontentloaded",
-        ...p.timeout ? { timeout: p.timeout } : {}
+        ...p.timeout ? { timeout: p.timeout } : {},
+        // referrer（d54）：模拟从源页面点链接进入 —— document.referrer 非空
+        ...p.referrer ? { referer: p.referrer } : {}
       });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
@@ -860,21 +866,34 @@ var scrollCommand = registerCommand({
   }),
   handler: async (p, ctx) => {
     const distance = p.distance ?? 500;
-    const deltas = {
-      down: [0, distance],
-      up: [0, -distance],
-      right: [distance, 0],
-      left: [-distance, 0]
-    };
-    const [dx, dy] = deltas[p.direction];
+    const sign = { down: 1, up: -1, right: 1, left: -1 };
+    const vertical = p.direction === "down" || p.direction === "up";
+    const s = sign[p.direction];
     if (p.selector) {
       const element = ctx.page.locator(p.selector).first();
       await element.evaluate((el, args) => {
         const [dxx, dyy] = args;
         el.scrollBy(dxx, dyy);
-      }, [dx, dy]);
+      }, [vertical ? 0 : distance * s, vertical ? distance * s : 0]);
+    } else if (process.env.XBROWSER_STEALTH !== "off") {
+      let acc = 0;
+      let step = 0;
+      while (acc < distance && step < 60) {
+        const d = Math.min(wheelDelta(step), distance - acc);
+        if (d < 1) break;
+        await ctx.page.mouse.wheel(
+          vertical ? 0 : d * s,
+          vertical ? d * s : 0
+        );
+        acc += d;
+        step++;
+        await sleep(rand(16, 28));
+      }
     } else {
-      await ctx.page.mouse.wheel(dx, dy);
+      await ctx.page.mouse.wheel(
+        vertical ? 0 : distance * s,
+        vertical ? distance * s : 0
+      );
     }
     return ok5({ direction: p.direction, distance });
   }
@@ -7041,7 +7060,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-5A6AL62M.js");
+    const { findTargetPage } = await import("./browser-YYMKZWTU.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -7321,6 +7340,9 @@ async function executeChain(input, options) {
     for (const pipeline of pipelines) {
       const { type, pipeline: commands } = pipeline;
       for (const cmdStr of commands) {
+        if (process.env.XBROWSER_CHAIN_PACE === "human" && results.length > 0) {
+          await new Promise((r) => setTimeout(r, 800 + Math.random() * 1700));
+        }
         const parts = splitCommand(cmdStr);
         if (parts.length === 0) continue;
         const cmdName = parts[0];
@@ -8857,7 +8879,7 @@ function createRPCHandler() {
     if (isNewFormat) {
       try {
         const replayErrors = [];
-        const { SessionReplayer } = await import("./session-replayer-I3PJFO3H.js");
+        const { SessionReplayer } = await import("./session-replayer-DKHXF3DZ.js");
         const replayer = new SessionReplayer({
           page: session.page,
           stepDelay: slowMo * 500,

package/dist/index.d.ts

@@ -316,6 +316,8 @@ interface XBKeyboard {
     press(key: string, opts?: {
         delay?: number;
     }): Promise<void>;
+    /** Navigation key with CDP 'keyDown' type (carries browser default actions) */
+    pressNav(key: string): Promise<void>;
     down(key: string): Promise<void>;
     up(key: string): Promise<void>;
     type(text: string, opts?: {

package/dist/index.js

@@ -92,8 +92,12 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-B753M33E.js";
-import "./chunk-PYQGDBAF.js";
+} from "./chunk-K5E4CWRV.js";
+import {
+  rand,
+  sleep,
+  wheelDelta
+} from "./chunk-NTTFKS6T.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -385,7 +389,8 @@ var gotoCommand = registerCommand({
   parameters: z.object({
     url: z.string(),
     waitUntil: z.enum(["load", "domcontentloaded", "networkidle", "commit"]).optional(),
-    timeout: z.number().optional()
+    timeout: z.number().optional(),
+    referrer: z.string().optional()
   }),
   result: z.object({
     url: z.string(),
@@ -406,7 +411,9 @@ var gotoCommand = registerCommand({
     try {
       response = await ctx.page.goto(url, {
         waitUntil: p.waitUntil || "domcontentloaded",
-        ...p.timeout ? { timeout: p.timeout } : {}
+        ...p.timeout ? { timeout: p.timeout } : {},
+        // referrer（d54）：模拟从源页面点链接进入 —— document.referrer 非空
+        ...p.referrer ? { referer: p.referrer } : {}
       });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
@@ -933,21 +940,34 @@ var scrollCommand = registerCommand({
   }),
   handler: async (p, ctx) => {
     const distance = p.distance ?? 500;
-    const deltas = {
-      down: [0, distance],
-      up: [0, -distance],
-      right: [distance, 0],
-      left: [-distance, 0]
-    };
-    const [dx, dy] = deltas[p.direction];
+    const sign = { down: 1, up: -1, right: 1, left: -1 };
+    const vertical = p.direction === "down" || p.direction === "up";
+    const s = sign[p.direction];
     if (p.selector) {
       const element = ctx.page.locator(p.selector).first();
       await element.evaluate((el, args) => {
         const [dxx, dyy] = args;
         el.scrollBy(dxx, dyy);
-      }, [dx, dy]);
+      }, [vertical ? 0 : distance * s, vertical ? distance * s : 0]);
+    } else if (process.env.XBROWSER_STEALTH !== "off") {
+      let acc = 0;
+      let step = 0;
+      while (acc < distance && step < 60) {
+        const d = Math.min(wheelDelta(step), distance - acc);
+        if (d < 1) break;
+        await ctx.page.mouse.wheel(
+          vertical ? 0 : d * s,
+          vertical ? d * s : 0
+        );
+        acc += d;
+        step++;
+        await sleep(rand(16, 28));
+      }
     } else {
-      await ctx.page.mouse.wheel(dx, dy);
+      await ctx.page.mouse.wheel(
+        vertical ? 0 : distance * s,
+        vertical ? distance * s : 0
+      );
     }
     return ok5({ direction: p.direction, distance });
   }
@@ -7873,7 +7893,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-KJWBHGHX.js");
+    const { findTargetPage } = await import("./browser-4FKHBUBJ.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -8153,6 +8173,9 @@ async function executeChain(input, options) {
     for (const pipeline of pipelines) {
       const { type, pipeline: commands } = pipeline;
       for (const cmdStr of commands) {
+        if (process.env.XBROWSER_CHAIN_PACE === "human" && results.length > 0) {
+          await new Promise((r) => setTimeout(r, 800 + Math.random() * 1700));
+        }
         const parts = splitCommand(cmdStr);
         if (parts.length === 0) continue;
         const cmdName = parts[0];
@@ -10561,12 +10584,33 @@ function normalizeSelector(input) {
 
 // src/cli/browser-routes.ts
 import { helpGenerator } from "@dyyz1993/xcli-core";
+function autoCompleteParams(cmdName, params, options) {
+  try {
+    const cmd = getCommand(cmdName);
+    if (!cmd?.parameters) return params;
+    const schema = asZodSchema(cmd.parameters);
+    const shape = schema?.shape ?? schema?._def?.shape;
+    if (!shape) return params;
+    for (const key of Object.keys(shape)) {
+      if (params[key] !== void 0) continue;
+      const v = options[key];
+      if (v === void 0 || v === true && key === "json" || key === "yaml") continue;
+      if (typeof v === "string" && v === "") continue;
+      params[key] = v;
+    }
+    return params;
+  } catch {
+    return params;
+  }
+}
 function parseSelectorFlags(args, options) {
-  const selector = options.s || options.selector || options["selector"];
-  const value = options.v || options.value;
+  const rawSelector = options.s ?? options.selector;
+  const rawValue = options.v ?? options.value;
+  const selector = typeof rawSelector === "string" ? normalizeSelector(rawSelector) : void 0;
+  const value = typeof rawValue === "string" ? rawValue : void 0;
   const remaining = args.filter((a) => !a.startsWith("-"));
   return {
-    selector: selector ? normalizeSelector(selector) : void 0,
+    selector,
     value,
     remaining
   };
@@ -10654,7 +10698,11 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
         if (!sel || !txt)
           outputError("Usage: xbrowser type <selector> <text>\n       xbrowser type -s <selector> -v <text>");
         cmdName = "type";
-        params = { selector: sel, text: txt };
+        params = {
+          selector: sel,
+          text: txt,
+          ...options.delay !== void 0 ? { delay: Number(options.delay) } : {}
+        };
         break;
       }
       case "press": {
@@ -10796,7 +10844,13 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
           outputError("Usage: xbrowser mouse <move|click|dblclick> <x> <y>\n       xbrowser mouse --action <action> --x <x> --y <y>");
         }
         cmdName = "mouse";
-        params = { action, x, y, ...options.button ? { button: options.button } : {} };
+        params = {
+          action,
+          x,
+          y,
+          ...options.button ? { button: options.button } : {},
+          ...options.steps !== void 0 ? { steps: Number(options.steps) } : {}
+        };
         break;
       }
       case "html":
@@ -10998,6 +11052,7 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
   if (target) {
     params = { ...params, _target: target };
   }
+  params = autoCompleteParams(cmdName, params, options);
   const tabIndex = options.tab;
   if (tabIndex !== void 0) {
     params = { ...params, _tabIndex: Number(tabIndex) };
@@ -14051,7 +14106,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
               const targetPage = pages[cmdTabIndex];
               await targetPage.bringToFront().catch(() => {
               });
-              const { setActivePage: setActivePage2 } = await import("./browser-KJWBHGHX.js");
+              const { setActivePage: setActivePage2 } = await import("./browser-4FKHBUBJ.js");
               setActivePage2(session, targetPage);
             }
           }
@@ -17224,7 +17279,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-AHKUT57K.js");
+    const { launch } = await import("./cdp-driver-QX72T7SU.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

package/dist/{session-replayer-I3PJFO3H.js → session-replayer-DKHXF3DZ.js}

@@ -34,7 +34,7 @@ var SessionReplayer = class {
     if (this.opts.page) {
       this.page = this.opts.page;
     } else if (this.opts.cdpUrl) {
-      const { launch } = await import("./cdp-driver-4SFS6GNY.js");
+      const { launch } = await import("./cdp-driver-7RW4NY2X.js");
       const { browser } = await launch({ cdpEndpoint: this.opts.cdpUrl });
       let contexts = browser.contexts();
       for (let i = 0; i < 10 && contexts.length === 0; i++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbrowser/cli",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "Browser automation CLI for web scraping, headless browsing, SEO analysis, and AI agent workflows. A command-line alternative to Playwright, Puppeteer, and Selenium.",
   "type": "module",
   "bin": {