@xbrowser/cli 1.19.0 → 1.21.0

package/dist/{browser-Y5SIE6LY.js → browser-C2VEOJC2.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-C6PW3CPA.js";
-import "./chunk-GKYSCHT4.js";
+} from "./chunk-AVSTNODR.js";
+import "./chunk-CLYZPSDR.js";
 import "./chunk-3FWLW7FS.js";
 import "./chunk-3KZ34AUC.js";
 import "./chunk-GDKLH7ZY.js";

package/dist/{browser-6LH6KJSW.js → browser-CNBSH53B.js}

@@ -20,7 +20,7 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-KLXLNQI5.js";
+} from "./chunk-ESJYANQO.js";
 import "./chunk-3KZ34AUC.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{browser-TUD2KA5G.js → browser-VZOOFLAH.js}

@@ -20,12 +20,12 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-2BPZ25RE.js";
-import "./chunk-LKJZYVIX.js";
+} from "./chunk-Z5RTK4GW.js";
+import "./chunk-HWWG2ISJ.js";
 import "./chunk-3KZ34AUC.js";
 import "./chunk-GDKLH7ZY.js";
-import "./chunk-A6LPGFAL.js";
-import "./chunk-H2A5JUK5.js";
+import "./chunk-WYETQ5C7.js";
+import "./chunk-75DNUI6M.js";
 import "./chunk-KFQGP6VL.js";
 export {
   closeAllSessions,

package/dist/{cdp-driver-2EECZW4X.js → cdp-driver-26LGCHXV.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-LKJZYVIX.js";
+} from "./chunk-HWWG2ISJ.js";
 import {
   connectToCDP,
   findChrome,
@@ -23,7 +23,7 @@ import {
   launchChrome
 } from "./chunk-3KZ34AUC.js";
 import "./chunk-GDKLH7ZY.js";
-import "./chunk-H2A5JUK5.js";
+import "./chunk-75DNUI6M.js";
 import "./chunk-KFQGP6VL.js";
 export {
   CDPConnection,

package/dist/{cdp-driver-E7G3VHIB.js → cdp-driver-7Z6ZAT5E.js}

@@ -21,6 +21,25 @@ import { EventEmitter } from "events";
 
 // src/cdp-driver/stealth.ts
 var DEFAULT_STEALTH_CONFIG = {
+  // S191: macOS arm64 + Chrome 151 真实采样（来源：登录桥只读通道）
+  uaChProfile: {
+    brands: [
+      { brand: "Not=A?Brand", version: "99" },
+      { brand: "Google Chrome", version: "151" },
+      { brand: "Chromium", version: "151" }
+    ],
+    platform: "macOS",
+    platformVersion: "26.2.0",
+    architecture: "arm",
+    bitness: "64",
+    model: "",
+    uaFullVersion: "151.0.7922.175",
+    fullVersionList: [
+      { brand: "Not=A?Brand", version: "99.0.0.0" },
+      { brand: "Google Chrome", version: "151.0.7922.175" },
+      { brand: "Chromium", version: "151.0.7922.175" }
+    ]
+  },
   bezierCurvature: [0.35, 0.6],
   noiseAmplitude: 5.5,
   overshootRange: [6, 14],
@@ -119,10 +138,13 @@ Object.assign(KEY_MAP, {
   "@": { key: "@", code: "Digit2", vk: 50, shift: true },
   "_": { key: "_", code: "Minus", vk: 189, shift: true }
 });
-function buildStealthInitScript() {
+function buildStealthInitScript(config = DEFAULT_STEALTH_CONFIG) {
+  const prof = config.uaChProfile;
+  const profJson = prof ? JSON.stringify(prof) : "null";
   return [
     "(function(){",
     '  window.__xbStealthVer="57";',
+    "  window.__xbUaChProf=" + profJson + ";",
     // 1. AEL event proxy
     "  var o=EventTarget.prototype.addEventListener;",
     "  var fc=new InputDeviceCapabilities({firesTouchEvents:false});",
@@ -185,9 +207,65 @@ function buildStealthInitScript() {
     '  Object.defineProperty(Screen.prototype,"height",{get:_gh,configurable:true});',
     '  Object.defineProperty(Screen.prototype,"availWidth",{get:_gw,configurable:true});',
     '  Object.defineProperty(Screen.prototype,"availHeight",{get:_gah,configurable:true});',
+    // S174: UA Headless 标记清洗——headless launch 的 UA 含 HeadlessChrome/xxx
+    // （最高频检测面），同步清洗 userAgent/appVersion/userAgentData(brands+高熵值)。
+    // 原型+实例双层覆写（S172 模式）。
+    "  try{",
+    '    var fixUA=function(ua){return String(ua).replace("HeadlessChrome","Chrome");};',
+    '    var fixBrands=function(list){return (list||[]).map(function(b){return (b.brand&&b.brand.indexOf("Headless")!==-1)?Object.assign({},b,{brand:b.brand.replace("HeadlessChrome","Chrome")}):b;});};',
+    '    var _nuad=Object.getOwnPropertyDescriptor(Navigator.prototype,"userAgentData");',
+    "    var wrapUAD=function(uad){",
+    "      if(!uad||uad.__xbUA)return uad;",
+    "      try{",
+    '        Object.defineProperty(uad,"brands",{get:function(){return fixBrands(_nuad.get.call(navigator).brands);},configurable:true});',
+    "        var _ghev=uad.getHighEntropyValues.bind(uad);",
+    "        uad.getHighEntropyValues=function(hints){return _ghev(hints).then(function(v){",
+    '          var o={};for(var k in v){o[k]=(typeof v[k]==="string")?fixUA(v[k]):(Array.isArray(v[k])?fixBrands(v[k]):v[k]);}',
+    "          return o;});};",
+    "        uad.__xbUA=true;",
+    "      }catch(e){}",
+    "      return uad;",
+    "    };",
+    '    var _nua=Object.getOwnPropertyDescriptor(Navigator.prototype,"userAgent");',
+    "    if(_nua&&_nua.get){",
+    "      var _nuag=function(){return fixUA(_nua.get.call(this));};",
+    '      _nuag.toString=function(){return "function get userAgent() { [native code] }";};',
+    '      Object.defineProperty(Navigator.prototype,"userAgent",{get:_nuag,configurable:true});',
+    "    }",
+    '    Object.defineProperty(navigator,"userAgent",{get:function(){return fixUA(_nua?_nua.get.call(this):"");},configurable:true});',
+    "    if(_nuad&&_nuad.get){",
+    "      var _nuadg=function(){return wrapUAD(_nuad.get.call(this));};",
+    '      _nuadg.toString=function(){return "function get userAgentData() { [native code] }";};',
+    '      Object.defineProperty(Navigator.prototype,"userAgentData",{get:_nuadg,configurable:true});',
+    "    }",
+    // S190: userAgentData 垫片——headless Chrome 151 不暴露 UA-CH API，
+    // 缺失本身即 headless 指纹。从 UA 派生 brands/platform 垫片 + getHighEntropyValues。
+    "    if(!navigator.userAgentData && window.__xbUaChProf){",
+    "      var prof = window.__xbUaChProf;",
+    "      var uad={",
+    '        brands:prof.brands.map(function(b){return {brand:b.brand,version:b.version.split(".")[0]}}),',
+    "        mobile:false,",
+    "        platform:prof.platform,",
+    "        getHighEntropyValues:function(hints){",
+    "          return Promise.resolve().then(function(){",
+    "            var all={brands:uad.brands,mobile:false,platform:prof.platform,",
+    "              platformVersion:prof.platformVersion,architecture:prof.architecture,bitness:prof.bitness,model:prof.model,",
+    "              uaFullVersion:prof.uaFullVersion,",
+    "              fullVersionList:prof.fullVersionList};",
+    "            var out={};",
+    "            (hints||[]).forEach(function(h){if(h in all)out[h]=all[h]});",
+    "            return out;",
+    "          });",
+    "        },",
+    "        toJSON:function(){return{brands:uad.brands,mobile:false,platform:prof.platform}}",
+    "      };",
+    '      Object.defineProperty(navigator,"userAgentData",{get:function(){return uad},configurable:true});',
+    "    }",
+    "  }catch(e){}",
     // hasFocus 与 visibilityState 联动（d29）：恒 true 在 hidden 标签下暴露
     // —— 真实浏览器失焦/后台时 hasFocus=false
-    '  document.hasFocus=function(){return document.visibilityState==="visible";};',
+    // S172: 原型层覆写——实例赋值可被 Document.prototype.hasFocus.call(document) 逃逸
+    '  Document.prototype.hasFocus=function(){return document.visibilityState==="visible";};',
     // 4. Canvas/WebGL fingerprint: per-session stable noise (d20).
     //    Headless software raster differs subtly from Chrome GPU raster —
     //    toDataURL hashes fingerprint the rasterizer. Inject a stable
@@ -250,26 +328,25 @@ function buildStealthInitScript() {
     "  }catch(e){}",
     // 3b. Font metrics + speechSynthesis + battery (d22): headless tells
     "  try{",
-    "    var _mt=CanvasRenderingContext2D.prototype.measureText;",
     '    var _tmw=Object.getOwnPropertyDescriptor(TextMetrics.prototype,"width");',
-    "    CanvasRenderingContext2D.prototype.measureText=function(t){",
-    "      var m=_mt.call(this,t);",
-    '      try{Object.defineProperty(m,"width",{get:function(){return _tmw.get.call(m)+_dx*0.01;},configurable:true});}catch(e){}',
-    "      return m;",
-    "    };",
+    "    if(_tmw&&_tmw.get){",
+    "      // S172: \u539F\u578B\u5C42\u8986\u5199\u2014\u2014\u5B9E\u4F8B(m)\u8986\u5199\u53EF\u88AB TextMetrics.prototype.width getter \u9003\u9038",
+    '      Object.defineProperty(TextMetrics.prototype,"width",{get:function(){return _tmw.get.call(this)+_dx*0.01;},configurable:true});',
+    "    }",
     "  }catch(e){}",
     "  try{",
     '    var _fakeVoices=["Alex","Daniel","Karen","Moira","Ralph","Samantha","Ting-Ting","Mei-Jia","Sinji","Yunda"];',
-    "    var _sv=speechSynthesis.getVoices.bind(speechSynthesis);",
-    "    speechSynthesis.getVoices=function(){",
-    "      var real=_sv();",
+    // S172: 原型层覆写——实例赋值可被 SpeechSynthesis.prototype.getVoices.call() 逃逸
+    "    var _sv=SpeechSynthesis.prototype.getVoices;",
+    "    SpeechSynthesis.prototype.getVoices=function(){",
+    "      var real=_sv.call(this);",
     "      if(real&&real.length>50)return real;",
     // 注意阈值从 0 改 50：iframe 原生约 10 个 —— 原阈值下 iframe 返回原生 10 个
     // 而不是伪装 180（d33 暴露）。>50 = 主文档伪装列表已生效，其余返回伪装。
     '      return _fakeVoices.map(function(n,i){return {name:n,lang:i<2?"en-US":i<6?"en-GB":"zh-TW",localService:true,default:i===0,voiceURI:n};});',
     "    };",
     // d33 修复：iframe 的 speechSynthesis 是独立实例（主文档 hook 不可达）——
-    // 轮询同源 iframe，对其 contentWindow.speechSynthesis 同样 patch
+    // 轮询同源 iframe，对其 contentWindow 的原型同样 patch（S172: 原型层，防逃逸）
     "  try{",
     "    var _piv=function(){",
     '      var frs=document.querySelectorAll("iframe");',
@@ -277,8 +354,8 @@ function buildStealthInitScript() {
     "        var cw=frs[i].contentWindow;",
     "        if(!cw||!cw.speechSynthesis||cw.speechSynthesis.__xbP)continue;",
     "        cw.speechSynthesis.__xbP=true;",
-    "        var _sv2=cw.speechSynthesis.getVoices.bind(cw.speechSynthesis);",
-    "        cw.speechSynthesis.getVoices=function(){var r=_sv2();if(r&&r.length>50)return r;",
+    "        var _sv2=cw.SpeechSynthesis.prototype.getVoices;",
+    "        cw.SpeechSynthesis.prototype.getVoices=function(){var r=_sv2.call(this);if(r&&r.length>50)return r;",
     '          return _fakeVoices.map(function(n,j){return{name:n,lang:j<2?"en-US":j<6?"en-GB":"zh-TW",localService:true,default:j===0,voiceURI:n};});};',
     "      }catch(e2){}}",
     "    };",
@@ -313,10 +390,21 @@ function buildStealthInitScript() {
     // 3d-2. performance.now precision clamp (d34): full-precision timestamps
     //     (11 decimals) differ from site-isolation-clamped real Chrome (~100μs).
     "  try{",
-    "    var _pn=performance.now.bind(performance);",
-    "    performance.now=function(){return Math.round(_pn()*10)/10;};",
+    "    var _pn=Performance.prototype.now;",
+    "    // S172: \u539F\u578B\u5C42\u8986\u5199\u2014\u2014\u5B9E\u4F8B\u8D4B\u503C\u53EF\u88AB Performance.prototype.now.call(performance) \u9003\u9038",
+    "    Performance.prototype.now=function(){return Math.round(_pn.call(this)*10)/10;};",
     '    var _pto=Object.getOwnPropertyDescriptor(Performance.prototype,"timeOrigin");',
-    '    if(_pto&&_pto.get){Object.defineProperty(performance,"timeOrigin",{get:function(){return _pto.get.call(performance);},configurable:true});}',
+    "    if(_pto&&_pto.get){",
+    "      // S173: timeOrigin \u771F\u4F2A\u88C5\u2014\u2014\u5360\u4F4D\u5C42\uFF08\u8FD4\u56DE\u771F\u503C\uFF09\u5347\u7EA7\u4E3A\u4F1A\u8BDD\u7EA7\u968F\u673A\u504F\u79FB\u3002",
+    "      // \u9632 cross-page \u5BFC\u822A\u65F6\u523B\u5173\u8054\uFF1A\u4E0D\u540C\u7AD9\u70B9\u7528 timeOrigin \u7CBE\u786E\u5BF9\u9F50\u7528\u6237\u884C\u4E3A\u6863\u6848\u3002",
+    "      // \u504F\u79FB\u7531\u672C\u9875 _seed \u6D3E\u751F\uFF08\u9875\u5185\u81EA\u6D3D\uFF0Cnow()+\u504F\u79FB\u4E00\u81F4\uFF09\uFF0C\u8DE8\u9875\u968F\u673A\uFF08\u4E0D\u53EF\u5173\u8054\uFF09\u3002",
+    "      var _toff=Math.floor((_seed/2147483647)*600000-300000);",
+    "      var _tog=function(){return _pto.get.call(performance)+_toff;};",
+    '      _tog.toString=function(){return "function get timeOrigin() { [native code] }";};',
+    "      // S172 \u5BA1\u8BA1\uFF1A\u5B9E\u4F8B\u8986\u5199\u53EF\u88AB\u539F\u578B getter \u9003\u9038\u2014\u2014\u539F\u578B\u5C42\u8986\u5199",
+    '      Object.defineProperty(Performance.prototype,"timeOrigin",{get:_tog,configurable:true});',
+    '      Object.defineProperty(performance,"timeOrigin",{get:_tog,configurable:true});',
+    "    }",
     "  }catch(e){}",
     // 3f. getCoalescedEvents 合成（d47）：真实鼠标 125Hz 采样被浏览器按帧合并，
     //     快速移动时 pointermove.getCoalescedEvents() 返回 2~6 个事件（群内
@@ -430,6 +518,9 @@ function buildStealthInitScript() {
     '    if(this===AnalyserNode.prototype.getFloatFrequencyData)return"function getFloatFrequencyData() { [native code] }";',
     '    if(this===AudioBuffer.prototype.getChannelData)return"function getChannelData() { [native code] }";',
     '    if(this===_gceH)return"function getCoalescedEvents() { [native code] }";',
+    '    if(this===Document.prototype.hasFocus)return"function hasFocus() { [native code] }";',
+    '    if(this===Performance.prototype.now)return"function now() { [native code] }";',
+    '    if(this===SpeechSynthesis.prototype.getVoices)return"function getVoices() { [native code] }";',
     "    return _ts.call(this);",
     "  };",
     // 4. onclick prototype hijack (dual-stream consistency)
@@ -1984,7 +2075,7 @@ var XBPageImpl = class _XBPageImpl {
       try {
         await this.conn.send(
           "Page.addScriptToEvaluateOnNewDocument",
-          { source: buildStealthInitScript() },
+          { source: buildStealthInitScript({ ...DEFAULT_STEALTH_CONFIG, ...this._contextImpl.stealthConfig ?? {} }) },
           this.sessionId
         );
       } catch {
@@ -3241,6 +3332,10 @@ var XBContextImpl = class {
     this.options = opts;
     this.setupAutoAttach();
   }
+  /** S194: 任务 tab 的 stealth 配置（UA-CH 档案等）经 context 传给 page 层 */
+  get stealthConfig() {
+    return this.options.stealthConfig;
+  }
   async newPage() {
     if (this.closed) throw new Error("Context is closed");
     const { targetId } = await this._browser._createTarget(this.contextId);
@@ -3407,20 +3502,8 @@ var XBContextImpl = class {
 
 // src/cdp-driver/browser.ts
 var XBBrowserImpl = class {
-  conn;
-  _emitter = new EventEmitter3();
-  _contexts = /* @__PURE__ */ new Map();
-  _disconnected = false;
-  childProcess = null;
-  tmpDir;
-  _exitHandler = null;
-  /**
-   * Original CDP endpoint (HTTP or ws URL) used to construct this browser.
-   * Used by discoverContexts() as a fallback to HTTP /json/list when
-   * Target.getTargets doesn't return page-type targets (e.g. cdp-tunnel proxy).
-   */
-  cdpEndpoint;
-  constructor(conn, childProcess, tmpDir, cdpEndpoint) {
+  constructor(conn, childProcess, tmpDir, cdpEndpoint, launchOpts) {
+    this.launchOpts = launchOpts;
     this.conn = conn;
     this.childProcess = childProcess ?? null;
     this.tmpDir = tmpDir;
@@ -3448,6 +3531,20 @@ var XBBrowserImpl = class {
       process.on("exit", this._exitHandler);
     }
   }
+  launchOpts;
+  conn;
+  _emitter = new EventEmitter3();
+  _contexts = /* @__PURE__ */ new Map();
+  _disconnected = false;
+  childProcess = null;
+  tmpDir;
+  _exitHandler = null;
+  /**
+   * Original CDP endpoint (HTTP or ws URL) used to construct this browser.
+   * Used by discoverContexts() as a fallback to HTTP /json/list when
+   * Target.getTargets doesn't return page-type targets (e.g. cdp-tunnel proxy).
+   */
+  cdpEndpoint;
   get disconnected() {
     return this._disconnected;
   }
@@ -3475,6 +3572,9 @@ var XBBrowserImpl = class {
     this._emitter.emit("disconnected");
   }
   async newContext(opts = {}) {
+    if (this.launchOpts?.stealthConfig && !opts.stealthConfig) {
+      opts = { ...opts, stealthConfig: this.launchOpts.stealthConfig };
+    }
     if (this._disconnected) {
       throw new Error("Browser is disconnected");
     }
@@ -3701,6 +3801,9 @@ function extractAllStrings(rawArgs) {
   }
   return strings.length > 0 ? strings.join("\n") : null;
 }
+function isProbeMarked(code) {
+  return code.includes("/* @xb-probe */");
+}
 
 // src/cdp-interceptor/rules/dom-mutation.ts
 var DOM_PATTERNS = [
@@ -4263,6 +4366,7 @@ var eventSimulationRule = {
   evaluate(ctx) {
     const userCode = extractUserCode(ctx);
     if (!userCode) return null;
+    if (isProbeMarked(userCode)) return null;
     for (const p of EVENT_PATTERNS) {
       if (p.pattern.test(userCode)) {
         return {
@@ -4590,6 +4694,11 @@ function createRuleEngine(customRules) {
         ...ctx,
         sessionState: getSessionState(ctx.sessionId)
       };
+      try {
+        const code = typeof ctx.params?.expression === "string" ? ctx.params.expression : JSON.stringify(ctx.params ?? "");
+        if (isProbeMarked(code)) return null;
+      } catch {
+      }
       for (const rule of rules) {
         if (rule.canHandle && !rule.canHandle(fullCtx)) continue;
         const decision = rule.evaluate(fullCtx);
@@ -4971,7 +5080,13 @@ async function launch(options = {}) {
   const conn = new CDPConnection(wsEndpoint);
   await conn.ready();
   const httpEndpoint = options.cdpEndpoint && !options.cdpEndpoint.startsWith("ws") ? options.cdpEndpoint : void 0;
-  const browser = new XBBrowserImpl(conn, childProcess, tmpDir, httpEndpoint);
+  const browser = new XBBrowserImpl(
+    conn,
+    childProcess,
+    tmpDir,
+    httpEndpoint,
+    options.stealthConfig ? { stealthConfig: options.stealthConfig } : void 0
+  );
   return { browser, wsEndpoint };
 }
 export {

package/dist/{cdp-driver-7HO5SRNN.js → cdp-driver-KFX4A6WR.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-GKYSCHT4.js";
+} from "./chunk-CLYZPSDR.js";
 import "./chunk-3FWLW7FS.js";
 import {
   connectToCDP,

package/dist/{chunk-H2A5JUK5.js → chunk-75DNUI6M.js}

@@ -39,6 +39,9 @@ function extractAllStrings(rawArgs) {
   }
   return strings.length > 0 ? strings.join("\n") : null;
 }
+function isProbeMarked(code) {
+  return code.includes("/* @xb-probe */");
+}
 
 // src/cdp-interceptor/rules/dom-mutation.ts
 var DOM_PATTERNS = [
@@ -601,6 +604,7 @@ var eventSimulationRule = {
   evaluate(ctx) {
     const userCode = extractUserCode(ctx);
     if (!userCode) return null;
+    if (isProbeMarked(userCode)) return null;
     for (const p of EVENT_PATTERNS) {
       if (p.pattern.test(userCode)) {
         return {
@@ -928,6 +932,11 @@ function createRuleEngine(customRules) {
         ...ctx,
         sessionState: getSessionState(ctx.sessionId)
       };
+      try {
+        const code = typeof ctx.params?.expression === "string" ? ctx.params.expression : JSON.stringify(ctx.params ?? "");
+        if (isProbeMarked(code)) return null;
+      } catch {
+      }
       for (const rule of rules) {
         if (rule.canHandle && !rule.canHandle(fullCtx)) continue;
         const decision = rule.evaluate(fullCtx);

package/dist/{chunk-C6PW3CPA.js → chunk-AVSTNODR.js}

@@ -1,7 +1,7 @@
 import {
   createRuleEngine,
   launch
-} from "./chunk-GKYSCHT4.js";
+} from "./chunk-CLYZPSDR.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";