@be-link/cls-logger 1.0.1-beta.2 → 1.0.1-beta.21

package/dist/index.esm.js

@@ -1,4 +1,4 @@
-import { AsyncClient, LogGroup, Log, PutLogsRequest } from 'tencentcloud-cls-sdk-js-web';
+import { onFCP, onLCP, onCLS, onINP, onTTFB } from 'web-vitals';
 
 function isPlainObject(value) {
     return Object.prototype.toString.call(value) === '[object Object]';
@@ -133,163 +133,979 @@ function stringifyLogValue(v) {
     }
 }
 
-const DEFAULT_IGNORE$1 = ['cls.tencentcs.com', /\/cls\//i];
-function isClsSendingNow() {
+function enterClsSendingGuard() {
     const g = globalThis;
-    return (g.__beLinkClsLoggerSendingCount__ ?? 0) > 0;
+    const next = (g.__beLinkClsLoggerSendingCount__ ?? 0) + 1;
+    g.__beLinkClsLoggerSendingCount__ = next;
+    return () => {
+        const cur = g.__beLinkClsLoggerSendingCount__ ?? 0;
+        g.__beLinkClsLoggerSendingCount__ = cur > 0 ? cur - 1 : 0;
+    };
 }
-function shouldIgnoreUrl$1(url, ignoreUrls) {
-    for (const rule of ignoreUrls) {
-        if (typeof rule === 'string') {
-            if (url.includes(rule))
-                return true;
-            continue;
+/**
+ * CLS Logger 核心基类
+ * - 负责所有上报、队列、监控逻辑
+ * - 不包含具体的 SDK 加载实现（由子类负责）
+ * - 这样可以把 web/mini 的 SDK 依赖彻底解耦到子入口
+ */
+class ClsLoggerCore {
+    constructor() {
+        this.sdk = null;
+        this.sdkPromise = null;
+        this.sdkOverride = null;
+        this.sdkLoaderOverride = null;
+        this.client = null;
+        this.clientPromise = null;
+        this.topicId = '17475bcd-6315-4b20-859c-e7b087fb3683';
+        this.endpoint = 'https://ap-shanghai.cls.tencentcs.com';
+        this.retryTimes = 3;
+        this.source = '127.0.0.1';
+        this.enabled = true;
+        this.projectId = '';
+        this.projectName = '';
+        this.appId = '';
+        this.appVersion = '';
+        this.envType = 'browser';
+        this.userGenerateBaseFields = null;
+        this.autoGenerateBaseFields = null;
+        this.storageKey = 'beLink_logs';
+        this.batchSize = 15;
+        // 参考文档：内存队列批量发送（500ms 或 20 条触发）
+        this.memoryQueue = [];
+        this.batchMaxSize = 20;
+        this.batchIntervalMs = 500;
+        this.batchTimer = null;
+        this.batchTimerDueAt = null;
+        this.initTs = 0;
+        this.startupDelayMs = 0;
+        this.useIdleCallback = false;
+        this.idleTimeout = 3000;
+        this.visibilityCleanup = null;
+        // 参考文档：失败缓存 + 重试
+        this.failedCacheKey = 'cls_failed_logs';
+        this.failedCacheMax = 200;
+        this.requestMonitorStarted = false;
+        this.errorMonitorStarted = false;
+        this.performanceMonitorStarted = false;
+        this.behaviorMonitorStarted = false;
+        this.behaviorMonitorCleanup = null;
+    }
+    /**
+     * 子类可按需重写（默认检测 wx）
+     */
+    detectEnvType() {
+        const g = globalThis;
+        // 微信、支付宝、字节跳动、UniApp 等小程序环境通常都有特定全局变量
+        if ((g.wx && typeof g.wx.getSystemInfoSync === 'function') ||
+            (g.my && typeof g.my.getSystemInfoSync === 'function') ||
+            (g.tt && typeof g.tt.getSystemInfoSync === 'function') ||
+            (g.uni && typeof g.uni.getSystemInfoSync === 'function')) {
+            return 'miniprogram';
+        }
+        return 'browser';
+    }
+    init(options) {
+        this.initTs = Date.now();
+        const topicId = options?.tencentCloud?.topicID ?? options?.topic_id ?? options?.topicID ?? this.topicId;
+        const endpoint = options?.tencentCloud?.endpoint ?? options?.endpoint ?? this.endpoint;
+        const retryTimes = options?.tencentCloud?.retry_times ?? options?.retry_times ?? this.retryTimes;
+        const source = options?.source ?? this.source;
+        if (!topicId) {
+            // eslint-disable-next-line no-console
+            console.warn('ClsLogger.init 没有传 topicID/topic_id');
+            return;
+        }
+        const nextEnvType = options.envType ?? this.detectEnvType();
+        // envType/endpoint/retryTimes 变化时：重置 client（以及可能的 sdk）
+        const envChanged = nextEnvType !== this.envType;
+        const endpointChanged = endpoint !== this.endpoint;
+        const retryChanged = retryTimes !== this.retryTimes;
+        if (envChanged || endpointChanged || retryChanged) {
+            this.client = null;
+            this.clientPromise = null;
         }
+        if (envChanged) {
+            this.sdk = null;
+            this.sdkPromise = null;
+        }
+        this.topicId = topicId;
+        this.endpoint = endpoint;
+        this.retryTimes = retryTimes;
+        this.source = source;
+        this.userId = options.userId ?? this.userId;
+        this.userName = options.userName ?? this.userName;
+        this.projectId = options.projectId ?? this.projectId;
+        this.projectName = options.projectName ?? this.projectName;
+        this.appId = options.appId ?? this.appId;
+        this.appVersion = options.appVersion ?? this.appVersion;
+        this.envType = nextEnvType;
+        this.enabled = options.enabled ?? true;
+        // 可选：外部注入 SDK（优先级：sdkLoader > sdk）
+        this.sdkLoaderOverride = options.sdkLoader ?? this.sdkLoaderOverride;
+        this.sdkOverride = options.sdk ?? this.sdkOverride;
+        this.userGenerateBaseFields = options.generateBaseFields ?? this.userGenerateBaseFields;
+        this.autoGenerateBaseFields = this.createDeviceInfoBaseFields(options.deviceInfo);
+        this.storageKey = options.storageKey ?? this.storageKey;
+        this.batchSize = options.batchSize ?? this.batchSize;
+        this.batchMaxSize = options.batch?.maxSize ?? this.batchMaxSize;
+        this.batchIntervalMs = options.batch?.intervalMs ?? this.batchIntervalMs;
+        this.startupDelayMs = options.batch?.startupDelayMs ?? this.startupDelayMs;
+        this.useIdleCallback = options.batch?.useIdleCallback ?? this.useIdleCallback;
+        this.idleTimeout = options.batch?.idleTimeout ?? this.idleTimeout;
+        this.failedCacheKey = options.failedCacheKey ?? this.failedCacheKey;
+        this.failedCacheMax = options.failedCacheMax ?? this.failedCacheMax;
+        // 预热（避免首条日志触发 import/初始化开销）
+        void this.getInstance().catch(() => {
+            // ignore
+        });
+        if (this.enabled) {
+            // 启动时尝试发送失败缓存
+            this.flushFailed();
+            // 添加页面可见性监听（确保页面关闭时数据不丢失）
+            this.setupVisibilityListener();
+            // 初始化后立即启动请求监听
+            this.startRequestMonitor(options.requestMonitor);
+            // 初始化后立即启动错误监控/性能监控
+            this.startErrorMonitor(options.errorMonitor);
+            this.startPerformanceMonitor(options.performanceMonitor);
+            // 初始化后立即启动行为埋点（PV/UV/点击）
+            this.startBehaviorMonitor(options.behaviorMonitor);
+        }
+    }
+    getBaseFields() {
+        let auto = undefined;
+        let user = undefined;
         try {
-            if (rule.test(url))
-                return true;
+            const autoRaw = this.autoGenerateBaseFields ? this.autoGenerateBaseFields() : undefined;
+            if (autoRaw && isPlainObject(autoRaw))
+                auto = normalizeFlatFields(autoRaw, 'deviceInfo');
         }
         catch {
-            // ignore invalid regex
+            auto = undefined;
         }
-    }
-    return false;
-}
-function sampleHit$2(sampleRate) {
-    if (sampleRate >= 1)
-        return true;
-    if (sampleRate <= 0)
-        return false;
-    return Math.random() < sampleRate;
-}
-function truncate$3(s, maxLen) {
-    if (!s)
-        return s;
-    return s.length > maxLen ? `${s.slice(0, maxLen)}...` : s;
-}
-function buildPayload(params) {
-    const { url, method, query, body, duration, startTime, status, success, error, options } = params;
-    if (!url)
-        return null;
-    if (shouldIgnoreUrl$1(url, options.ignoreUrls))
-        return null;
-    if (!sampleHit$2(options.sampleRate))
-        return null;
-    const payload = { url };
-    if (options.includeMethod && method)
-        payload.method = method;
-    if (options.includeQuery && query !== undefined)
-        payload.query = truncate$3(String(query), options.maxParamLength);
-    if (options.includeBody && body !== undefined)
-        payload.params = truncate$3(stringifyLogValue(body), options.maxParamLength);
-    if (typeof startTime === 'number')
-        payload.startTime = startTime;
-    if (typeof duration === 'number')
-        payload.duration = duration;
-    if (typeof status === 'number')
-        payload.status = status;
-    if (typeof success === 'boolean')
-        payload.success = success ? 1 : 0;
-    if (error !== undefined)
-        payload.error = truncate$3(stringifyLogValue(error), options.maxParamLength);
-    return payload;
-}
-function getAbsoluteUrlMaybe(url) {
-    try {
-        if (typeof window === 'undefined')
-            return url;
-        return new URL(url, window.location?.href).toString();
-    }
-    catch {
-        return url;
-    }
-}
-function installBrowserFetch(report, options) {
-    if (typeof window === 'undefined')
-        return;
-    const w = window;
-    if (w.__beLinkClsLoggerFetchInstalled__)
-        return;
-    if (typeof w.fetch !== 'function')
-        return;
-    w.__beLinkClsLoggerFetchInstalled__ = true;
-    w.__beLinkClsLoggerRawFetch__ = w.fetch;
-    w.fetch = async (input, init) => {
-        // 避免 CLS SDK 上报请求被 requestMonitor 捕获后递归上报（尤其在跨域失败时会“上报失败→再上报”）
-        if (isClsSendingNow())
-            return w.__beLinkClsLoggerRawFetch__(input, init);
-        let url = '';
-        let method = '';
-        let body = undefined;
-        const startTs = Date.now();
         try {
-            if (typeof input === 'string')
-                url = input;
-            else if (input instanceof URL)
-                url = input.toString();
-            else
-                url = input.url ?? '';
-            method = (init?.method ?? input?.method ?? 'GET');
-            body = init?.body;
+            const userRaw = this.userGenerateBaseFields ? this.userGenerateBaseFields() : undefined;
+            if (userRaw && isPlainObject(userRaw))
+                user = normalizeFlatFields({ ...userRaw }, 'generateBaseFields');
         }
         catch {
-            // ignore
+            user = undefined;
         }
-        const absUrl = getAbsoluteUrlMaybe(url);
-        const query = (() => {
+        if (auto && user)
+            return mergeFields(user, auto);
+        if (user)
+            return user;
+        if (auto)
+            return auto;
+        return undefined;
+    }
+    /**
+     * 设置页面可见性监听
+     * - visibilitychange: 页面隐藏时使用 sendBeacon 发送队列
+     * - pagehide: 作为移动端 fallback
+     */
+    setupVisibilityListener() {
+        if (typeof document === 'undefined' || typeof window === 'undefined')
+            return;
+        // 避免重复监听
+        if (this.visibilityCleanup)
+            return;
+        const handleVisibilityChange = () => {
+            if (document.visibilityState === 'hidden') {
+                this.flushBatchSync();
+            }
+        };
+        const handlePageHide = () => {
+            this.flushBatchSync();
+        };
+        document.addEventListener('visibilitychange', handleVisibilityChange);
+        window.addEventListener('pagehide', handlePageHide);
+        this.visibilityCleanup = () => {
+            document.removeEventListener('visibilitychange', handleVisibilityChange);
+            window.removeEventListener('pagehide', handlePageHide);
+        };
+    }
+    /**
+     * 同步发送内存队列（使用 sendBeacon）
+     * - 用于页面关闭时确保数据发送
+     * - sendBeacon 不可用时降级为缓存到 localStorage
+     */
+    flushBatchSync() {
+        if (this.memoryQueue.length === 0)
+            return;
+        // 清除定时器
+        if (this.batchTimer) {
             try {
-                const u = new URL(absUrl);
-                return u.search ? u.search.slice(1) : '';
+                if (this.useIdleCallback && typeof cancelIdleCallback !== 'undefined') {
+                    cancelIdleCallback(this.batchTimer);
+                }
+                else {
+                    clearTimeout(this.batchTimer);
+                }
             }
             catch {
-                return '';
+                // ignore
             }
-        })();
-        try {
-            const res = await w.__beLinkClsLoggerRawFetch__(input, init);
-            const duration = Date.now() - startTs;
-            const status = typeof res?.status === 'number' ? res.status : undefined;
-            const ok = typeof res?.ok === 'boolean' ? res.ok : status !== undefined ? status >= 200 && status < 400 : true;
-            const payload = buildPayload({
-                url: absUrl,
-                method,
-                query,
-                body,
-                startTime: startTs,
-                duration,
-                status,
-                success: ok,
-                options,
-            });
-            if (payload)
-                report(options.reportType, payload);
-            return res;
+            this.batchTimer = null;
         }
-        catch (err) {
-            const duration = Date.now() - startTs;
-            const payload = buildPayload({
-                url: absUrl,
-                method,
-                query,
-                body,
-                startTime: startTs,
-                duration,
-                success: false,
-                error: err,
-                options,
-            });
-            if (payload)
-                report(options.reportType, payload);
-            throw err;
+        this.batchTimerDueAt = null;
+        const logs = [...this.memoryQueue];
+        this.memoryQueue = [];
+        // 优先使用 sendBeacon（页面关闭时可靠发送）
+        if (typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function') {
+            try {
+                const payload = this.buildSendBeaconPayload(logs);
+                const blob = new Blob([payload], { type: 'application/json' });
+                const url = `${this.endpoint}/structuredlog?topic_id=${this.topicId}`;
+                const success = navigator.sendBeacon(url, blob);
+                if (!success) {
+                    // sendBeacon 返回 false 时，降级缓存
+                    this.cacheFailedReportLogs(logs);
+                }
+            }
+            catch {
+                this.cacheFailedReportLogs(logs);
+            }
         }
-    };
-}
-function installBrowserXhr(report, options) {
-    if (typeof window === 'undefined')
-        return;
-    const w = window;
-    if (w.__beLinkClsLoggerXhrInstalled__)
-        return;
+        else {
+            // 不支持 sendBeacon，降级缓存到 localStorage
+            this.cacheFailedReportLogs(logs);
+        }
+    }
+    /**
+     * 构建 sendBeacon 的 payload
+     */
+    buildSendBeaconPayload(logs) {
+        const logList = logs.map((log) => this.buildReportFields(log));
+        return JSON.stringify({
+            source: this.source,
+            logs: logList,
+        });
+    }
+    startRequestMonitor(requestMonitor) {
+        if (this.requestMonitorStarted)
+            return;
+        // 默认开启；传 false 则关闭
+        const enabled = requestMonitor === undefined ? true : !!requestMonitor;
+        if (!enabled)
+            return;
+        const opts = typeof requestMonitor === 'object' && requestMonitor ? requestMonitor : {};
+        this.requestMonitorStarted = true;
+        this.installRequestMonitor((type, data) => {
+            this.track(type, data);
+        }, {
+            ...opts,
+            enabled: opts.enabled ?? true,
+            clsEndpoint: this.endpoint,
+        });
+    }
+    startErrorMonitor(errorMonitor) {
+        if (this.errorMonitorStarted)
+            return;
+        const enabled = errorMonitor === undefined ? true : !!errorMonitor;
+        if (!enabled)
+            return;
+        this.errorMonitorStarted = true;
+        this.installErrorMonitor((type, data) => this.track(type, data), errorMonitor ?? true);
+    }
+    startPerformanceMonitor(performanceMonitor) {
+        if (this.performanceMonitorStarted)
+            return;
+        const enabled = performanceMonitor === undefined ? true : !!performanceMonitor;
+        if (!enabled)
+            return;
+        this.performanceMonitorStarted = true;
+        this.installPerformanceMonitor((type, data) => this.track(type, data), performanceMonitor ?? true);
+    }
+    startBehaviorMonitor(behaviorMonitor) {
+        if (this.behaviorMonitorStarted)
+            return;
+        const enabled = behaviorMonitor === undefined ? true : !!behaviorMonitor;
+        if (!enabled)
+            return;
+        this.behaviorMonitorStarted = true;
+        this.behaviorMonitorCleanup = this.installBehaviorMonitor((type, data) => {
+            this.track(type, data);
+        }, behaviorMonitor ?? true);
+    }
+    /**
+     * 停止行为埋点监听（PV/UV/点击）
+     * - 如需重启：可再次调用 init（或自行调用 init 后的默认启动逻辑）
+     */
+    stopBehaviorMonitor() {
+        try {
+            this.behaviorMonitorCleanup?.();
+        }
+        catch {
+            // ignore
+        }
+        this.behaviorMonitorCleanup = null;
+        this.behaviorMonitorStarted = false;
+    }
+    /**
+     * 获取 CLS client（按环境懒加载 SDK）
+     */
+    async getInstance() {
+        if (this.client)
+            return this.client;
+        if (this.clientPromise)
+            return this.clientPromise;
+        this.clientPromise = this.loadSdk()
+            .then(({ AsyncClient }) => {
+            const client = new AsyncClient({
+                endpoint: this.endpoint,
+                retry_times: this.retryTimes,
+            });
+            this.client = client;
+            return client;
+        })
+            .catch((err) => {
+            // 失败后允许下次重试
+            this.clientPromise = null;
+            throw err;
+        });
+        return this.clientPromise;
+    }
+    /**
+     * 直接上报：埋点入参必须是一维（扁平）Object
+     * - 非原始值（对象/数组等）会被自动 stringify 成 string
+     * - 最终会把 fields 展开成 CLS 的 content（key/value 都会转成 string）
+     */
+    put(fields, options = {}) {
+        if (!this.enabled)
+            return;
+        if (!fields)
+            return;
+        if (!this.topicId) {
+            // eslint-disable-next-line no-console
+            console.warn('ClsLogger.put：未初始化 topic_id');
+            return;
+        }
+        const mergeBaseFields = options.mergeBaseFields ?? true;
+        const base = mergeBaseFields ? this.getBaseFields() : undefined;
+        const normalizedFields = normalizeFlatFields(fields, 'put');
+        const finalFields = mergeFields(base, {
+            projectId: this.projectId || undefined,
+            projectName: this.projectName || undefined,
+            envType: this.envType,
+            appId: this.appId || undefined,
+            appVersion: this.appVersion || undefined,
+            ...normalizedFields,
+        });
+        // 同步 API：内部异步发送，避免把网络异常冒泡到业务（尤其小程序）
+        void this.putAsync(finalFields).catch(() => {
+            // ignore
+        });
+    }
+    async putAsync(finalFields) {
+        if (!this.topicId)
+            return;
+        const sdk = await this.loadSdk();
+        const client = await this.getInstance();
+        const logGroup = new sdk.LogGroup('127.0.0.1');
+        logGroup.setSource(this.source);
+        const log = new sdk.Log(Date.now());
+        for (const key of Object.keys(finalFields)) {
+            log.addContent(key, stringifyLogValue(finalFields[key]));
+        }
+        logGroup.addLog(log);
+        const request = new sdk.PutLogsRequest(this.topicId, logGroup);
+        const exit = enterClsSendingGuard();
+        let p;
+        try {
+            p = client.PutLogs(request);
+        }
+        finally {
+            exit();
+        }
+        await p;
+    }
+    /**
+     * 直接上报：把 data 序列化后放入指定 key（默认 “日志内容”）
+     */
+    putJson(data, clsLoggerKey = '日志内容', options = {}) {
+        // put 的入参要求扁平；这里直接把数据序列化为 string
+        this.put({ [clsLoggerKey]: stringifyLogValue(data) }, options);
+    }
+    /**
+     * 入队：写入 localStorage 队列；达到 batchSize 自动 flush
+     * - 埋点入参必须是一维（扁平）Object，非原始值会被 stringify
+     */
+    enqueue(fields, options = {}) {
+        if (!this.enabled)
+            return;
+        if (!fields)
+            return;
+        const time = Date.now();
+        const mergeBaseFields = options.mergeBaseFields ?? true;
+        const base = mergeBaseFields ? this.getBaseFields() : undefined;
+        const normalizedFields = normalizeFlatFields(fields, 'enqueue');
+        const finalFields = mergeFields(base, {
+            projectId: this.projectId || undefined,
+            projectName: this.projectName || undefined,
+            envType: this.envType,
+            appId: this.appId || undefined,
+            appVersion: this.appVersion || undefined,
+            ...normalizedFields,
+        });
+        const queue = readQueue(this.storageKey);
+        const next = [...queue, { time, data: finalFields }];
+        if (next.length < this.batchSize) {
+            writeQueue(this.storageKey, next);
+            return;
+        }
+        // 达到阈值：flush + 写入新的队列（避免并发下丢失，按“先 flush 旧的”策略）
+        this.putBatch(queue);
+        writeQueue(this.storageKey, [{ time, data: finalFields }]);
+    }
+    /**
+     * 从 localStorage 读取队列并批量上报
+     */
+    flush() {
+        const queue = readQueue(this.storageKey);
+        if (queue.length === 0)
+            return;
+        this.putBatch(queue);
+        writeQueue(this.storageKey, []);
+    }
+    /**
+     * 批量上报（每条 item.data 展开为 log content）
+     */
+    putBatch(queue) {
+        if (!this.enabled)
+            return;
+        if (!queue || queue.length === 0)
+            return;
+        if (!this.topicId) {
+            // eslint-disable-next-line no-console
+            console.warn('ClsLogger.putBatch：未初始化 topic_id');
+            return;
+        }
+        void this.putBatchAsync(queue).catch(() => {
+            // ignore
+        });
+    }
+    async putBatchAsync(queue) {
+        if (!this.topicId)
+            return;
+        const sdk = await this.loadSdk();
+        const client = await this.getInstance();
+        const logGroup = new sdk.LogGroup('127.0.0.1');
+        logGroup.setSource(this.source);
+        for (const item of queue) {
+            const log = new sdk.Log(item.time);
+            const data = item.data ?? {};
+            for (const key of Object.keys(data)) {
+                log.addContent(key, stringifyLogValue(data[key]));
+            }
+            logGroup.addLog(log);
+        }
+        if (logGroup.getLogs().length === 0)
+            return;
+        const request = new sdk.PutLogsRequest(this.topicId, logGroup);
+        const exit = enterClsSendingGuard();
+        let p;
+        try {
+            p = client.PutLogs(request);
+        }
+        finally {
+            exit();
+        }
+        await p;
+    }
+    /**
+     * 参考《一、概述》：统一上报入口（内存队列 + 批量发送）
+     */
+    report(log) {
+        if (!this.enabled)
+            return;
+        if (!log?.type)
+            return;
+        if (!this.topicId) {
+            // eslint-disable-next-line no-console
+            console.warn('ClsLogger.report：未初始化 topicID/topic_id');
+            return;
+        }
+        this.memoryQueue.push(log);
+        if (this.memoryQueue.length >= this.batchMaxSize) {
+            void this.flushBatch();
+            return;
+        }
+        const now = Date.now();
+        const desiredDueAt = this.getDesiredBatchFlushDueAt(now);
+        const desiredDelay = Math.max(0, desiredDueAt - now);
+        if (!this.batchTimer) {
+            this.batchTimerDueAt = desiredDueAt;
+            this.scheduleFlush(desiredDelay);
+            return;
+        }
+        // 启动合并窗口内：如果当前 timer 会"更早"触发，则延后到窗口结束，尽量减少多次发送
+        if (this.batchTimerDueAt !== null && this.batchTimerDueAt < desiredDueAt) {
+            this.cancelScheduledFlush();
+            this.batchTimerDueAt = desiredDueAt;
+            this.scheduleFlush(desiredDelay);
+        }
+    }
+    /**
+     * 调度批量发送
+     * - 支持 requestIdleCallback（浏览器空闲时执行）
+     * - 降级为 setTimeout
+     */
+    scheduleFlush(desiredDelay) {
+        if (this.useIdleCallback && typeof requestIdleCallback !== 'undefined') {
+            // 使用 requestIdleCallback，设置 timeout 保证最终执行
+            const idleId = requestIdleCallback(() => {
+                void this.flushBatch();
+            }, { timeout: Math.max(desiredDelay, this.idleTimeout) });
+            // 存储 idleId 以便清理（类型兼容处理）
+            this.batchTimer = idleId;
+        }
+        else {
+            this.batchTimer = setTimeout(() => {
+                void this.flushBatch();
+            }, desiredDelay);
+        }
+    }
+    /**
+     * 取消已调度的批量发送
+     */
+    cancelScheduledFlush() {
+        if (!this.batchTimer)
+            return;
+        try {
+            if (this.useIdleCallback && typeof cancelIdleCallback !== 'undefined') {
+                cancelIdleCallback(this.batchTimer);
+            }
+            else {
+                clearTimeout(this.batchTimer);
+            }
+        }
+        catch {
+            // ignore
+        }
+        this.batchTimer = null;
+    }
+    getDesiredBatchFlushDueAt(nowTs) {
+        const start = this.initTs || nowTs;
+        const startupDelay = Number.isFinite(this.startupDelayMs) ? Math.max(0, this.startupDelayMs) : 0;
+        if (startupDelay > 0) {
+            const end = start + startupDelay;
+            if (nowTs < end)
+                return end;
+        }
+        return nowTs + this.batchIntervalMs;
+    }
+    info(message, data = {}, options) {
+        let msg = '';
+        let extra = {};
+        if (message instanceof Error) {
+            msg = message.message;
+            extra = {
+                stack: message.stack,
+                name: message.name,
+                ...data,
+            };
+        }
+        else {
+            msg = String(message);
+            extra = data;
+        }
+        const payload = normalizeFlatFields({ message: msg, ...extra }, 'info');
+        const log = { type: 'info', data: payload, timestamp: Date.now() };
+        // info 默认走批量队列，支持 immediate 选项立即发送
+        if (options?.immediate) {
+            void this.sendReportLogs([log]).catch(() => {
+                this.cacheFailedReportLogs([log]);
+            });
+        }
+        else {
+            this.report(log);
+        }
+    }
+    warn(message, data = {}, options) {
+        let msg = '';
+        let extra = {};
+        if (message instanceof Error) {
+            msg = message.message;
+            extra = {
+                stack: message.stack,
+                name: message.name,
+                ...data,
+            };
+        }
+        else {
+            msg = String(message);
+            extra = data;
+        }
+        const payload = normalizeFlatFields({ message: msg, ...extra }, 'warn');
+        const log = { type: 'warn', data: payload, timestamp: Date.now() };
+        // warn 默认走批量队列，支持 immediate 选项立即发送
+        if (options?.immediate) {
+            void this.sendReportLogs([log]).catch(() => {
+                this.cacheFailedReportLogs([log]);
+            });
+        }
+        else {
+            this.report(log);
+        }
+    }
+    error(message, data = {}, options) {
+        let msg = '';
+        let extra = {};
+        if (message instanceof Error) {
+            msg = message.message;
+            extra = {
+                stack: message.stack,
+                name: message.name,
+                ...data,
+            };
+        }
+        else {
+            msg = String(message);
+            extra = data;
+        }
+        const payload = normalizeFlatFields({ message: msg, ...extra }, 'error');
+        const log = { type: 'error', data: payload, timestamp: Date.now() };
+        // error 默认即时上报，除非显式指定 immediate: false
+        const immediate = options?.immediate ?? true;
+        if (immediate) {
+            void this.sendReportLogs([log]).catch(() => {
+                this.cacheFailedReportLogs([log]);
+            });
+        }
+        else {
+            this.report(log);
+        }
+    }
+    track(trackType, data = {}) {
+        if (!trackType)
+            return;
+        this.report({
+            type: trackType,
+            data: normalizeFlatFields(data, `track:${trackType}`),
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * 立即发送内存队列
+     */
+    async flushBatch() {
+        this.cancelScheduledFlush();
+        this.batchTimerDueAt = null;
+        if (this.memoryQueue.length === 0)
+            return;
+        const logs = [...this.memoryQueue];
+        this.memoryQueue = [];
+        try {
+            await this.sendReportLogs(logs);
+        }
+        catch {
+            this.retrySendReportLogs(logs, 1);
+        }
+    }
+    buildReportFields(log) {
+        const ts = log.timestamp ?? Date.now();
+        const base = this.getBaseFields();
+        const data = normalizeFlatFields(log.data ?? {}, 'report:data');
+        const mergedData = mergeFields(base, data);
+        return {
+            timestamp: ts,
+            type: log.type,
+            envType: this.envType,
+            projectId: this.projectId || undefined,
+            projectName: this.projectName || undefined,
+            appId: this.appId || undefined,
+            appVersion: this.appVersion || undefined,
+            // 保证“一维字段”：业务数据以 JSON 字符串形式落到 CLS
+            ...mergedData,
+        };
+    }
+    async sendReportLogs(logs) {
+        if (!this.topicId)
+            return;
+        const sdk = await this.loadSdk();
+        const client = await this.getInstance();
+        const logGroup = new sdk.LogGroup('127.0.0.1');
+        logGroup.setSource(this.source);
+        for (const item of logs) {
+            const fields = this.buildReportFields(item);
+            const log = new sdk.Log(fields.timestamp);
+            for (const key of Object.keys(fields)) {
+                if (key === 'timestamp')
+                    continue;
+                log.addContent(key, stringifyLogValue(fields[key]));
+            }
+            logGroup.addLog(log);
+        }
+        const request = new sdk.PutLogsRequest(this.topicId, logGroup);
+        // 只在“发起网络请求”的同步阶段打标记，避免 requestMonitor 监控 CLS 上报请求导致递归
+        const exit = enterClsSendingGuard();
+        let p;
+        try {
+            p = client.PutLogs(request);
+        }
+        finally {
+            exit();
+        }
+        await p;
+    }
+    retrySendReportLogs(logs, retryCount) {
+        if (retryCount > this.retryTimes) {
+            this.cacheFailedReportLogs(logs);
+            return;
+        }
+        const delayMs = Math.pow(2, retryCount) * 1000;
+        setTimeout(async () => {
+            try {
+                await this.sendReportLogs(logs);
+            }
+            catch {
+                this.retrySendReportLogs(logs, retryCount + 1);
+            }
+        }, delayMs);
+    }
+    cacheFailedReportLogs(logs) {
+        const raw = readStringStorage(this.failedCacheKey);
+        let current = [];
+        try {
+            const parsed = raw ? JSON.parse(raw) : [];
+            current = Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            current = [];
+        }
+        const next = [...current, ...logs].slice(-this.failedCacheMax);
+        writeStringStorage(this.failedCacheKey, JSON.stringify(next));
+    }
+    flushFailed() {
+        if (!this.enabled)
+            return;
+        const raw = readStringStorage(this.failedCacheKey);
+        if (!raw)
+            return;
+        let logs = [];
+        try {
+            const parsed = JSON.parse(raw);
+            logs = Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            logs = [];
+        }
+        if (logs.length === 0)
+            return;
+        // 先清空，再尝试发送
+        writeStringStorage(this.failedCacheKey, JSON.stringify([]));
+        this.memoryQueue.unshift(...logs);
+        void this.flushBatch();
+    }
+    /**
+     * 统计/计数类日志：按字段展开上报（若 data 为空默认 1）
+     */
+    stat(param) {
+        if (!param)
+            return;
+        const payload = normalizeFlatFields({
+            pagePath: typeof window !== 'undefined' ? window.location?.pathname : '',
+            projectId: this.projectId,
+            projectName: this.projectName,
+            ...param,
+            data: param.data ?? 1,
+        }, 'stat');
+        this.report({ type: 'stat', data: payload, timestamp: Date.now() });
+    }
+}
+
+function readGlobal(key) {
+    try {
+        const g = globalThis;
+        return g[key] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function tryRequire(moduleName) {
+    try {
+        // 说明：
+        // - ESM 构建（exports.import/module）里通常不存在模块作用域的 require
+        // - 一些小程序运行时/构建链路会把 require 挂到 globalThis 上
+        // 因此这里同时探测“模块作用域 require”与 “globalThis.require”
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval
+        const localReq = (typeof require === 'function' ? require : null);
+        const globalReq = readGlobal('require');
+        const candidates = [localReq, globalReq].filter((fn) => typeof fn === 'function');
+        for (const fn of candidates) {
+            try {
+                return fn(moduleName);
+            }
+            catch {
+                // continue
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+
+const DEFAULT_IGNORE$2 = ['cls.tencentcs.com', /\/cls\//i];
+function isClsSendingNow() {
+    const g = globalThis;
+    return (g.__beLinkClsLoggerSendingCount__ ?? 0) > 0;
+}
+function shouldIgnoreUrl$2(url, ignoreUrls) {
+    for (const rule of ignoreUrls) {
+        if (typeof rule === 'string') {
+            if (url.includes(rule))
+                return true;
+            continue;
+        }
+        try {
+            if (rule.test(url))
+                return true;
+        }
+        catch {
+            // ignore invalid regex
+        }
+    }
+    return false;
+}
+function sampleHit$5(sampleRate) {
+    if (sampleRate >= 1)
+        return true;
+    if (sampleRate <= 0)
+        return false;
+    return Math.random() < sampleRate;
+}
+function truncate$5(s, maxLen) {
+    if (!s)
+        return s;
+    return s.length > maxLen ? `${s.slice(0, maxLen)}...` : s;
+}
+function buildPayload$1(params) {
+    const { url, method, query, body, duration, startTime, status, success, error, options } = params;
+    if (!url)
+        return null;
+    if (shouldIgnoreUrl$2(url, options.ignoreUrls))
+        return null;
+    if (!sampleHit$5(options.sampleRate))
+        return null;
+    const payload = { url };
+    if (options.includeMethod && method)
+        payload.method = method;
+    if (options.includeQuery && query !== undefined)
+        payload.query = truncate$5(String(query), options.maxParamLength);
+    if (options.includeBody && body !== undefined)
+        payload.params = truncate$5(stringifyLogValue(body), options.maxParamLength);
+    if (typeof startTime === 'number')
+        payload.startTime = startTime;
+    if (typeof duration === 'number')
+        payload.duration = duration;
+    if (typeof status === 'number')
+        payload.status = status;
+    if (typeof success === 'boolean')
+        payload.success = success ? 1 : 0;
+    if (error !== undefined)
+        payload.error = truncate$5(stringifyLogValue(error), options.maxParamLength);
+    return payload;
+}
+function getAbsoluteUrlMaybe(url) {
+    try {
+        if (typeof window === 'undefined')
+            return url;
+        return new URL(url, window.location?.href).toString();
+    }
+    catch {
+        return url;
+    }
+}
+function installBrowserFetch(report, options) {
+    if (typeof window === 'undefined')
+        return;
+    const w = window;
+    if (w.__beLinkClsLoggerFetchInstalled__)
+        return;
+    if (typeof w.fetch !== 'function')
+        return;
+    w.__beLinkClsLoggerFetchInstalled__ = true;
+    w.__beLinkClsLoggerRawFetch__ = w.fetch;
+    w.fetch = async (input, init) => {
+        // 避免 CLS SDK 上报请求被 requestMonitor 捕获后递归上报（尤其在跨域失败时会“上报失败→再上报”）
+        if (isClsSendingNow())
+            return w.__beLinkClsLoggerRawFetch__(input, init);
+        let url = '';
+        let method = '';
+        let body = undefined;
+        const startTs = Date.now();
+        try {
+            if (typeof input === 'string')
+                url = input;
+            else if (input instanceof URL)
+                url = input.toString();
+            else
+                url = input.url ?? '';
+            method = (init?.method ?? input?.method ?? 'GET');
+            body = init?.body;
+        }
+        catch {
+            // ignore
+        }
+        const absUrl = getAbsoluteUrlMaybe(url);
+        const query = (() => {
+            try {
+                const u = new URL(absUrl);
+                return u.search ? u.search.slice(1) : '';
+            }
+            catch {
+                return '';
+            }
+        })();
+        try {
+            const res = await w.__beLinkClsLoggerRawFetch__(input, init);
+            const duration = Date.now() - startTs;
+            const status = typeof res?.status === 'number' ? res.status : undefined;
+            const ok = typeof res?.ok === 'boolean' ? res.ok : status !== undefined ? status >= 200 && status < 400 : true;
+            const payload = buildPayload$1({
+                url: absUrl,
+                method,
+                query,
+                body,
+                startTime: startTs,
+                duration,
+                status,
+                success: ok,
+                options,
+            });
+            if (payload)
+                report(options.reportType, payload);
+            return res;
+        }
+        catch (err) {
+            const duration = Date.now() - startTs;
+            const payload = buildPayload$1({
+                url: absUrl,
+                method,
+                query,
+                body,
+                startTime: startTs,
+                duration,
+                success: false,
+                error: err,
+                options,
+            });
+            if (payload)
+                report(options.reportType, payload);
+            throw err;
+        }
+    };
+}
+function installBrowserXhr(report, options) {
+    if (typeof window === 'undefined')
+        return;
+    const w = window;
+    if (w.__beLinkClsLoggerXhrInstalled__)
+        return;
     if (!w.XMLHttpRequest || !w.XMLHttpRequest.prototype)
         return;
     w.__beLinkClsLoggerXhrInstalled__ = true;
@@ -331,7 +1147,7 @@ function installBrowserXhr(report, options) {
                     const st = this.__beLinkClsLoggerStartTs__ ?? startTs;
                     const duration = Date.now() - st;
                     const status = typeof this.status === 'number' ? this.status : undefined;
-                    const payload = buildPayload({
+                    const payload = buildPayload$1({
                         url,
                         method,
                         query,
@@ -373,6 +1189,85 @@ function installBrowserXhr(report, options) {
         return rawSend.apply(this, args);
     };
 }
+function installWebRequestMonitor(report, opts = {}) {
+    const enabled = opts.enabled ?? true;
+    if (!enabled)
+        return;
+    const ignoreUrls = [...DEFAULT_IGNORE$2, ...(opts.ignoreUrls ?? [])];
+    if (opts.clsEndpoint)
+        ignoreUrls.push(opts.clsEndpoint);
+    const options = {
+        enabled: true,
+        reportType: opts.reportType ?? 'http',
+        sampleRate: opts.sampleRate ?? 1,
+        ignoreUrls,
+        includeMethod: opts.includeMethod ?? true,
+        includeQuery: opts.includeQuery ?? true,
+        includeBody: opts.includeBody ?? true,
+        maxParamLength: opts.maxParamLength ?? 2000,
+        clsEndpoint: opts.clsEndpoint ?? '',
+    };
+    installBrowserFetch(report, options);
+    installBrowserXhr(report, options);
+}
+
+const DEFAULT_IGNORE$1 = ['cls.tencentcs.com', /\/cls\//i];
+function shouldIgnoreUrl$1(url, ignoreUrls) {
+    for (const rule of ignoreUrls) {
+        if (typeof rule === 'string') {
+            if (url.includes(rule))
+                return true;
+            continue;
+        }
+        try {
+            if (rule.test(url))
+                return true;
+        }
+        catch {
+            // ignore invalid regex
+        }
+    }
+    return false;
+}
+function sampleHit$4(sampleRate) {
+    if (sampleRate >= 1)
+        return true;
+    if (sampleRate <= 0)
+        return false;
+    return Math.random() < sampleRate;
+}
+function truncate$4(s, maxLen) {
+    if (!s)
+        return s;
+    return s.length > maxLen ? `${s.slice(0, maxLen)}...` : s;
+}
+function buildPayload(params) {
+    const { url, method, query, body, duration, startTime, status, success, error, options } = params;
+    if (!url)
+        return null;
+    if (shouldIgnoreUrl$1(url, options.ignoreUrls))
+        return null;
+    if (!sampleHit$4(options.sampleRate))
+        return null;
+    const payload = { url };
+    if (options.includeMethod && method)
+        payload.method = method;
+    if (options.includeQuery && query !== undefined)
+        payload.query = truncate$4(String(query), options.maxParamLength);
+    if (options.includeBody && body !== undefined)
+        payload.params = truncate$4(stringifyLogValue(body), options.maxParamLength);
+    if (typeof startTime === 'number')
+        payload.startTime = startTime;
+    if (typeof duration === 'number')
+        payload.duration = duration;
+    if (typeof status === 'number')
+        payload.status = status;
+    if (typeof success === 'boolean')
+        payload.success = success ? 1 : 0;
+    if (error !== undefined)
+        payload.error = truncate$4(stringifyLogValue(error), options.maxParamLength);
+    return payload;
+}
 function installMiniProgramWxRequest(report, options) {
     const wxAny = globalThis.wx;
     if (!wxAny || typeof wxAny.request !== 'function')
@@ -508,7 +1403,7 @@ function installMiniProgramWxCloudCallFunction(report, options) {
         }
     };
 }
-function installRequestMonitor(report, opts = {}) {
+function installMiniRequestMonitor(report, opts = {}) {
     const enabled = opts.enabled ?? true;
     if (!enabled)
         return;
@@ -526,49 +1421,127 @@ function installRequestMonitor(report, opts = {}) {
         maxParamLength: opts.maxParamLength ?? 2000,
         clsEndpoint: opts.clsEndpoint ?? '',
     };
+    installMiniProgramWxRequest(report, options);
+    installMiniProgramWxCloudCallFunction(report, options);
+}
+
+function installRequestMonitor(report, opts = {}) {
     if (isMiniProgramEnv()) {
-        installMiniProgramWxRequest(report, options);
-        installMiniProgramWxCloudCallFunction(report, options);
-        return;
+        return installMiniRequestMonitor(report, opts);
     }
-    installBrowserFetch(report, options);
-    installBrowserXhr(report, options);
+    return installWebRequestMonitor(report, opts);
 }
 
-const DEFAULT_MAX_TEXT = 4000;
-function truncate$2(s, maxLen) {
+const DEFAULT_MAX_TEXT$1 = 4000;
+const DEFAULT_DEDUPE_WINDOW_MS$1 = 3000;
+const DEFAULT_DEDUPE_MAX_KEYS$1 = 200;
+/** 默认忽略的无意义错误信息 */
+const DEFAULT_IGNORE_MESSAGES$1 = [
+    'Script error.',
+    'Script error',
+    /^ResizeObserver loop/,
+    'Permission was denied',
+];
+function truncate$3(s, maxLen) {
     if (!s)
         return s;
     return s.length > maxLen ? `${s.slice(0, maxLen)}...` : s;
 }
-function sampleHit$1(sampleRate) {
+function sampleHit$3(sampleRate) {
     if (sampleRate >= 1)
         return true;
     if (sampleRate <= 0)
         return false;
     return Math.random() < sampleRate;
 }
+/** 检查消息是否应该被忽略 */
+function shouldIgnoreMessage$1(message, ignorePatterns) {
+    if (!message || ignorePatterns.length === 0)
+        return false;
+    return ignorePatterns.some((pattern) => {
+        if (typeof pattern === 'string') {
+            return message === pattern || message.includes(pattern);
+        }
+        return pattern.test(message);
+    });
+}
 function getPagePath$1() {
     try {
         if (typeof window === 'undefined')
             return '';
-        return window.location?.pathname ?? '';
+        return window.location?.href ?? '';
     }
     catch {
         return '';
     }
 }
-function normalizeErrorLike(err, maxTextLength) {
+function normalizeErrorLike$1(err, maxTextLength) {
     if (err && typeof err === 'object') {
         const anyErr = err;
-        const message = truncate$2(String(anyErr.message ?? anyErr.toString?.() ?? ''), maxTextLength);
-        const name = truncate$2(String(anyErr.name ?? ''), 200);
-        const stack = truncate$2(String(anyErr.stack ?? ''), maxTextLength);
+        let rawMsg = anyErr.message;
+        if (!rawMsg) {
+            const str = anyErr.toString?.();
+            if (!str || str === '[object Object]') {
+                rawMsg = stringifyLogValue(anyErr);
+            }
+            else {
+                rawMsg = str;
+            }
+        }
+        const message = truncate$3(String(rawMsg ?? ''), maxTextLength);
+        const name = truncate$3(String(anyErr.name ?? ''), 200);
+        const stack = truncate$3(String(anyErr.stack ?? ''), maxTextLength);
         return { message, name, stack };
     }
-    const message = truncate$2(stringifyLogValue(err), maxTextLength);
+    const message = truncate$3(stringifyLogValue(err), maxTextLength);
     return { message, name: '', stack: '' };
 }
+function createDedupeGuard$1(options) {
+    const cache = new Map(); // key -> lastReportAt
+    const maxKeys = Math.max(0, options.dedupeMaxKeys);
+    const windowMs = Math.max(0, options.dedupeWindowMs);
+    function touch(key, now) {
+        if (cache.has(key))
+            cache.delete(key);
+        cache.set(key, now);
+        if (maxKeys > 0) {
+            while (cache.size > maxKeys) {
+                const first = cache.keys().next().value;
+                if (!first)
+                    break;
+                cache.delete(first);
+            }
+        }
+    }
+    return (key) => {
+        if (!key)
+            return true;
+        if (windowMs <= 0 || maxKeys === 0)
+            return true;
+        const now = Date.now();
+        const last = cache.get(key);
+        if (typeof last === 'number' && now - last < windowMs)
+            return false;
+        touch(key, now);
+        return true;
+    };
+}
+function buildErrorKey$1(type, payload) {
+    const parts = [
+        type,
+        String(payload.source ?? ''),
+        String(payload.pagePath ?? ''),
+        String(payload.message ?? ''),
+        String(payload.errorName ?? ''),
+        String(payload.stack ?? ''),
+        String(payload.filename ?? ''),
+        String(payload.lineno ?? ''),
+        String(payload.colno ?? ''),
+        String(payload.tagName ?? ''),
+        String(payload.resourceUrl ?? ''),
+    ];
+    return parts.join('|');
+}
 function installBrowserErrorMonitor(report, options) {
     if (typeof window === 'undefined')
         return;
@@ -576,39 +1549,45 @@ function installBrowserErrorMonitor(report, options) {
     if (w.__beLinkClsLoggerErrorInstalled__)
         return;
     w.__beLinkClsLoggerErrorInstalled__ = true;
+    const shouldReport = createDedupeGuard$1(options);
     window.addEventListener('error', (event) => {
         try {
-            if (!sampleHit$1(options.sampleRate))
+            if (!sampleHit$3(options.sampleRate))
                 return;
             const payload = {
                 pagePath: getPagePath$1(),
                 source: 'window.error',
             };
-            // JS runtime error
             if (event && typeof event === 'object' && 'message' in event) {
-                payload.message = truncate$2(String(event.message ?? ''), options.maxTextLength);
-                payload.filename = truncate$2(String(event.filename ?? ''), 500);
+                payload.message = truncate$3(String(event.message ?? ''), options.maxTextLength);
+                // 检查是否应该忽略此错误
+                if (shouldIgnoreMessage$1(String(event.message ?? ''), options.ignoreMessages))
+                    return;
+                payload.filename = truncate$3(String(event.filename ?? ''), 500);
                 payload.lineno = typeof event.lineno === 'number' ? event.lineno : undefined;
                 payload.colno = typeof event.colno === 'number' ? event.colno : undefined;
                 const err = event.error;
                 if (err) {
-                    const e = normalizeErrorLike(err, options.maxTextLength);
+                    const e = normalizeErrorLike$1(err, options.maxTextLength);
                     if (e.name)
                         payload.errorName = e.name;
                     if (e.stack)
                         payload.stack = e.stack;
                 }
+                if (!shouldReport(buildErrorKey$1(options.reportType, payload)))
+                    return;
                 report(options.reportType, payload);
                 return;
             }
-            // Resource error (img/script/link)
             if (options.captureResourceError) {
                 const target = event?.target || event?.srcElement;
                 const tagName = target?.tagName ? String(target.tagName) : '';
                 const url = String(target?.src || target?.href || '');
                 payload.source = 'resource.error';
                 payload.tagName = tagName;
-                payload.resourceUrl = truncate$2(url, 2000);
+                payload.resourceUrl = truncate$3(url, 2000);
+                if (!shouldReport(buildErrorKey$1(options.reportType, payload)))
+                    return;
                 report(options.reportType, payload);
             }
         }
@@ -618,10 +1597,13 @@ function installBrowserErrorMonitor(report, options) {
     }, true);
     window.addEventListener('unhandledrejection', (event) => {
         try {
-            if (!sampleHit$1(options.sampleRate))
+            if (!sampleHit$3(options.sampleRate))
                 return;
             const reason = event?.reason;
-            const e = normalizeErrorLike(reason, options.maxTextLength);
+            const e = normalizeErrorLike$1(reason, options.maxTextLength);
+            // 检查是否应该忽略此错误
+            if (shouldIgnoreMessage$1(e.message, options.ignoreMessages))
+                return;
             const payload = {
                 pagePath: getPagePath$1(),
                 source: 'unhandledrejection',
@@ -629,6 +1611,8 @@ function installBrowserErrorMonitor(report, options) {
                 errorName: e.name,
                 stack: e.stack,
             };
+            if (!shouldReport(buildErrorKey$1(options.reportType, payload)))
+                return;
             report(options.reportType, payload);
         }
         catch {
@@ -636,23 +1620,174 @@ function installBrowserErrorMonitor(report, options) {
         }
     });
 }
+function installWebErrorMonitor(report, opts = {}) {
+    const enabled = opts === undefined ? true : !!opts;
+    if (!enabled)
+        return;
+    const raw = typeof opts === 'object' && opts ? opts : {};
+    const options = {
+        enabled: true,
+        reportType: raw.reportType ?? 'error',
+        sampleRate: raw.sampleRate ?? 1,
+        captureResourceError: raw.captureResourceError ?? true,
+        maxTextLength: raw.maxTextLength ?? DEFAULT_MAX_TEXT$1,
+        dedupeWindowMs: raw.dedupeWindowMs ?? DEFAULT_DEDUPE_WINDOW_MS$1,
+        dedupeMaxKeys: raw.dedupeMaxKeys ?? DEFAULT_DEDUPE_MAX_KEYS$1,
+        ignoreMessages: raw.ignoreMessages ?? DEFAULT_IGNORE_MESSAGES$1,
+    };
+    installBrowserErrorMonitor(report, options);
+}
+
+const DEFAULT_MAX_TEXT = 4000;
+const DEFAULT_DEDUPE_WINDOW_MS = 3000;
+const DEFAULT_DEDUPE_MAX_KEYS = 200;
+/** 默认忽略的无意义错误信息 */
+const DEFAULT_IGNORE_MESSAGES = [
+    'Script error.',
+    'Script error',
+    /^ResizeObserver loop/,
+    'Permission was denied',
+];
+function truncate$2(s, maxLen) {
+    if (!s)
+        return s;
+    return s.length > maxLen ? `${s.slice(0, maxLen)}...` : s;
+}
+function sampleHit$2(sampleRate) {
+    if (sampleRate >= 1)
+        return true;
+    if (sampleRate <= 0)
+        return false;
+    return Math.random() < sampleRate;
+}
+/** 检查消息是否应该被忽略 */
+function shouldIgnoreMessage(message, ignorePatterns) {
+    if (!message || ignorePatterns.length === 0)
+        return false;
+    return ignorePatterns.some((pattern) => {
+        if (typeof pattern === 'string') {
+            return message === pattern || message.includes(pattern);
+        }
+        return pattern.test(message);
+    });
+}
+function getMpPagePath() {
+    try {
+        const pages = globalThis.getCurrentPages?.();
+        if (Array.isArray(pages) && pages.length > 0) {
+            const page = pages[pages.length - 1];
+            const route = page.route || page.__route__;
+            if (typeof route === 'string') {
+                let path = route.startsWith('/') ? route : `/${route}`;
+                const options = page.options || {};
+                const keys = Object.keys(options);
+                if (keys.length > 0) {
+                    const qs = keys.map((k) => `${k}=${options[k]}`).join('&');
+                    path = `${path}?${qs}`;
+                }
+                return path;
+            }
+        }
+        return '';
+    }
+    catch {
+        return '';
+    }
+}
+function normalizeErrorLike(err, maxTextLength) {
+    if (err && typeof err === 'object') {
+        const anyErr = err;
+        let rawMsg = anyErr.message;
+        if (!rawMsg) {
+            const str = anyErr.toString?.();
+            if (!str || str === '[object Object]') {
+                rawMsg = stringifyLogValue(anyErr);
+            }
+            else {
+                rawMsg = str;
+            }
+        }
+        const message = truncate$2(String(rawMsg ?? ''), maxTextLength);
+        const name = truncate$2(String(anyErr.name ?? ''), 200);
+        const stack = truncate$2(String(anyErr.stack ?? ''), maxTextLength);
+        return { message, name, stack };
+    }
+    const message = truncate$2(stringifyLogValue(err), maxTextLength);
+    return { message, name: '', stack: '' };
+}
+function createDedupeGuard(options) {
+    const cache = new Map(); // key -> lastReportAt
+    const maxKeys = Math.max(0, options.dedupeMaxKeys);
+    const windowMs = Math.max(0, options.dedupeWindowMs);
+    function touch(key, now) {
+        if (cache.has(key))
+            cache.delete(key);
+        cache.set(key, now);
+        if (maxKeys > 0) {
+            while (cache.size > maxKeys) {
+                const first = cache.keys().next().value;
+                if (!first)
+                    break;
+                cache.delete(first);
+            }
+        }
+    }
+    return (key) => {
+        if (!key)
+            return true;
+        if (windowMs <= 0 || maxKeys === 0)
+            return true;
+        const now = Date.now();
+        const last = cache.get(key);
+        if (typeof last === 'number' && now - last < windowMs)
+            return false;
+        touch(key, now);
+        return true;
+    };
+}
+function buildErrorKey(type, payload) {
+    const parts = [
+        type,
+        String(payload.source ?? ''),
+        String(payload.pagePath ?? ''),
+        String(payload.message ?? ''),
+        String(payload.errorName ?? ''),
+        String(payload.stack ?? ''),
+        String(payload.filename ?? ''),
+        String(payload.lineno ?? ''),
+        String(payload.colno ?? ''),
+        String(payload.tagName ?? ''),
+        String(payload.resourceUrl ?? ''),
+    ];
+    return parts.join('|');
+}
 function installMiniProgramErrorMonitor(report, options) {
     const g = globalThis;
     if (g.__beLinkClsLoggerMpErrorInstalled__)
         return;
     g.__beLinkClsLoggerMpErrorInstalled__ = true;
+    const shouldReport = createDedupeGuard(options);
     const wxAny = globalThis.wx;
-    // wx.* 事件（兼容在 App 已经创建后的场景）
     try {
         if (wxAny && typeof wxAny.onError === 'function') {
             wxAny.onError((msg) => {
                 try {
-                    if (!sampleHit$1(options.sampleRate))
+                    if (!sampleHit$2(options.sampleRate))
                         return;
-                    report(options.reportType, {
+                    const e = normalizeErrorLike(msg, options.maxTextLength);
+                    // 检查是否应该忽略此错误
+                    if (shouldIgnoreMessage(e.message, options.ignoreMessages))
+                        return;
+                    const payload = {
+                        pagePath: getMpPagePath(),
                         source: 'wx.onError',
-                        message: truncate$2(String(msg ?? ''), options.maxTextLength),
-                    });
+                        message: e.message,
+                        errorName: e.name,
+                        stack: e.stack,
+                    };
+                    if (!shouldReport(buildErrorKey(options.reportType, payload)))
+                        return;
+                    report(options.reportType, payload);
                 }
                 catch {
                     // ignore
@@ -667,15 +1802,22 @@ function installMiniProgramErrorMonitor(report, options) {
         if (wxAny && typeof wxAny.onUnhandledRejection === 'function') {
             wxAny.onUnhandledRejection((res) => {
                 try {
-                    if (!sampleHit$1(options.sampleRate))
+                    if (!sampleHit$2(options.sampleRate))
                         return;
                     const e = normalizeErrorLike(res?.reason, options.maxTextLength);
-                    report(options.reportType, {
+                    // 检查是否应该忽略此错误
+                    if (shouldIgnoreMessage(e.message, options.ignoreMessages))
+                        return;
+                    const payload = {
+                        pagePath: getMpPagePath(),
                         source: 'wx.onUnhandledRejection',
                         message: e.message,
                         errorName: e.name,
                         stack: e.stack,
-                    });
+                    };
+                    if (!shouldReport(buildErrorKey(options.reportType, payload)))
+                        return;
+                    report(options.reportType, payload);
                 }
                 catch {
                     // ignore
@@ -686,7 +1828,6 @@ function installMiniProgramErrorMonitor(report, options) {
     catch {
         // ignore
     }
-    // 包装 App({...}) 注入 onError/onUnhandledRejection（推荐）
     try {
         if (typeof g.App === 'function' && !g.__beLinkClsLoggerAppWrapped__) {
             g.__beLinkClsLoggerAppWrapped__ = true;
@@ -696,11 +1837,20 @@ function installMiniProgramErrorMonitor(report, options) {
                 const rawOnError = next.onError;
                 next.onError = function (...args) {
                     try {
-                        if (sampleHit$1(options.sampleRate)) {
-                            report(options.reportType, {
-                                source: 'App.onError',
-                                message: truncate$2(String(args?.[0] ?? ''), options.maxTextLength),
-                            });
+                        if (sampleHit$2(options.sampleRate)) {
+                            const e = normalizeErrorLike(args?.[0], options.maxTextLength);
+                            // 检查是否应该忽略此错误
+                            if (!shouldIgnoreMessage(e.message, options.ignoreMessages)) {
+                                const payload = {
+                                    pagePath: getMpPagePath(),
+                                    source: 'App.onError',
+                                    message: e.message,
+                                    errorName: e.name,
+                                    stack: e.stack,
+                                };
+                                if (shouldReport(buildErrorKey(options.reportType, payload)))
+                                    report(options.reportType, payload);
+                            }
                         }
                     }
                     catch {
@@ -713,15 +1863,21 @@ function installMiniProgramErrorMonitor(report, options) {
                 const rawOnUnhandled = next.onUnhandledRejection;
                 next.onUnhandledRejection = function (...args) {
                     try {
-                        if (sampleHit$1(options.sampleRate)) {
+                        if (sampleHit$2(options.sampleRate)) {
                             const reason = args?.[0]?.reason ?? args?.[0];
                             const e = normalizeErrorLike(reason, options.maxTextLength);
-                            report(options.reportType, {
-                                source: 'App.onUnhandledRejection',
-                                message: e.message,
-                                errorName: e.name,
-                                stack: e.stack,
-                            });
+                            // 检查是否应该忽略此错误
+                            if (!shouldIgnoreMessage(e.message, options.ignoreMessages)) {
+                                const payload = {
+                                    pagePath: getMpPagePath(),
+                                    source: 'App.onUnhandledRejection',
+                                    message: e.message,
+                                    errorName: e.name,
+                                    stack: e.stack,
+                                };
+                                if (shouldReport(buildErrorKey(options.reportType, payload)))
+                                    report(options.reportType, payload);
+                            }
                         }
                     }
                     catch {
@@ -739,7 +1895,7 @@ function installMiniProgramErrorMonitor(report, options) {
         // ignore
     }
 }
-function installErrorMonitor(report, opts = {}) {
+function installMiniErrorMonitor(report, opts = {}) {
     const enabled = opts === undefined ? true : !!opts;
     if (!enabled)
         return;
@@ -750,12 +1906,18 @@ function installErrorMonitor(report, opts = {}) {
         sampleRate: raw.sampleRate ?? 1,
         captureResourceError: raw.captureResourceError ?? true,
         maxTextLength: raw.maxTextLength ?? DEFAULT_MAX_TEXT,
+        dedupeWindowMs: raw.dedupeWindowMs ?? DEFAULT_DEDUPE_WINDOW_MS,
+        dedupeMaxKeys: raw.dedupeMaxKeys ?? DEFAULT_DEDUPE_MAX_KEYS,
+        ignoreMessages: raw.ignoreMessages ?? DEFAULT_IGNORE_MESSAGES,
     };
+    installMiniProgramErrorMonitor(report, options);
+}
+
+function installErrorMonitor(report, opts = {}) {
     if (isMiniProgramEnv()) {
-        installMiniProgramErrorMonitor(report, options);
-        return;
+        return installMiniErrorMonitor(report, opts);
     }
-    installBrowserErrorMonitor(report, options);
+    return installWebErrorMonitor(report, opts);
 }
 
 const DEFAULT_IGNORE = ['cls.tencentcs.com', /\/cls\//i];
@@ -764,7 +1926,7 @@ function truncate$1(s, maxLen) {
         return s;
     return s.length > maxLen ? `${s.slice(0, maxLen)}...` : s;
 }
-function sampleHit(sampleRate) {
+function sampleHit$1(sampleRate) {
     if (sampleRate >= 1)
         return true;
     if (sampleRate <= 0)
@@ -792,20 +1954,16 @@ function getPagePath() {
     try {
         if (typeof window === 'undefined')
             return '';
-        return window.location?.pathname ?? '';
+        return window.location?.href ?? '';
     }
     catch {
         return '';
     }
 }
-function reportMetric(report, reportType, metric, value, extra = {}) {
-    report(reportType, {
-        pagePath: getPagePath(),
-        metric,
-        value,
-        ...extra,
-    });
-}
+/**
+ * 安装浏览器性能监控
+ * 使用 Google web-vitals 库实现 Core Web Vitals 指标采集
+ */
 function installBrowserPerformanceMonitor(report, options) {
     if (typeof window === 'undefined')
         return;
@@ -814,159 +1972,130 @@ function installBrowserPerformanceMonitor(report, options) {
         return;
     w.__beLinkClsLoggerPerfInstalled__ = true;
     const ignoreUrls = [...DEFAULT_IGNORE, ...(options.ignoreUrls ?? [])];
-    // Navigation timing: TTFB 等
-    if (options.navigationTiming) {
+    // Web Vitals: 使用 Google web-vitals 库
+    // 这个库会自动处理：
+    // - LCP 在用户交互后停止观察
+    // - firstHiddenTime 过滤（页面隐藏后的数据不计入）
+    // - CLS 5秒会话窗口算法
+    // - BFCache 恢复时自动重置指标
+    if (options.webVitals) {
+        // FCP
         try {
-            const navEntries = performance.getEntriesByType?.('navigation');
-            const nav = Array.isArray(navEntries) ? navEntries[0] : undefined;
-            if (nav && typeof nav === 'object') {
-                const ttfb = typeof nav.responseStart === 'number' && typeof nav.requestStart === 'number'
-                    ? nav.responseStart - nav.requestStart
-                    : -1;
-                if (ttfb >= 0 && sampleHit(options.sampleRate))
-                    reportMetric(report, options.reportType, 'TTFB', ttfb, { unit: 'ms' });
-            }
+            onFCP((metric) => {
+                report(options.reportType, {
+                    pagePath: getPagePath(),
+                    metric: 'FCP',
+                    value: metric.value,
+                    unit: 'ms',
+                    rating: metric.rating,
+                    id: metric.id,
+                    navigationType: metric.navigationType,
+                });
+            });
         }
         catch {
             // ignore
         }
-    }
-    // Web Vitals: FCP/LCP/CLS/FID
-    if (options.webVitals && typeof globalThis.PerformanceObserver === 'function') {
-        // FCP
+        // LCP（自动处理用户交互后停止）
         try {
-            const po = new PerformanceObserver((list) => {
-                try {
-                    if (!sampleHit(options.sampleRate))
-                        return;
-                    for (const entry of list.getEntries()) {
-                        if (entry?.name === 'first-contentful-paint' && typeof entry.startTime === 'number') {
-                            reportMetric(report, options.reportType, 'FCP', entry.startTime, { unit: 'ms' });
-                        }
-                    }
-                }
-                catch {
-                    // ignore
-                }
+            onLCP((metric) => {
+                report(options.reportType, {
+                    pagePath: getPagePath(),
+                    metric: 'LCP',
+                    value: metric.value,
+                    unit: 'ms',
+                    rating: metric.rating,
+                    id: metric.id,
+                    navigationType: metric.navigationType,
+                });
             });
-            po.observe({ type: 'paint', buffered: true });
         }
         catch {
             // ignore
         }
-        // LCP（最后一次为准）
-        let lastLcp = null;
+        // CLS（自动处理会话窗口）
         try {
-            const po = new PerformanceObserver((list) => {
-                try {
-                    const entries = list.getEntries();
-                    if (entries && entries.length)
-                        lastLcp = entries[entries.length - 1];
-                }
-                catch {
-                    // ignore
-                }
+            onCLS((metric) => {
+                report(options.reportType, {
+                    pagePath: getPagePath(),
+                    metric: 'CLS',
+                    value: metric.value,
+                    unit: 'score',
+                    rating: metric.rating,
+                    id: metric.id,
+                    navigationType: metric.navigationType,
+                });
             });
-            po.observe({ type: 'largest-contentful-paint', buffered: true });
-            const flushLcp = () => {
-                try {
-                    if (!lastLcp)
-                        return;
-                    if (!sampleHit(options.sampleRate))
-                        return;
-                    if (typeof lastLcp.startTime === 'number')
-                        reportMetric(report, options.reportType, 'LCP', lastLcp.startTime, { unit: 'ms' });
-                    lastLcp = null;
-                }
-                catch {
-                    // ignore
-                }
-            };
-            window.addEventListener('pagehide', flushLcp, { once: true });
-            document.addEventListener('visibilitychange', () => {
-                if (document.visibilityState === 'hidden')
-                    flushLcp();
-            }, { once: true });
         }
         catch {
             // ignore
         }
-        // CLS
+        // INP（替代 FID，2024年3月起成为核心指标）
         try {
-            let clsValue = 0;
-            const po = new PerformanceObserver((list) => {
-                try {
-                    for (const entry of list.getEntries()) {
-                        if (entry && entry.hadRecentInput)
-                            continue;
-                        if (typeof entry.value === 'number')
-                            clsValue += entry.value;
-                    }
-                }
-                catch {
-                    // ignore
-                }
+            onINP((metric) => {
+                report(options.reportType, {
+                    pagePath: getPagePath(),
+                    metric: 'INP',
+                    value: metric.value,
+                    unit: 'ms',
+                    rating: metric.rating,
+                    id: metric.id,
+                    navigationType: metric.navigationType,
+                });
             });
-            po.observe({ type: 'layout-shift', buffered: true });
-            const flushCls = () => {
-                try {
-                    if (!sampleHit(options.sampleRate))
-                        return;
-                    reportMetric(report, options.reportType, 'CLS', clsValue, { unit: 'score' });
-                }
-                catch {
-                    // ignore
-                }
-            };
-            window.addEventListener('pagehide', flushCls, { once: true });
-            document.addEventListener('visibilitychange', () => {
-                if (document.visibilityState === 'hidden')
-                    flushCls();
-            }, { once: true });
         }
         catch {
             // ignore
         }
-        // FID
+        // TTFB
         try {
-            const po = new PerformanceObserver((list) => {
-                try {
-                    if (!sampleHit(options.sampleRate))
-                        return;
-                    for (const entry of list.getEntries()) {
-                        const startTime = typeof entry.startTime === 'number' ? entry.startTime : -1;
-                        const processingStart = typeof entry.processingStart === 'number' ? entry.processingStart : -1;
-                        if (startTime >= 0 && processingStart >= 0) {
-                            reportMetric(report, options.reportType, 'FID', processingStart - startTime, { unit: 'ms' });
-                            break;
-                        }
-                    }
-                }
-                catch {
-                    // ignore
-                }
+            onTTFB((metric) => {
+                report(options.reportType, {
+                    pagePath: getPagePath(),
+                    metric: 'TTFB',
+                    value: metric.value,
+                    unit: 'ms',
+                    rating: metric.rating,
+                    id: metric.id,
+                    navigationType: metric.navigationType,
+                });
             });
-            po.observe({ type: 'first-input', buffered: true });
         }
         catch {
             // ignore
         }
     }
-    // Resource timing：资源加载耗时
+    // Resource timing：资源加载耗时（web-vitals 不包含此功能，保留原有实现）
     if (options.resourceTiming && typeof globalThis.PerformanceObserver === 'function') {
         try {
             const po = new PerformanceObserver((list) => {
                 try {
-                    if (!sampleHit(options.sampleRate))
+                    if (!sampleHit$1(options.sampleRate))
                         return;
                     for (const entry of list.getEntries()) {
                         const name = String(entry?.name ?? '');
                         if (!name || shouldIgnoreUrl(name, ignoreUrls))
                             continue;
                         const initiatorType = String(entry?.initiatorType ?? '');
-                        // 对齐文档：关注 fetch/xhr/img/script（同时允许 css/other 但不强制）
+                        // 关注 fetch/xhr/img/script（同时允许 css/other 但不强制）
                         if (!['xmlhttprequest', 'fetch', 'img', 'script', 'css'].includes(initiatorType))
                             continue;
+                        // 时序分解（便于定位慢在哪个阶段）
+                        const domainLookupStart = entry.domainLookupStart ?? 0;
+                        const domainLookupEnd = entry.domainLookupEnd ?? 0;
+                        const connectStart = entry.connectStart ?? 0;
+                        const connectEnd = entry.connectEnd ?? 0;
+                        const requestStart = entry.requestStart ?? 0;
+                        const responseStart = entry.responseStart ?? 0;
+                        const responseEnd = entry.responseEnd ?? 0;
+                        const dns = domainLookupEnd - domainLookupStart;
+                        const tcp = connectEnd - connectStart;
+                        const ttfb = responseStart - requestStart;
+                        const download = responseEnd - responseStart;
+                        // 缓存检测：transferSize=0 且 decodedBodySize>0 表示缓存命中
+                        const transferSize = entry.transferSize ?? 0;
+                        const decodedBodySize = entry.decodedBodySize ?? 0;
+                        const cached = transferSize === 0 && decodedBodySize > 0;
                         const payload = {
                             pagePath: getPagePath(),
                             metric: 'resource',
@@ -974,16 +2103,26 @@ function installBrowserPerformanceMonitor(report, options) {
                             url: truncate$1(name, options.maxTextLength),
                             startTime: typeof entry?.startTime === 'number' ? entry.startTime : undefined,
                             duration: typeof entry?.duration === 'number' ? entry.duration : undefined,
+                            // 时序分解（跨域资源可能为 0）
+                            dns: dns > 0 ? Math.round(dns) : undefined,
+                            tcp: tcp > 0 ? Math.round(tcp) : undefined,
+                            ttfb: ttfb > 0 ? Math.round(ttfb) : undefined,
+                            download: download > 0 ? Math.round(download) : undefined,
+                            // 缓存标记
+                            cached,
                         };
-                        // 兼容字段（部分浏览器支持）
-                        if (typeof entry?.transferSize === 'number')
-                            payload.transferSize = entry.transferSize;
-                        if (typeof entry?.encodedBodySize === 'number')
+                        // 尺寸字段（跨域资源可能为 0）
+                        if (transferSize > 0)
+                            payload.transferSize = transferSize;
+                        if (typeof entry?.encodedBodySize === 'number' && entry.encodedBodySize > 0) {
                             payload.encodedBodySize = entry.encodedBodySize;
-                        if (typeof entry?.decodedBodySize === 'number')
-                            payload.decodedBodySize = entry.decodedBodySize;
-                        if (typeof entry?.nextHopProtocol === 'string')
+                        }
+                        if (decodedBodySize > 0)
+                            payload.decodedBodySize = decodedBodySize;
+                        // 协议和状态
+                        if (typeof entry?.nextHopProtocol === 'string' && entry.nextHopProtocol) {
                             payload.nextHopProtocol = entry.nextHopProtocol;
+                        }
                         if (typeof entry?.responseStatus === 'number')
                             payload.status = entry.responseStatus;
                         report(options.reportType, payload);
@@ -1000,146 +2139,98 @@ function installBrowserPerformanceMonitor(report, options) {
         }
     }
 }
-function wrapMiniProgramRouteApi(report, reportType, apiName, options) {
-    const wxAny = globalThis.wx;
-    if (!wxAny || typeof wxAny[apiName] !== 'function')
-        return;
-    const flagKey = `__beLinkClsLoggerMpRouteWrapped__${apiName}`;
-    if (wxAny[flagKey])
+function installWebPerformanceMonitor(report, opts = {}) {
+    const enabled = opts === undefined ? true : !!opts;
+    if (!enabled)
         return;
-    wxAny[flagKey] = true;
-    const raw = wxAny[apiName].bind(wxAny);
-    wxAny[apiName] = (opts) => {
-        const start = Date.now();
-        const url = opts?.url ? String(opts.url) : '';
-        const wrapCb = (cb, success) => {
-            return (...args) => {
-                try {
-                    if (sampleHit(options.sampleRate)) {
-                        report(reportType, {
-                            metric: 'route',
-                            api: apiName,
-                            url,
-                            duration: Date.now() - start,
-                            success: success ? 1 : 0,
-                            error: success ? '' : truncate$1(stringifyLogValue(args?.[0]), options.maxTextLength),
-                            unit: 'ms',
-                        });
-                    }
-                }
-                catch {
-                    // ignore
-                }
-                if (typeof cb === 'function')
-                    return cb(...args);
-                return undefined;
-            };
-        };
-        const next = { ...(opts ?? {}) };
-        next.success = wrapCb(next.success, true);
-        next.fail = wrapCb(next.fail, false);
-        return raw(next);
+    const raw = typeof opts === 'object' && opts ? opts : {};
+    const options = {
+        enabled: true,
+        reportType: raw.reportType ?? 'perf',
+        sampleRate: raw.sampleRate ?? 1,
+        ignoreUrls: raw.ignoreUrls ?? [],
+        webVitals: raw.webVitals ?? true,
+        resourceTiming: raw.resourceTiming ?? true,
+        maxTextLength: raw.maxTextLength ?? 2000,
     };
+    installBrowserPerformanceMonitor(report, options);
 }
-function installMiniProgramPageRenderMonitor(report, reportType, options) {
-    const g = globalThis;
-    if (typeof g.Page !== 'function')
-        return;
-    if (g.__beLinkClsLoggerPageWrapped__)
-        return;
-    g.__beLinkClsLoggerPageWrapped__ = true;
-    const rawPage = g.Page;
-    g.Page = (pageOptions) => {
-        const next = { ...(pageOptions ?? {}) };
-        const rawOnLoad = next.onLoad;
-        const rawOnReady = next.onReady;
-        next.onLoad = function (...args) {
-            try {
-                this.__beLinkClsLoggerPageLoadTs__ = Date.now();
-            }
-            catch {
-                // ignore
-            }
-            if (typeof rawOnLoad === 'function')
-                return rawOnLoad.apply(this, args);
-            return undefined;
-        };
-        next.onReady = function (...args) {
-            try {
-                const start = this.__beLinkClsLoggerPageLoadTs__;
-                if (typeof start === 'number' && sampleHit(options.sampleRate)) {
-                    report(reportType, {
-                        metric: 'page-render',
-                        route: this?.route ? String(this.route) : '',
-                        duration: Date.now() - start,
-                        unit: 'ms',
-                    });
-                }
-            }
-            catch {
-                // ignore
-            }
-            if (typeof rawOnReady === 'function')
-                return rawOnReady.apply(this, args);
-            return undefined;
-        };
-        return rawPage(next);
-    };
+
+function sampleHit(sampleRate) {
+    if (sampleRate >= 1)
+        return true;
+    if (sampleRate <= 0)
+        return false;
+    return Math.random() < sampleRate;
 }
 function installMiniProgramPerformanceMonitor(report, options) {
     const g = globalThis;
+    const ctx = g.wx || g.Taro;
+    if (!ctx || typeof ctx.getPerformance !== 'function')
+        return;
     if (g.__beLinkClsLoggerMpPerfInstalled__)
         return;
     g.__beLinkClsLoggerMpPerfInstalled__ = true;
-    // 路由切换耗时（用 API 回调近似）
-    for (const apiName of ['navigateTo', 'redirectTo', 'switchTab', 'reLaunch']) {
-        try {
-            wrapMiniProgramRouteApi(report, options.reportType, apiName, options);
-        }
-        catch {
-            // ignore
-        }
-    }
-    // 页面渲染耗时（onLoad -> onReady）
-    try {
-        installMiniProgramPageRenderMonitor(report, options.reportType, options);
-    }
-    catch {
-        // ignore
-    }
-    // wx.getPerformance()（若可用，尝试读取已有 entries）
     try {
-        const wxAny = globalThis.wx;
-        if (wxAny && typeof wxAny.getPerformance === 'function') {
-            const perf = wxAny.getPerformance();
-            if (perf && isPlainObject(perf)) {
-                // 不同基础库实现差异较大：尽量容错
-                setTimeout(() => {
-                    try {
-                        if (!sampleHit(options.sampleRate))
-                            return;
-                        const entries = typeof perf.getEntries === 'function'
-                            ? perf.getEntries()
-                            : typeof perf.getEntriesByType === 'function'
-                                ? perf.getEntriesByType('navigation')
-                                : [];
+        const perf = ctx.getPerformance();
+        if (!perf || typeof perf.createObserver !== 'function')
+            return;
+        const observer = perf.createObserver((entryList) => {
+            try {
+                const entries = entryList.getEntries();
+                for (const entry of entries) {
+                    if (!sampleHit(options.sampleRate))
+                        continue;
+                    // Page Render: firstRender
+                    if (entry.entryType === 'render' && entry.name === 'firstRender') {
+                        const duration = typeof entry.duration === 'number'
+                            ? entry.duration
+                            : typeof entry.startTime === 'number' && typeof entry.endTime === 'number'
+                                ? entry.endTime - entry.startTime
+                                : 0;
                         report(options.reportType, {
-                            metric: 'mp-performance',
-                            entries: truncate$1(stringifyLogValue(entries), options.maxTextLength),
+                            metric: 'page-render',
+                            duration,
+                            pagePath: entry.path || '',
+                            unit: 'ms',
                         });
                     }
-                    catch {
-                        // ignore
+                    // Route Switch: route
+                    else if (entry.entryType === 'navigation' && entry.name === 'route') {
+                        const duration = typeof entry.duration === 'number'
+                            ? entry.duration
+                            : typeof entry.startTime === 'number' && typeof entry.endTime === 'number'
+                                ? entry.endTime - entry.startTime
+                                : 0;
+                        report(options.reportType, {
+                            metric: 'route',
+                            duration,
+                            pagePath: entry.path || '',
+                            unit: 'ms',
+                        });
+                    }
+                    // App Launch: appLaunch (Cold)
+                    else if (entry.entryType === 'navigation' && entry.name === 'appLaunch') {
+                        report(options.reportType, {
+                            metric: 'app-launch',
+                            duration: entry.duration,
+                            launchType: 'cold',
+                            unit: 'ms',
+                        });
                     }
-                }, 0);
+                }
             }
-        }
+            catch {
+                // ignore
+            }
+        });
+        observer.observe({ entryTypes: ['navigation', 'render'] });
     }
     catch {
         // ignore
     }
 }
-function installPerformanceMonitor(report, opts = {}) {
+function installMiniPerformanceMonitor(report, opts = {}) {
     const enabled = opts === undefined ? true : !!opts;
     if (!enabled)
         return;
@@ -1150,18 +2241,20 @@ function installPerformanceMonitor(report, opts = {}) {
         sampleRate: raw.sampleRate ?? 1,
         ignoreUrls: raw.ignoreUrls ?? [],
         webVitals: raw.webVitals ?? true,
-        navigationTiming: raw.navigationTiming ?? true,
         resourceTiming: raw.resourceTiming ?? true,
         maxTextLength: raw.maxTextLength ?? 2000,
     };
+    installMiniProgramPerformanceMonitor(report, options);
+}
+
+function installPerformanceMonitor(report, opts = {}) {
     if (isMiniProgramEnv()) {
-        installMiniProgramPerformanceMonitor(report, options);
-        return;
+        return installMiniPerformanceMonitor(report, opts);
     }
-    installBrowserPerformanceMonitor(report, options);
+    return installWebPerformanceMonitor(report, opts);
 }
 
-function shouldSample(sampleRate) {
+function shouldSample$1(sampleRate) {
     const r = sampleRate ?? 1;
     if (r >= 1)
         return true;
@@ -1169,19 +2262,17 @@ function shouldSample(sampleRate) {
         return false;
     return Math.random() < r;
 }
-function generateUUID() {
-    // 优先使用更安全的 crypto.randomUUID
+function generateUUID$1() {
     const g = globalThis;
     if (g.crypto?.randomUUID)
         return g.crypto.randomUUID();
-    // fallback
     return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
         const r = Math.random() * 16 || 0;
         const v = c === 'x' ? r | 0 : ((r | 0) & 0x3) | 0x8;
         return v.toString(16);
     });
 }
-function safeReadUvMeta(key) {
+function safeReadUvMeta$1(key) {
     const raw = readStringStorage(key);
     if (!raw)
         return { firstVisitTs: Date.now(), visitCount: 0 };
@@ -1200,27 +2291,15 @@ function safeReadUvMeta(key) {
         return { firstVisitTs: Date.now(), visitCount: 0 };
     }
 }
-function writeUvMeta(key, meta) {
+function writeUvMeta$1(key, meta) {
     writeStringStorage(key, JSON.stringify(meta));
 }
 function getWebPagePath() {
     if (typeof window === 'undefined')
         return '';
-    return window.location?.pathname || '';
-}
-function getMiniProgramPagePath() {
-    const g = globalThis;
-    try {
-        const pages = typeof g.getCurrentPages === 'function' ? g.getCurrentPages() : [];
-        const last = Array.isArray(pages) ? pages[pages.length - 1] : undefined;
-        const route = (last?.route || last?.__route__);
-        return typeof route === 'string' ? route : '';
-    }
-    catch {
-        return '';
-    }
+    return window.location?.href || '';
 }
-function buildCommonUvFields(uvId, uvMeta, isFirstVisit) {
+function buildCommonUvFields$1(uvId, uvMeta, isFirstVisit) {
     return {
         uvId,
         isFirstVisit,
@@ -1236,14 +2315,14 @@ function getAttr(el, attrName) {
         return '';
     }
 }
-function truncateText(s, maxLen) {
+function truncateText$1(s, maxLen) {
     if (!s)
         return '';
     if (s.length <= maxLen)
         return s;
     return s.slice(0, maxLen);
 }
-function installBehaviorMonitor(report, envType, options = {}) {
+function installWebBehaviorMonitor(report, options = {}) {
     const enableTrack = options.enableTrack ?? options.enabled ?? true;
     if (!enableTrack)
         return () => { };
@@ -1255,39 +2334,28 @@ function installBehaviorMonitor(report, envType, options = {}) {
     const clickReportType = options.clickReportType ?? 'click';
     const uvIdStorageKey = options.uvIdStorageKey ?? 'cls_uv_id';
     const uvMetaStorageKey = options.uvMetaStorageKey ?? 'cls_uv_meta';
-    const lastPagePathStorageKey = options.lastPagePathStorageKey ?? 'cls_last_page_path';
     const uvExpireDaysRaw = options.trackOptions?.uvExpireDays ?? options.uvExpireDays ?? 30;
     const uvExpireDays = Number.isFinite(uvExpireDaysRaw) ? Math.max(0, uvExpireDaysRaw) : 30;
     const uvExpireMs = uvExpireDays * 24 * 60 * 60 * 1000;
-    const defaultClickWhiteList = envType === 'miniprogram' || isMiniProgramEnv() ? ['view', 'scroll-view'] : ['body', 'html'];
-    const clickWhiteList = (options.trackOptions?.clickWhiteList ?? options.clickWhiteList ?? defaultClickWhiteList).map((s) => String(s).toLowerCase());
+    const clickWhiteList = (options.trackOptions?.clickWhiteList ?? options.clickWhiteList ?? ['body', 'html']).map((s) => String(s).toLowerCase());
     const clickTrackIdAttr = options.clickTrackIdAttr ?? 'data-track-id';
     const clickMaxTextLength = options.clickMaxTextLength ?? 120;
-    const getPagePath = options.getPagePath ??
-        (() => {
-            if (envType === 'miniprogram' || isMiniProgramEnv())
-                return getMiniProgramPagePath();
-            return getWebPagePath();
-        });
+    const getPagePath = options.getPagePath ?? getWebPagePath;
     let destroyed = false;
-    // UV 状态：可能异步（openid/指纹）
     let firstVisitFlag = false;
     let firstVisitConsumed = false;
     const uvStatePromise = (async () => {
         let existingUvId = readStringStorage(uvIdStorageKey);
         let isFirstVisit = false;
-        // 先读 meta，做过期判断（过期则清空 uvId + 重置 meta）
         const now = Date.now();
-        const metaBefore = safeReadUvMeta(uvMetaStorageKey);
+        const metaBefore = safeReadUvMeta$1(uvMetaStorageKey);
         const lastSeenForExpire = metaBefore.lastSeenTs ?? metaBefore.createdAtTs ?? metaBefore.firstVisitTs ?? now;
         const expired = uvExpireMs > 0 && now - lastSeenForExpire > uvExpireMs;
         if (expired) {
             existingUvId = null;
-            // 重置 meta（visitCount 会在后续 +1）
-            writeUvMeta(uvMetaStorageKey, { firstVisitTs: now, visitCount: 0, createdAtTs: now, lastSeenTs: now });
+            writeUvMeta$1(uvMetaStorageKey, { firstVisitTs: now, visitCount: 0, createdAtTs: now, lastSeenTs: now });
             writeStringStorage(uvIdStorageKey, '');
         }
-        // 如果外部提供 getUvId，优先使用；否则本地生成
         try {
             if (options.getUvId) {
                 const maybe = options.getUvId();
@@ -1297,42 +2365,14 @@ function installBehaviorMonitor(report, envType, options = {}) {
             }
         }
         catch {
-            // ignore
-        }
-        // 小程序：默认尝试 openid / 设备标识（兼容你给的参考实现）
-        if (!existingUvId && (envType === 'miniprogram' || isMiniProgramEnv())) {
-            const wxAny = globalThis.wx;
-            try {
-                const userInfo = wxAny?.getStorageSync?.('userInfo');
-                if (userInfo?.openid)
-                    existingUvId = String(userInfo.openid);
-            }
-            catch {
-                // ignore
-            }
-            if (!existingUvId) {
-                try {
-                    const sys = wxAny?.getSystemInfoSync?.();
-                    const deviceId = sys?.deviceId ? String(sys.deviceId) : '';
-                    const model = sys?.model ? String(sys.model) : '';
-                    const system = sys?.system ? String(sys.system) : '';
-                    const base = [deviceId || model, system].filter(Boolean).join('_');
-                    if (base)
-                        existingUvId = `${base}_${Date.now()}`;
-                }
-                catch {
-                    // ignore
-                }
-            }
+            /* ignore */
         }
         if (!existingUvId) {
-            existingUvId = generateUUID();
+            existingUvId = generateUUID$1();
             isFirstVisit = true;
         }
-        // 只要拿到了 uvId，就写入持久化（便于下次启动复用）
         writeStringStorage(uvIdStorageKey, existingUvId);
-        const meta = safeReadUvMeta(uvMetaStorageKey);
-        // 每次启动都 +1（“累计访问次数”）
+        const meta = safeReadUvMeta$1(uvMetaStorageKey);
         const createdAt = meta.createdAtTs ?? meta.firstVisitTs ?? now;
         const firstVisit = meta.firstVisitTs || now;
         const nextMeta = {
@@ -1341,19 +2381,18 @@ function installBehaviorMonitor(report, envType, options = {}) {
             createdAtTs: createdAt,
             lastSeenTs: now,
         };
-        // 如果是首次访问，刷新 firstVisitTs
         if (isFirstVisit) {
             nextMeta.firstVisitTs = now;
             nextMeta.createdAtTs = now;
         }
-        writeUvMeta(uvMetaStorageKey, nextMeta);
+        writeUvMeta$1(uvMetaStorageKey, nextMeta);
         firstVisitFlag = isFirstVisit;
         return { uvId: existingUvId, isFirstVisit, meta: nextMeta };
     })();
     function safeReport(type, data) {
         if (destroyed)
             return;
-        if (!shouldSample(options.sampleRate))
+        if (!shouldSample$1(options.sampleRate))
             return;
         report(type, data);
     }
@@ -1361,20 +2400,7 @@ function installBehaviorMonitor(report, envType, options = {}) {
         const once = firstVisitFlag && !firstVisitConsumed;
         if (once)
             firstVisitConsumed = true;
-        return buildCommonUvFields(uvId, meta, once);
-    }
-    function reportUvOncePerSession() {
-        if (!uvEnabled)
-            return;
-        void uvStatePromise.then(({ uvId, meta }) => {
-            if (destroyed)
-                return;
-            safeReport(uvReportType, {
-                ...buildUvFieldsOnce(uvId, meta),
-                timestamp: Date.now(),
-                pagePath: getPagePath(),
-            });
-        });
+        return buildCommonUvFields$1(uvId, meta, once);
     }
     function reportPv(pagePath) {
         if (!pvEnabled)
@@ -1386,956 +2412,780 @@ function installBehaviorMonitor(report, envType, options = {}) {
                 ...buildUvFieldsOnce(uvId, meta),
                 timestamp: Date.now(),
                 pagePath,
+                referrer: typeof document !== 'undefined' ? document.referrer || '' : '',
             };
-            // Web referrer（小程序为空串）
-            if (typeof document !== 'undefined') {
-                payload.referrer = document.referrer || '';
-            }
-            else if (envType === 'miniprogram' || isMiniProgramEnv()) {
-                payload.referrer = readStringStorage(lastPagePathStorageKey) || '';
-                writeStringStorage(lastPagePathStorageKey, pagePath);
-            }
             safeReport(pvReportType, payload);
         });
     }
-    // --- Web: PV ---
+    // Web PV Listeners
     let removeWebPvListeners = null;
-    if (!destroyed && pvEnabled && typeof window !== 'undefined' && typeof history !== 'undefined') {
+    if (pvEnabled && typeof window !== 'undefined' && typeof history !== 'undefined') {
         const originalPushState = window.history.pushState?.bind(window.history);
         const originalReplaceState = window.history.replaceState?.bind(window.history);
-        const onRouteChanged = () => reportPv(getPagePath());
-        // 首次进入页面上报 PV
-        onRouteChanged();
-        // patch pushState/replaceState
-        if (originalPushState) {
-            window.history.pushState = ((...args) => {
-                const r = originalPushState.apply(window.history, args);
-                onRouteChanged();
-                return r;
-            });
-        }
-        if (originalReplaceState) {
-            window.history.replaceState = ((...args) => {
-                const r = originalReplaceState.apply(window.history, args);
-                onRouteChanged();
-                return r;
-            });
-        }
-        window.addEventListener('popstate', onRouteChanged);
-        removeWebPvListeners = () => {
-            try {
-                window.removeEventListener('popstate', onRouteChanged);
-            }
-            catch {
-                // ignore
-            }
-            try {
-                if (originalPushState)
-                    window.history.pushState = originalPushState;
-                if (originalReplaceState)
-                    window.history.replaceState = originalReplaceState;
-            }
-            catch {
-                // ignore
-            }
-        };
-    }
-    // --- Web: Click ---
-    let removeWebClickListener = null;
-    if (!destroyed && clickEnabled && typeof document !== 'undefined') {
-        const onClick = (e) => {
-            if (destroyed)
-                return;
-            const target = e.target;
-            if (!target)
-                return;
-            // 向上找最接近的带 trackId 的元素（优先）
-            const closestWithTrackId = typeof target.closest === 'function'
-                ? target.closest(`[${clickTrackIdAttr}]`)
-                : null;
-            const el = closestWithTrackId || target;
-            const tag = (el.tagName || '').toLowerCase();
-            const trackId = getAttr(el, clickTrackIdAttr);
-            // 过滤无效点击：白名单 tag + 没有 trackId
-            if (clickWhiteList.includes(tag) && !trackId)
-                return;
-            void uvStatePromise.then(({ uvId, meta }) => {
-                if (destroyed)
-                    return;
-                safeReport(clickReportType, {
-                    ...buildUvFieldsOnce(uvId, meta),
-                    timestamp: Date.now(),
-                    pagePath: getPagePath(),
-                    elementTag: el.tagName || '',
-                    elementId: el.id || '',
-                    elementClass: stringifyLogValue(el.className ?? ''),
-                    trackId: trackId || '',
-                    elementText: truncateText((el.textContent ?? '').trim(), clickMaxTextLength),
-                    clickX: Number.isFinite(e.clientX) ? e.clientX : 0,
-                    clickY: Number.isFinite(e.clientY) ? e.clientY : 0,
-                });
-            });
-        };
-        document.addEventListener('click', onClick, true);
-        removeWebClickListener = () => {
-            try {
-                document.removeEventListener('click', onClick, true);
-            }
-            catch {
-                // ignore
-            }
-        };
-    }
-    // --- MiniProgram: PV (best-effort) ---
-    let restoreMiniProgramPatch = null;
-    if (!destroyed && (envType === 'miniprogram' || isMiniProgramEnv())) {
-        const g = globalThis;
-        const patchedKey = '__beLinkClsLoggerBehaviorPatched__';
-        if (!g[patchedKey]) {
-            g[patchedKey] = true;
-            const originalPage = typeof g.Page === 'function' ? g.Page : null;
-            if (originalPage) {
-                g.Page = function patchedPage(conf) {
-                    const originalOnShow = conf?.onShow;
-                    conf.onShow = function (...args) {
-                        if (pvEnabled)
-                            reportPv(getPagePath());
-                        return typeof originalOnShow === 'function' ? originalOnShow.apply(this, args) : undefined;
-                    };
-                    // 点击：wrap 页面 methods（bindtap 等会调用到这里的 handler）
-                    if (clickEnabled && conf && typeof conf === 'object') {
-                        for (const key of Object.keys(conf)) {
-                            const fn = conf[key];
-                            if (typeof fn !== 'function')
-                                continue;
-                            if (fn.__beLinkWrapped__)
-                                continue;
-                            conf[key] = function (...args) {
-                                try {
-                                    const e = args?.[0];
-                                    const type = e?.type;
-                                    const currentTarget = e?.currentTarget;
-                                    const dataset = currentTarget?.dataset;
-                                    const isTap = type === 'tap' || type === 'click';
-                                    if (clickEnabled && isTap && currentTarget && dataset) {
-                                        const tagNameRaw = dataset?.tagName ?? dataset?.tag ?? currentTarget?.tagName ?? '';
-                                        const tagName = String(tagNameRaw || '').toLowerCase();
-                                        const trackId = dataset?.trackId ? String(dataset.trackId) : '';
-                                        if (!(clickWhiteList.includes(tagName) && !trackId)) {
-                                            const x = typeof e?.detail?.x === 'number'
-                                                ? e.detail.x
-                                                : typeof e?.touches?.[0]?.pageX === 'number'
-                                                    ? e.touches[0].pageX
-                                                    : 0;
-                                            const y = typeof e?.detail?.y === 'number'
-                                                ? e.detail.y
-                                                : typeof e?.touches?.[0]?.pageY === 'number'
-                                                    ? e.touches[0].pageY
-                                                    : 0;
-                                            void uvStatePromise.then(({ uvId, meta }) => {
-                                                if (destroyed)
-                                                    return;
-                                                safeReport(clickReportType, {
-                                                    ...buildUvFieldsOnce(uvId, meta),
-                                                    timestamp: Date.now(),
-                                                    pagePath: getPagePath(),
-                                                    elementTag: tagNameRaw ? String(tagNameRaw) : '',
-                                                    elementId: currentTarget?.id ? String(currentTarget.id) : '',
-                                                    elementClass: dataset?.className ? stringifyLogValue(dataset.className) : '',
-                                                    trackId,
-                                                    elementText: dataset?.text ? truncateText(String(dataset.text), clickMaxTextLength) : '',
-                                                    clickX: x,
-                                                    clickY: y,
-                                                });
-                                            });
-                                        }
-                                    }
-                                }
-                                catch {
-                                    // ignore
-                                }
-                                return fn.apply(this, args);
-                            };
-                            conf[key].__beLinkWrapped__ = true;
-                        }
-                    }
-                    return originalPage(conf);
-                };
-                restoreMiniProgramPatch = () => {
-                    try {
-                        g.Page = originalPage;
-                        g[patchedKey] = false;
-                    }
-                    catch {
-                        // ignore
-                    }
-                };
-            }
-        }
-        // 启动时也尝试报一次（避免 Page patch 未生效的场景）
-        if (pvEnabled)
-            reportPv(getPagePath());
-    }
-    // UV：每次启动上报一次（可关闭）
-    reportUvOncePerSession();
-    return () => {
-        if (destroyed)
-            return;
-        destroyed = true;
-        try {
-            removeWebPvListeners?.();
-            removeWebClickListener?.();
-            restoreMiniProgramPatch?.();
-        }
-        catch {
-            // ignore
-        }
-    };
-}
-
-function truncate(s, maxLen) {
-    if (!s)
-        return s;
-    return s.length > maxLen ? `${s.slice(0, maxLen)}...` : s;
-}
-function parseUserAgent(uaRaw) {
-    const ua = uaRaw ?? '';
-    const isMobile = /Mobile|Android|iPhone|iPad|iPod/i.test(ua);
-    // OS
-    let osName = 'unknown';
-    let osVersion = '';
-    const ios = ua.match(/OS (\d+[_\d]*) like Mac OS X/i);
-    const android = ua.match(/Android (\d+(\.\d+)*)/i);
-    const mac = ua.match(/Mac OS X (\d+[_\d]*)/i);
-    const win = ua.match(/Windows NT (\d+(\.\d+)*)/i);
-    if (ios) {
-        osName = 'iOS';
-        osVersion = ios[1].replace(/_/g, '.');
-    }
-    else if (android) {
-        osName = 'Android';
-        osVersion = android[1];
-    }
-    else if (win) {
-        osName = 'Windows';
-        osVersion = win[1];
-    }
-    else if (mac) {
-        osName = 'macOS';
-        osVersion = mac[1].replace(/_/g, '.');
-    }
-    // Browser
-    let browserName = 'unknown';
-    let browserVersion = '';
-    const edge = ua.match(/Edg\/(\d+(\.\d+)*)/);
-    const chrome = ua.match(/Chrome\/(\d+(\.\d+)*)/);
-    const safari = ua.match(/Version\/(\d+(\.\d+)*) Safari\//);
-    const firefox = ua.match(/Firefox\/(\d+(\.\d+)*)/);
-    if (edge) {
-        browserName = 'Edge';
-        browserVersion = edge[1];
-    }
-    else if (chrome) {
-        browserName = 'Chrome';
-        browserVersion = chrome[1];
-    }
-    else if (firefox) {
-        browserName = 'Firefox';
-        browserVersion = firefox[1];
-    }
-    else if (safari) {
-        browserName = 'Safari';
-        browserVersion = safari[1];
-    }
-    return { browserName, browserVersion, osName, osVersion, isMobile };
-}
-function getBrowserDeviceInfo(options) {
-    const out = {
-        envType: 'browser',
-    };
-    if (typeof window === 'undefined' || typeof navigator === 'undefined')
-        return out;
-    const ua = String(navigator.userAgent ?? '');
-    const uaParsed = parseUserAgent(ua);
-    if (options.includeUserAgent)
-        out.ua = truncate(ua, 2000);
-    out.browserName = uaParsed.browserName;
-    out.browserVersion = uaParsed.browserVersion;
-    out.osName = uaParsed.osName;
-    out.osVersion = uaParsed.osVersion;
-    out.isMobile = uaParsed.isMobile ? 1 : 0;
-    out.language = String(navigator.language ?? '');
-    out.platform = String(navigator.platform ?? '');
-    try {
-        const tz = Intl.DateTimeFormat().resolvedOptions().timeZone;
-        out.timezone = typeof tz === 'string' ? tz : '';
-    }
-    catch {
-        out.timezone = '';
-    }
-    try {
-        const s = window.screen;
-        out.screenWidth = s?.width ?? undefined;
-        out.screenHeight = s?.height ?? undefined;
-    }
-    catch {
-        // ignore
+        const onRouteChanged = () => reportPv(getPagePath());
+        onRouteChanged();
+        if (originalPushState) {
+            window.history.pushState = ((...args) => {
+                const r = originalPushState.apply(window.history, args);
+                onRouteChanged();
+                return r;
+            });
+        }
+        if (originalReplaceState) {
+            window.history.replaceState = ((...args) => {
+                const r = originalReplaceState.apply(window.history, args);
+                onRouteChanged();
+                return r;
+            });
+        }
+        window.addEventListener('popstate', onRouteChanged);
+        removeWebPvListeners = () => {
+            window.removeEventListener('popstate', onRouteChanged);
+            if (originalPushState)
+                window.history.pushState = originalPushState;
+            if (originalReplaceState)
+                window.history.replaceState = originalReplaceState;
+        };
     }
-    try {
-        out.dpr = typeof window.devicePixelRatio === 'number' ? window.devicePixelRatio : undefined;
+    // Web Click Listener
+    let removeWebClickListener = null;
+    if (clickEnabled && typeof document !== 'undefined') {
+        const onClick = (e) => {
+            if (destroyed)
+                return;
+            const target = e.target;
+            if (!target)
+                return;
+            const closestWithTrackId = typeof target.closest === 'function'
+                ? target.closest(`[${clickTrackIdAttr}]`)
+                : null;
+            const el = closestWithTrackId || target;
+            const tag = (el.tagName || '').toLowerCase();
+            const trackId = getAttr(el, clickTrackIdAttr);
+            if (clickWhiteList.includes(tag) || !trackId)
+                return;
+            void uvStatePromise.then(({ uvId, meta }) => {
+                if (destroyed)
+                    return;
+                safeReport(clickReportType, {
+                    ...buildUvFieldsOnce(uvId, meta),
+                    timestamp: Date.now(),
+                    pagePath: getPagePath(),
+                    elementTag: el.tagName || '',
+                    elementId: el.id || '',
+                    elementClass: stringifyLogValue(el.className ?? ''),
+                    trackId: trackId || '',
+                    elementText: truncateText$1((el.textContent ?? '').trim(), clickMaxTextLength),
+                    clickX: Number.isFinite(e.clientX) ? e.clientX : 0,
+                    clickY: Number.isFinite(e.clientY) ? e.clientY : 0,
+                });
+            });
+        };
+        document.addEventListener('click', onClick, true);
+        removeWebClickListener = () => document.removeEventListener('click', onClick, true);
     }
-    catch {
-        // ignore
+    // UV Initial Report
+    if (uvEnabled) {
+        void uvStatePromise.then(({ uvId, meta }) => {
+            if (destroyed)
+                return;
+            safeReport(uvReportType, {
+                ...buildUvFieldsOnce(uvId, meta),
+                timestamp: Date.now(),
+                pagePath: getPagePath(),
+            });
+        });
     }
+    return () => {
+        destroyed = true;
+        removeWebPvListeners?.();
+        removeWebClickListener?.();
+    };
+}
+
+function shouldSample(sampleRate) {
+    const r = sampleRate ?? 1;
+    if (r >= 1)
+        return true;
+    if (r <= 0)
+        return false;
+    return Math.random() < r;
+}
+function generateUUID() {
+    const g = globalThis;
+    if (g.crypto?.randomUUID)
+        return g.crypto.randomUUID();
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = Math.random() * 16 || 0;
+        const v = c === 'x' ? r | 0 : ((r | 0) & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+function safeReadUvMeta(key) {
+    const raw = readStringStorage(key);
+    if (!raw)
+        return { firstVisitTs: Date.now(), visitCount: 0 };
     try {
-        const navAny = navigator;
-        out.hardwareConcurrency = typeof navAny.hardwareConcurrency === 'number' ? navAny.hardwareConcurrency : undefined;
-        out.deviceMemory = typeof navAny.deviceMemory === 'number' ? navAny.deviceMemory : undefined;
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object')
+            return { firstVisitTs: Date.now(), visitCount: 0 };
+        const p = parsed;
+        const firstVisitTs = typeof p.firstVisitTs === 'number' && Number.isFinite(p.firstVisitTs) ? p.firstVisitTs : Date.now();
+        const visitCount = typeof p.visitCount === 'number' && Number.isFinite(p.visitCount) ? p.visitCount : 0;
+        const createdAtTs = typeof p.createdAtTs === 'number' && Number.isFinite(p.createdAtTs) ? p.createdAtTs : undefined;
+        const lastSeenTs = typeof p.lastSeenTs === 'number' && Number.isFinite(p.lastSeenTs) ? p.lastSeenTs : undefined;
+        return { firstVisitTs, visitCount, createdAtTs, lastSeenTs };
     }
     catch {
-        // ignore
-    }
-    if (options.includeNetwork) {
-        try {
-            const conn = navigator.connection || navigator.mozConnection || navigator.webkitConnection;
-            if (conn && isPlainObject(conn)) {
-                if (typeof conn.effectiveType === 'string')
-                    out.netEffectiveType = conn.effectiveType;
-                if (typeof conn.downlink === 'number')
-                    out.netDownlink = conn.downlink;
-                if (typeof conn.rtt === 'number')
-                    out.netRtt = conn.rtt;
-                if (typeof conn.saveData === 'boolean')
-                    out.netSaveData = conn.saveData ? 1 : 0;
-            }
-        }
-        catch {
-            // ignore
-        }
+        return { firstVisitTs: Date.now(), visitCount: 0 };
     }
-    return out;
 }
-function getMiniProgramDeviceInfo(options) {
-    const out = {
-        envType: 'miniprogram',
-    };
-    const wxAny = globalThis.wx;
-    if (!wxAny || typeof wxAny.getSystemInfoSync !== 'function')
-        return out;
+function writeUvMeta(key, meta) {
+    writeStringStorage(key, JSON.stringify(meta));
+}
+function getMiniProgramPagePath() {
+    const g = globalThis;
     try {
-        const sys = wxAny.getSystemInfoSync();
-        out.mpBrand = sys?.brand ? String(sys.brand) : '';
-        out.mpModel = sys?.model ? String(sys.model) : '';
-        out.mpSystem = sys?.system ? String(sys.system) : '';
-        out.mpPlatform = sys?.platform ? String(sys.platform) : '';
-        out.mpWeChatVersion = sys?.version ? String(sys.version) : '';
-        out.mpSDKVersion = sys?.SDKVersion ? String(sys.SDKVersion) : '';
-        out.mpScreenWidth = typeof sys?.screenWidth === 'number' ? sys.screenWidth : undefined;
-        out.mpScreenHeight = typeof sys?.screenHeight === 'number' ? sys.screenHeight : undefined;
-        out.mpPixelRatio = typeof sys?.pixelRatio === 'number' ? sys.pixelRatio : undefined;
-        out.language = sys?.language ? String(sys.language) : '';
+        const pages = typeof g.getCurrentPages === 'function' ? g.getCurrentPages() : [];
+        const last = Array.isArray(pages) ? pages[pages.length - 1] : undefined;
+        const route = (last?.route || last?.__route__);
+        if (typeof route !== 'string')
+            return '';
+        let path = route.startsWith('/') ? route : `/${route}`;
+        const options = last?.options || {};
+        const keys = Object.keys(options);
+        if (keys.length > 0) {
+            const qs = keys.map((k) => `${k}=${options[k]}`).join('&');
+            path = `${path}?${qs}`;
+        }
+        return path;
     }
     catch {
-        // ignore
-    }
-    if (options.includeNetworkType) {
-        try {
-            if (typeof wxAny.getNetworkTypeSync === 'function') {
-                const n = wxAny.getNetworkTypeSync();
-                out.networkType = n?.networkType ? String(n.networkType) : '';
-            }
-            else if (typeof wxAny.getNetworkType === 'function') {
-                // 异步更新：先不阻塞初始化
-                wxAny.getNetworkType({
-                    success: (res) => {
-                        try {
-                            const g = globalThis;
-                            if (!g.__beLinkClsLoggerDeviceInfo__)
-                                g.__beLinkClsLoggerDeviceInfo__ = {};
-                            g.__beLinkClsLoggerDeviceInfo__.networkType = res?.networkType ? String(res.networkType) : '';
-                        }
-                        catch {
-                            // ignore
-                        }
-                    },
-                });
-            }
-        }
-        catch {
-            // ignore
-        }
-        try {
-            if (typeof wxAny.onNetworkStatusChange === 'function') {
-                wxAny.onNetworkStatusChange((res) => {
-                    try {
-                        const g = globalThis;
-                        if (!g.__beLinkClsLoggerDeviceInfo__)
-                            g.__beLinkClsLoggerDeviceInfo__ = {};
-                        g.__beLinkClsLoggerDeviceInfo__.networkType = res?.networkType ? String(res.networkType) : '';
-                    }
-                    catch {
-                        // ignore
-                    }
-                });
-            }
-        }
-        catch {
-            // ignore
-        }
+        return '';
     }
-    return out;
 }
-function createAutoDeviceInfoBaseFields(envType, opts) {
-    const enabled = opts === undefined ? true : !!opts;
-    if (!enabled)
-        return null;
-    const raw = typeof opts === 'object' && opts ? opts : {};
-    const options = {
-        includeUserAgent: raw.includeUserAgent ?? true,
-        includeNetwork: raw.includeNetwork ?? true,
-        includeNetworkType: raw.includeNetworkType ?? true,
+function buildCommonUvFields(uvId, uvMeta, isFirstVisit) {
+    return {
+        uvId,
+        isFirstVisit,
+        firstVisitTs: uvMeta.firstVisitTs,
+        visitCount: uvMeta.visitCount,
     };
-    // 缓存：设备信息通常不频繁变化；网络类型可能异步更新，使用全局对象增量写入
-    let base = null;
-    const globalKey = '__beLinkClsLoggerDeviceInfo__';
-    return () => {
-        if (!base) {
-            base =
-                envType === 'miniprogram' || isMiniProgramEnv()
-                    ? getMiniProgramDeviceInfo(options)
-                    : getBrowserDeviceInfo(options);
+}
+function truncateText(s, maxLen) {
+    if (!s)
+        return '';
+    if (s.length <= maxLen)
+        return s;
+    return s.slice(0, maxLen);
+}
+function installMiniBehaviorMonitor(report, options = {}) {
+    const enableTrack = options.enableTrack ?? options.enabled ?? true;
+    if (!enableTrack)
+        return () => { };
+    const pvEnabled = options.pv ?? true;
+    const uvEnabled = options.uv ?? true;
+    const clickEnabled = options.click ?? true;
+    const pvReportType = options.pvReportType ?? 'pv';
+    const uvReportType = options.uvReportType ?? 'uv';
+    const clickReportType = options.clickReportType ?? 'click';
+    const uvIdStorageKey = options.uvIdStorageKey ?? 'cls_uv_id';
+    const uvMetaStorageKey = options.uvMetaStorageKey ?? 'cls_uv_meta';
+    const lastPagePathStorageKey = options.lastPagePathStorageKey ?? 'cls_last_page_path';
+    const uvExpireDaysRaw = options.trackOptions?.uvExpireDays ?? options.uvExpireDays ?? 30;
+    const uvExpireDays = Number.isFinite(uvExpireDaysRaw) ? Math.max(0, uvExpireDaysRaw) : 30;
+    const uvExpireMs = uvExpireDays * 24 * 60 * 60 * 1000;
+    const clickWhiteList = (options.trackOptions?.clickWhiteList ??
+        options.clickWhiteList ?? ['view', 'scroll-view']).map((s) => String(s).toLowerCase());
+    const clickMaxTextLength = options.clickMaxTextLength ?? 120;
+    const getPagePath = options.getPagePath ?? getMiniProgramPagePath;
+    let destroyed = false;
+    let firstVisitFlag = false;
+    let firstVisitConsumed = false;
+    const uvStatePromise = (async () => {
+        let existingUvId = readStringStorage(uvIdStorageKey);
+        let isFirstVisit = false;
+        const now = Date.now();
+        const metaBefore = safeReadUvMeta(uvMetaStorageKey);
+        const lastSeenForExpire = metaBefore.lastSeenTs ?? metaBefore.createdAtTs ?? metaBefore.firstVisitTs ?? now;
+        const expired = uvExpireMs > 0 && now - lastSeenForExpire > uvExpireMs;
+        if (expired) {
+            existingUvId = null;
+            writeUvMeta(uvMetaStorageKey, { firstVisitTs: now, visitCount: 0, createdAtTs: now, lastSeenTs: now });
+            writeStringStorage(uvIdStorageKey, '');
+        }
+        try {
+            if (options.getUvId) {
+                const maybe = options.getUvId();
+                const resolved = typeof maybe?.then === 'function' ? await maybe : maybe;
+                if (resolved && typeof resolved === 'string')
+                    existingUvId = resolved;
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        if (!existingUvId) {
+            const wxAny = globalThis.wx;
             try {
-                const g = globalThis;
-                if (!g[globalKey])
-                    g[globalKey] = { ...base };
+                const userInfo = wxAny?.getStorageSync?.('userInfo');
+                if (userInfo?.openid)
+                    existingUvId = String(userInfo.openid);
             }
             catch {
-                // ignore
+                /* ignore */
+            }
+            if (!existingUvId) {
+                try {
+                    const sys = wxAny?.getSystemInfoSync?.();
+                    const deviceId = sys?.deviceId ? String(sys.deviceId) : '';
+                    const model = sys?.model ? String(sys.model) : '';
+                    const system = sys?.system ? String(sys.system) : '';
+                    const base = [deviceId || model, system].filter(Boolean).join('_');
+                    if (base)
+                        existingUvId = `${base}_${Date.now()}`;
+                }
+                catch {
+                    /* ignore */
+                }
             }
         }
-        try {
-            const g = globalThis;
-            const extra = g[globalKey];
-            if (extra && isPlainObject(extra))
-                return { ...base, ...extra };
+        if (!existingUvId) {
+            existingUvId = generateUUID();
+            isFirstVisit = true;
         }
-        catch {
-            // ignore
+        writeStringStorage(uvIdStorageKey, existingUvId);
+        const meta = safeReadUvMeta(uvMetaStorageKey);
+        const createdAt = meta.createdAtTs ?? meta.firstVisitTs ?? now;
+        const firstVisit = meta.firstVisitTs || now;
+        const nextMeta = {
+            firstVisitTs: firstVisit,
+            visitCount: (meta.visitCount || 0) + 1,
+            createdAtTs: createdAt,
+            lastSeenTs: now,
+        };
+        if (isFirstVisit) {
+            nextMeta.firstVisitTs = now;
+            nextMeta.createdAtTs = now;
         }
-        return base;
-    };
-}
-
-function enterClsSendingGuard() {
+        writeUvMeta(uvMetaStorageKey, nextMeta);
+        firstVisitFlag = isFirstVisit;
+        return { uvId: existingUvId, isFirstVisit, meta: nextMeta };
+    })();
+    function safeReport(type, data) {
+        if (destroyed)
+            return;
+        if (!shouldSample(options.sampleRate))
+            return;
+        report(type, data);
+    }
+    function buildUvFieldsOnce(uvId, meta) {
+        const once = firstVisitFlag && !firstVisitConsumed;
+        if (once)
+            firstVisitConsumed = true;
+        return buildCommonUvFields(uvId, meta, once);
+    }
+    function reportPv(pagePath) {
+        if (!pvEnabled)
+            return;
+        void uvStatePromise.then(({ uvId, meta }) => {
+            if (destroyed)
+                return;
+            const payload = {
+                ...buildUvFieldsOnce(uvId, meta),
+                timestamp: Date.now(),
+                pagePath,
+                referrer: readStringStorage(lastPagePathStorageKey) || '',
+            };
+            writeStringStorage(lastPagePathStorageKey, pagePath);
+            safeReport(pvReportType, payload);
+        });
+    }
+    // MiniProgram Page Patch
+    let restoreMiniProgramPatch = null;
     const g = globalThis;
-    const next = (g.__beLinkClsLoggerSendingCount__ ?? 0) + 1;
-    g.__beLinkClsLoggerSendingCount__ = next;
+    const patchedKey = '__beLinkClsLoggerBehaviorPatched__';
+    if (!g[patchedKey]) {
+        g[patchedKey] = true;
+        const originalPage = typeof g.Page === 'function' ? g.Page : null;
+        if (originalPage) {
+            g.Page = function patchedPage(conf) {
+                const originalOnShow = conf?.onShow;
+                conf.onShow = function (...args) {
+                    if (pvEnabled) {
+                        const pagePath = getPagePath();
+                        if (pagePath?.length > 0)
+                            reportPv(pagePath);
+                    }
+                    return typeof originalOnShow === 'function' ? originalOnShow.apply(this, args) : undefined;
+                };
+                if (clickEnabled && conf && typeof conf === 'object') {
+                    for (const key of Object.keys(conf)) {
+                        const fn = conf[key];
+                        if (typeof fn !== 'function')
+                            continue;
+                        if (fn.__beLinkWrapped__)
+                            continue;
+                        conf[key] = function (...args) {
+                            try {
+                                const e = args?.[0];
+                                const type = e?.type;
+                                const currentTarget = e?.currentTarget;
+                                const dataset = currentTarget?.dataset;
+                                const isTap = type === 'tap' || type === 'click';
+                                if (isTap && currentTarget && dataset) {
+                                    const tagNameRaw = dataset?.tagName ?? dataset?.tag ?? currentTarget?.tagName ?? '';
+                                    const tagName = String(tagNameRaw || '').toLowerCase();
+                                    const trackId = dataset?.trackId ? String(dataset.trackId) : '';
+                                    if (!(clickWhiteList.includes(tagName) && !trackId)) {
+                                        const x = typeof e?.detail?.x === 'number' ? e.detail.x : (e?.touches?.[0]?.pageX ?? 0);
+                                        const y = typeof e?.detail?.y === 'number' ? e.detail.y : (e?.touches?.[0]?.pageY ?? 0);
+                                        void uvStatePromise.then(({ uvId, meta }) => {
+                                            if (destroyed)
+                                                return;
+                                            safeReport(clickReportType, {
+                                                ...buildUvFieldsOnce(uvId, meta),
+                                                timestamp: Date.now(),
+                                                pagePath: getPagePath(),
+                                                elementTag: tagNameRaw ? String(tagNameRaw) : '',
+                                                elementId: currentTarget?.id ? String(currentTarget.id) : '',
+                                                elementClass: dataset?.className ? stringifyLogValue(dataset.className) : '',
+                                                trackId,
+                                                elementText: dataset?.text ? truncateText(String(dataset.text), clickMaxTextLength) : '',
+                                                clickX: x,
+                                                clickY: y,
+                                            });
+                                        });
+                                    }
+                                }
+                            }
+                            catch {
+                                /* ignore */
+                            }
+                            return fn.apply(this, args);
+                        };
+                        conf[key].__beLinkWrapped__ = true;
+                    }
+                }
+                return originalPage(conf);
+            };
+            restoreMiniProgramPatch = () => {
+                g.Page = originalPage;
+                g[patchedKey] = false;
+            };
+        }
+    }
+    if (pvEnabled)
+        reportPv(getPagePath());
+    if (uvEnabled) {
+        void uvStatePromise.then(({ uvId, meta }) => {
+            if (destroyed)
+                return;
+            safeReport(uvReportType, {
+                ...buildUvFieldsOnce(uvId, meta),
+                timestamp: Date.now(),
+                pagePath: getPagePath(),
+            });
+        });
+    }
     return () => {
-        const cur = g.__beLinkClsLoggerSendingCount__ ?? 0;
-        g.__beLinkClsLoggerSendingCount__ = cur > 0 ? cur - 1 : 0;
+        destroyed = true;
+        restoreMiniProgramPatch?.();
     };
 }
-class ClsLogger {
-    constructor() {
-        this.client = null;
-        this.topicId = null;
-        this.endpoint = 'ap-shanghai.cls.tencentcs.com';
-        this.retryTimes = 10;
-        this.source = '127.0.0.1';
-        this.projectId = '';
-        this.projectName = '';
-        this.appId = '';
-        this.appVersion = '';
-        this.envType = 'browser';
-        this.userGenerateBaseFields = null;
-        this.autoGenerateBaseFields = null;
-        this.storageKey = 'beLink_logs';
-        this.batchSize = 15;
-        // 参考文档：内存队列批量发送（500ms 或 20 条触发）
-        this.memoryQueue = [];
-        this.batchMaxSize = 20;
-        this.batchIntervalMs = 500;
-        this.batchTimer = null;
-        this.batchTimerDueAt = null;
-        this.initTs = 0;
-        this.startupDelayMs = 0;
-        // 参考文档：失败缓存 + 重试
-        this.failedCacheKey = 'cls_failed_logs';
-        this.failedCacheMax = 200;
-        this.requestMonitorStarted = false;
-        this.errorMonitorStarted = false;
-        this.performanceMonitorStarted = false;
-        this.behaviorMonitorStarted = false;
-        this.behaviorMonitorCleanup = null;
+
+function installBehaviorMonitor(report, envType, options = {}) {
+    if (envType === 'miniprogram' || isMiniProgramEnv()) {
+        return installMiniBehaviorMonitor(report, options);
     }
-    init(options) {
-        this.initTs = Date.now();
-        const topicId = options?.tencentCloud?.topicID ?? options?.topic_id ?? options?.topicID ?? this.topicId ?? null;
-        const endpoint = options?.tencentCloud?.endpoint ?? options?.endpoint ?? this.endpoint;
-        const retryTimes = options?.tencentCloud?.retry_times ?? options?.retry_times ?? this.retryTimes;
-        const source = options?.tencentCloud?.source ?? options?.source ?? this.source;
-        if (!topicId) {
-            // eslint-disable-next-line no-console
-            console.warn('ClsLogger.init 没有传 topicID/topic_id');
-            return;
-        }
-        this.topicId = topicId;
-        this.endpoint = endpoint;
-        this.retryTimes = retryTimes;
-        this.source = source;
-        this.userId = options.userId ?? this.userId;
-        this.userName = options.userName ?? this.userName;
-        this.projectId = options.projectId ?? this.projectId;
-        this.projectName = options.projectName ?? this.projectName;
-        this.appId = options.appId ?? this.appId;
-        this.appVersion = options.appVersion ?? this.appVersion;
-        this.envType = options.envType ?? this.detectEnvType();
-        this.userGenerateBaseFields = options.generateBaseFields ?? this.userGenerateBaseFields;
-        this.autoGenerateBaseFields = createAutoDeviceInfoBaseFields(this.envType, options.deviceInfo);
-        this.storageKey = options.storageKey ?? this.storageKey;
-        this.batchSize = options.batchSize ?? this.batchSize;
-        this.batchMaxSize = options.batch?.maxSize ?? this.batchMaxSize;
-        this.batchIntervalMs = options.batch?.intervalMs ?? this.batchIntervalMs;
-        this.startupDelayMs = options.batch?.startupDelayMs ?? this.startupDelayMs;
-        this.failedCacheKey = options.failedCacheKey ?? this.failedCacheKey;
-        this.failedCacheMax = options.failedCacheMax ?? this.failedCacheMax;
-        // 预热 client
-        this.getInstance();
-        // 启动时尝试发送失败缓存
-        this.flushFailed();
-        // 初始化后立即启动请求监听
-        this.startRequestMonitor(options.requestMonitor);
-        // 初始化后立即启动错误监控/性能监控
-        this.startErrorMonitor(options.errorMonitor);
-        this.startPerformanceMonitor(options.performanceMonitor);
-        // 初始化后立即启动行为埋点（PV/UV/点击）
-        this.startBehaviorMonitor(options.behaviorMonitor);
+    return installWebBehaviorMonitor(report, options);
+}
+
+function truncate(s, maxLen) {
+    if (!s)
+        return s;
+    return s.length > maxLen ? `${s.slice(0, maxLen)}...` : s;
+}
+function parseUserAgent(uaRaw) {
+    const ua = uaRaw ?? '';
+    const isMobile = /Mobile|Android|iPhone|iPad|iPod/i.test(ua);
+    // OS
+    let osName = 'unknown';
+    let osVersion = '';
+    const ios = ua.match(/OS (\d+[_\d]*) like Mac OS X/i);
+    const android = ua.match(/Android (\d+(\.\d+)*)/i);
+    const mac = ua.match(/Mac OS X (\d+[_\d]*)/i);
+    const win = ua.match(/Windows NT (\d+(\.\d+)*)/i);
+    if (ios) {
+        osName = 'iOS';
+        osVersion = ios[1].replace(/_/g, '.');
     }
-    getBaseFields() {
-        let auto = undefined;
-        let user = undefined;
-        try {
-            const autoRaw = this.autoGenerateBaseFields ? this.autoGenerateBaseFields() : undefined;
-            if (autoRaw && isPlainObject(autoRaw))
-                auto = normalizeFlatFields(autoRaw, 'deviceInfo');
-        }
-        catch {
-            auto = undefined;
-        }
-        try {
-            const userRaw = this.userGenerateBaseFields ? this.userGenerateBaseFields() : undefined;
-            if (userRaw && isPlainObject(userRaw))
-                user = normalizeFlatFields({ ...userRaw, userId: this.userId, userName: this.userName }, 'generateBaseFields');
-        }
-        catch {
-            user = undefined;
-        }
-        if (auto && user)
-            return mergeFields(user, auto);
-        if (user)
-            return user;
-        if (auto)
-            return auto;
-        return undefined;
+    else if (android) {
+        osName = 'Android';
+        osVersion = android[1];
     }
-    startRequestMonitor(requestMonitor) {
-        if (this.requestMonitorStarted)
-            return;
-        // 默认开启；传 false 则关闭
-        const enabled = requestMonitor === undefined ? true : !!requestMonitor;
-        if (!enabled)
-            return;
-        const opts = typeof requestMonitor === 'object' && requestMonitor ? requestMonitor : {};
-        this.requestMonitorStarted = true;
-        installRequestMonitor((type, data) => {
-            this.track(type, data);
-        }, {
-            ...opts,
-            enabled: opts.enabled ?? true,
-            clsEndpoint: this.endpoint,
-        });
+    else if (win) {
+        osName = 'Windows';
+        osVersion = win[1];
+    }
+    else if (mac) {
+        osName = 'macOS';
+        osVersion = mac[1].replace(/_/g, '.');
+    }
+    // Browser
+    let browserName = 'unknown';
+    let browserVersion = '';
+    const edge = ua.match(/Edg\/(\d+(\.\d+)*)/);
+    const chrome = ua.match(/Chrome\/(\d+(\.\d+)*)/);
+    const safari = ua.match(/Version\/(\d+(\.\d+)*) Safari\//);
+    const firefox = ua.match(/Firefox\/(\d+(\.\d+)*)/);
+    if (edge) {
+        browserName = 'Edge';
+        browserVersion = edge[1];
     }
-    startErrorMonitor(errorMonitor) {
-        if (this.errorMonitorStarted)
-            return;
-        const enabled = errorMonitor === undefined ? true : !!errorMonitor;
-        if (!enabled)
-            return;
-        this.errorMonitorStarted = true;
-        installErrorMonitor((type, data) => this.track(type, data), errorMonitor);
+    else if (chrome) {
+        browserName = 'Chrome';
+        browserVersion = chrome[1];
     }
-    startPerformanceMonitor(performanceMonitor) {
-        if (this.performanceMonitorStarted)
-            return;
-        const enabled = performanceMonitor === undefined ? true : !!performanceMonitor;
-        if (!enabled)
-            return;
-        this.performanceMonitorStarted = true;
-        installPerformanceMonitor((type, data) => this.track(type, data), performanceMonitor);
+    else if (firefox) {
+        browserName = 'Firefox';
+        browserVersion = firefox[1];
     }
-    startBehaviorMonitor(behaviorMonitor) {
-        if (this.behaviorMonitorStarted)
-            return;
-        const enabled = behaviorMonitor === undefined ? true : !!behaviorMonitor;
-        if (!enabled)
-            return;
-        const opts = typeof behaviorMonitor === 'object' && behaviorMonitor
-            ? behaviorMonitor
-            : {};
-        this.behaviorMonitorStarted = true;
-        this.behaviorMonitorCleanup = installBehaviorMonitor((type, data) => {
-            this.track(type, data);
-        }, this.envType, {
-            ...opts,
-            enabled: opts.enabled ?? true,
-        });
+    else if (safari) {
+        browserName = 'Safari';
+        browserVersion = safari[1];
     }
-    /**
-     * 停止行为埋点监听（PV/UV/点击）
-     * - 如需重启：可再次调用 init（或自行调用 init 后的默认启动逻辑）
-     */
-    stopBehaviorMonitor() {
-        try {
-            this.behaviorMonitorCleanup?.();
-        }
-        catch {
-            // ignore
-        }
-        this.behaviorMonitorCleanup = null;
-        this.behaviorMonitorStarted = false;
+    return { browserName, browserVersion, osName, osVersion, isMobile };
+}
+function getBrowserDeviceInfo(options) {
+    const out = {
+        envType: 'browser',
+    };
+    if (typeof window === 'undefined' || typeof navigator === 'undefined')
+        return out;
+    const ua = String(navigator.userAgent ?? '');
+    const uaParsed = parseUserAgent(ua);
+    if (options.includeUserAgent)
+        out.ua = truncate(ua, 2000);
+    out.browserName = uaParsed.browserName;
+    out.browserVersion = uaParsed.browserVersion;
+    out.osName = uaParsed.osName;
+    out.osVersion = uaParsed.osVersion;
+    out.isMobile = uaParsed.isMobile ? 1 : 0;
+    out.language = String(navigator.language ?? '');
+    out.platform = String(navigator.platform ?? '');
+    try {
+        const tz = Intl.DateTimeFormat().resolvedOptions().timeZone;
+        out.timezone = typeof tz === 'string' ? tz : '';
     }
-    getInstance() {
-        if (this.client)
-            return this.client;
-        this.client = new AsyncClient({
-            endpoint: this.endpoint,
-            retry_times: this.retryTimes,
-        });
-        return this.client;
+    catch {
+        out.timezone = '';
     }
-    detectEnvType() {
-        const wxAny = globalThis.wx;
-        if (wxAny && typeof wxAny.getSystemInfoSync === 'function')
-            return 'miniprogram';
-        return 'browser';
+    try {
+        const s = window.screen;
+        out.screenWidth = s?.width ?? undefined;
+        out.screenHeight = s?.height ?? undefined;
     }
-    /**
-     * 直接上报：埋点入参必须是一维（扁平）Object
-     * - 非原始值（对象/数组等）会被自动 stringify 成 string
-     * - 最终会把 fields 展开成 CLS 的 content（key/value 都会转成 string）
-     */
-    put(fields, options = {}) {
-        if (!fields)
-            return;
-        if (!this.topicId) {
-            // eslint-disable-next-line no-console
-            console.warn('ClsLogger.put：未初始化 topic_id');
-            return;
-        }
-        const mergeBaseFields = options.mergeBaseFields ?? true;
-        const base = mergeBaseFields ? this.getBaseFields() : undefined;
-        const normalizedFields = normalizeFlatFields(fields, 'put');
-        const finalFields = mergeFields(base, {
-            projectId: this.projectId || undefined,
-            projectName: this.projectName || undefined,
-            envType: this.envType,
-            appId: this.appId || undefined,
-            appVersion: this.appVersion || undefined,
-            ...normalizedFields,
-        });
-        const client = this.getInstance();
-        const logGroup = new LogGroup('127.0.0.1');
-        logGroup.setSource(this.source);
-        const log = new Log(Date.now());
-        for (const key of Object.keys(finalFields)) {
-            log.addContent(key, stringifyLogValue(finalFields[key]));
-        }
-        logGroup.addLog(log);
-        const request = new PutLogsRequest(this.topicId, logGroup);
-        const exit = enterClsSendingGuard();
-        try {
-            client.PutLogs(request);
-        }
-        finally {
-            exit();
-        }
+    catch {
+        // ignore
     }
-    /**
-     * 直接上报：把 data 序列化后放入指定 key（默认 “日志内容”）
-     */
-    putJson(data, clsLoggerKey = '日志内容', options = {}) {
-        // put 的入参要求扁平；这里直接把数据序列化为 string
-        this.put({ [clsLoggerKey]: stringifyLogValue(data) }, options);
+    try {
+        out.dpr = typeof window.devicePixelRatio === 'number' ? window.devicePixelRatio : undefined;
     }
-    /**
-     * 入队：写入 localStorage 队列；达到 batchSize 自动 flush
-     * - 埋点入参必须是一维（扁平）Object，非原始值会被 stringify
-     */
-    enqueue(fields, options = {}) {
-        if (!fields)
-            return;
-        const time = Date.now();
-        const mergeBaseFields = options.mergeBaseFields ?? true;
-        const base = mergeBaseFields ? this.getBaseFields() : undefined;
-        const normalizedFields = normalizeFlatFields(fields, 'enqueue');
-        const finalFields = mergeFields(base, {
-            projectId: this.projectId || undefined,
-            projectName: this.projectName || undefined,
-            envType: this.envType,
-            appId: this.appId || undefined,
-            appVersion: this.appVersion || undefined,
-            ...normalizedFields,
-        });
-        const queue = readQueue(this.storageKey);
-        const next = [...queue, { time, data: finalFields }];
-        if (next.length < this.batchSize) {
-            writeQueue(this.storageKey, next);
-            return;
-        }
-        // 达到阈值：flush + 写入新的队列（避免并发下丢失，按“先 flush 旧的”策略）
-        this.putBatch(queue);
-        writeQueue(this.storageKey, [{ time, data: finalFields }]);
+    catch {
+        // ignore
     }
-    /**
-     * 从 localStorage 读取队列并批量上报
-     */
-    flush() {
-        const queue = readQueue(this.storageKey);
-        if (queue.length === 0)
-            return;
-        this.putBatch(queue);
-        writeQueue(this.storageKey, []);
+    try {
+        const navAny = navigator;
+        out.hardwareConcurrency = typeof navAny.hardwareConcurrency === 'number' ? navAny.hardwareConcurrency : undefined;
+        out.deviceMemory = typeof navAny.deviceMemory === 'number' ? navAny.deviceMemory : undefined;
     }
-    /**
-     * 批量上报（每条 item.data 展开为 log content）
-     */
-    putBatch(queue) {
-        if (!queue || queue.length === 0)
-            return;
-        if (!this.topicId) {
-            // eslint-disable-next-line no-console
-            console.warn('ClsLogger.putBatch：未初始化 topic_id');
-            return;
-        }
-        const client = this.getInstance();
-        const logGroup = new LogGroup('127.0.0.1');
-        logGroup.setSource(this.source);
-        for (const item of queue) {
-            const log = new Log(item.time);
-            const data = item.data ?? {};
-            for (const key of Object.keys(data)) {
-                log.addContent(key, stringifyLogValue(data[key]));
-            }
-            logGroup.addLog(log);
-        }
-        if (logGroup.getLogs().length === 0)
-            return;
-        const request = new PutLogsRequest(this.topicId, logGroup);
-        const exit = enterClsSendingGuard();
+    catch {
+        // ignore
+    }
+    if (options.includeNetwork) {
         try {
-            client.PutLogs(request);
+            const conn = navigator.connection || navigator.mozConnection || navigator.webkitConnection;
+            if (conn && isPlainObject(conn)) {
+                if (typeof conn.effectiveType === 'string')
+                    out.netEffectiveType = conn.effectiveType;
+                if (typeof conn.downlink === 'number')
+                    out.netDownlink = conn.downlink;
+                if (typeof conn.rtt === 'number')
+                    out.netRtt = conn.rtt;
+                if (typeof conn.saveData === 'boolean')
+                    out.netSaveData = conn.saveData ? 1 : 0;
+            }
         }
-        finally {
-            exit();
+        catch {
+            // ignore
         }
     }
-    /**
-     * 参考《一、概述》：统一上报入口（内存队列 + 批量发送）
-     */
-    report(log) {
-        if (!log?.type)
-            return;
-        if (!this.topicId) {
-            // eslint-disable-next-line no-console
-            console.warn('ClsLogger.report：未初始化 topicID/topic_id');
-            return;
-        }
-        this.memoryQueue.push(log);
-        if (this.memoryQueue.length >= this.batchMaxSize) {
-            void this.flushBatch();
-            return;
-        }
-        const now = Date.now();
-        const desiredDueAt = this.getDesiredBatchFlushDueAt(now);
-        const desiredDelay = Math.max(0, desiredDueAt - now);
-        if (!this.batchTimer) {
-            this.batchTimerDueAt = desiredDueAt;
-            this.batchTimer = setTimeout(() => {
-                void this.flushBatch();
-            }, desiredDelay);
-            return;
-        }
-        // 启动合并窗口内：如果当前 timer 会“更早”触发，则延后到窗口结束，尽量减少多次发送
-        if (this.batchTimerDueAt !== null && this.batchTimerDueAt < desiredDueAt) {
+    return out;
+}
+function createWebDeviceInfoBaseFields(opts) {
+    const enabled = opts === undefined ? true : !!opts;
+    if (!enabled)
+        return null;
+    const raw = typeof opts === 'object' && opts ? opts : {};
+    const options = {
+        includeUserAgent: raw.includeUserAgent ?? true,
+        includeNetwork: raw.includeNetwork ?? true,
+        includeNetworkType: raw.includeNetworkType ?? true,
+    };
+    let base = null;
+    const globalKey = '__beLinkClsLoggerDeviceInfo__';
+    return () => {
+        if (!base) {
+            base = getBrowserDeviceInfo(options);
             try {
-                clearTimeout(this.batchTimer);
+                const g = globalThis;
+                if (!g[globalKey])
+                    g[globalKey] = { ...base };
             }
             catch {
                 // ignore
             }
-            this.batchTimerDueAt = desiredDueAt;
-            this.batchTimer = setTimeout(() => {
-                void this.flushBatch();
-            }, desiredDelay);
-        }
-    }
-    getDesiredBatchFlushDueAt(nowTs) {
-        const start = this.initTs || nowTs;
-        const startupDelay = Number.isFinite(this.startupDelayMs) ? Math.max(0, this.startupDelayMs) : 0;
-        if (startupDelay > 0) {
-            const end = start + startupDelay;
-            if (nowTs < end)
-                return end;
-        }
-        return nowTs + this.batchIntervalMs;
-    }
-    info(message, data = {}) {
-        const payload = normalizeFlatFields({ message, ...data }, 'info');
-        this.report({ type: 'info', data: payload, timestamp: Date.now() });
-    }
-    warn(message, data = {}) {
-        const payload = normalizeFlatFields({ message, ...data }, 'warn');
-        this.report({ type: 'warn', data: payload, timestamp: Date.now() });
-    }
-    error(message, data = {}) {
-        const payload = normalizeFlatFields({ message, ...data }, 'error');
-        this.report({ type: 'error', data: payload, timestamp: Date.now() });
-    }
-    track(trackType, data = {}) {
-        if (!trackType)
-            return;
-        this.report({
-            type: trackType,
-            data: normalizeFlatFields(data, `track:${trackType}`),
-            timestamp: Date.now(),
-        });
-    }
-    /**
-     * 立即发送内存队列
-     */
-    async flushBatch() {
-        if (this.batchTimer) {
-            clearTimeout(this.batchTimer);
-            this.batchTimer = null;
         }
-        this.batchTimerDueAt = null;
-        if (this.memoryQueue.length === 0)
-            return;
-        const logs = [...this.memoryQueue];
-        this.memoryQueue = [];
         try {
-            await this.sendReportLogs(logs);
+            const g = globalThis;
+            const extra = g[globalKey];
+            if (extra && isPlainObject(extra))
+                return { ...base, ...extra };
         }
         catch {
-            this.retrySendReportLogs(logs, 1);
+            // ignore
         }
+        return base;
+    };
+}
+
+function getMiniProgramDeviceInfo(options) {
+    const out = {
+        envType: 'miniprogram',
+    };
+    const wxAny = globalThis.wx;
+    if (!wxAny || typeof wxAny.getSystemInfoSync !== 'function')
+        return out;
+    try {
+        const sys = wxAny.getSystemInfoSync();
+        out.mpBrand = sys?.brand ? String(sys.brand) : '';
+        out.mpModel = sys?.model ? String(sys.model) : '';
+        out.mpSystem = sys?.system ? String(sys.system) : '';
+        out.mpPlatform = sys?.platform ? String(sys.platform) : '';
+        out.mpWeChatVersion = sys?.version ? String(sys.version) : '';
+        out.mpSDKVersion = sys?.SDKVersion ? String(sys.SDKVersion) : '';
+        out.mpScreenWidth = typeof sys?.screenWidth === 'number' ? sys.screenWidth : undefined;
+        out.mpScreenHeight = typeof sys?.screenHeight === 'number' ? sys.screenHeight : undefined;
+        out.mpPixelRatio = typeof sys?.pixelRatio === 'number' ? sys.pixelRatio : undefined;
+        out.language = sys?.language ? String(sys.language) : '';
     }
-    buildReportFields(log) {
-        const ts = log.timestamp ?? Date.now();
-        const base = this.getBaseFields();
-        const data = normalizeFlatFields(log.data ?? {}, 'report:data');
-        const mergedData = mergeFields(base, data);
-        return {
-            timestamp: ts,
-            type: log.type,
-            envType: this.envType,
-            projectId: this.projectId || undefined,
-            projectName: this.projectName || undefined,
-            appId: this.appId || undefined,
-            appVersion: this.appVersion || undefined,
-            // 保证“一维字段”：业务数据以 JSON 字符串形式落到 CLS
-            ...mergedData,
-        };
+    catch {
+        // ignore
     }
-    async sendReportLogs(logs) {
-        if (!this.topicId)
-            return;
-        const client = this.getInstance();
-        const logGroup = new LogGroup('127.0.0.1');
-        logGroup.setSource(this.source);
-        for (const item of logs) {
-            const fields = this.buildReportFields(item);
-            const log = new Log(fields.timestamp);
-            for (const key of Object.keys(fields)) {
-                if (key === 'timestamp')
-                    continue;
-                log.addContent(key, stringifyLogValue(fields[key]));
+    if (options.includeNetworkType) {
+        try {
+            if (typeof wxAny.getNetworkTypeSync === 'function') {
+                const n = wxAny.getNetworkTypeSync();
+                out.networkType = n?.networkType ? String(n.networkType) : '';
+            }
+            else if (typeof wxAny.getNetworkType === 'function') {
+                // 异步更新：先不阻塞初始化
+                wxAny.getNetworkType({
+                    success: (res) => {
+                        try {
+                            const g = globalThis;
+                            if (!g.__beLinkClsLoggerDeviceInfo__)
+                                g.__beLinkClsLoggerDeviceInfo__ = {};
+                            g.__beLinkClsLoggerDeviceInfo__.networkType = res?.networkType ? String(res.networkType) : '';
+                        }
+                        catch {
+                            // ignore
+                        }
+                    },
+                });
             }
-            logGroup.addLog(log);
         }
-        const request = new PutLogsRequest(this.topicId, logGroup);
-        // 只在“发起网络请求”的同步阶段打标记，避免 requestMonitor 监控 CLS 上报请求导致递归
-        const exit = enterClsSendingGuard();
-        let p;
+        catch {
+            // ignore
+        }
         try {
-            p = client.PutLogs(request);
+            if (typeof wxAny.onNetworkStatusChange === 'function') {
+                wxAny.onNetworkStatusChange((res) => {
+                    try {
+                        const g = globalThis;
+                        if (!g.__beLinkClsLoggerDeviceInfo__)
+                            g.__beLinkClsLoggerDeviceInfo__ = {};
+                        g.__beLinkClsLoggerDeviceInfo__.networkType = res?.networkType ? String(res.networkType) : '';
+                    }
+                    catch {
+                        // ignore
+                    }
+                });
+            }
         }
-        finally {
-            exit();
+        catch {
+            // ignore
         }
-        await p;
     }
-    retrySendReportLogs(logs, retryCount) {
-        if (retryCount > this.retryTimes) {
-            this.cacheFailedReportLogs(logs);
-            return;
-        }
-        const delayMs = Math.pow(2, retryCount) * 1000;
-        setTimeout(async () => {
+    return out;
+}
+function createMiniDeviceInfoBaseFields(opts) {
+    const enabled = opts === undefined ? true : !!opts;
+    if (!enabled)
+        return null;
+    const raw = typeof opts === 'object' && opts ? opts : {};
+    const options = {
+        includeUserAgent: raw.includeUserAgent ?? true,
+        includeNetwork: raw.includeNetwork ?? true,
+        includeNetworkType: raw.includeNetworkType ?? true,
+    };
+    let base = null;
+    const globalKey = '__beLinkClsLoggerDeviceInfo__';
+    return () => {
+        if (!base) {
+            base = getMiniProgramDeviceInfo(options);
             try {
-                await this.sendReportLogs(logs);
+                const g = globalThis;
+                if (!g[globalKey])
+                    g[globalKey] = { ...base };
             }
             catch {
-                this.retrySendReportLogs(logs, retryCount + 1);
+                // ignore
             }
-        }, delayMs);
-    }
-    cacheFailedReportLogs(logs) {
-        const raw = readStringStorage(this.failedCacheKey);
-        let current = [];
+        }
         try {
-            const parsed = raw ? JSON.parse(raw) : [];
-            current = Array.isArray(parsed) ? parsed : [];
+            const g = globalThis;
+            const extra = g[globalKey];
+            if (extra && isPlainObject(extra))
+                return { ...base, ...extra };
         }
         catch {
-            current = [];
+            // ignore
         }
-        const next = [...current, ...logs].slice(-this.failedCacheMax);
-        writeStringStorage(this.failedCacheKey, JSON.stringify(next));
+        return base;
+    };
+}
+
+function createAutoDeviceInfoBaseFields(envType, opts) {
+    if (envType === 'miniprogram' || isMiniProgramEnv()) {
+        return createMiniDeviceInfoBaseFields(opts);
     }
-    flushFailed() {
-        const raw = readStringStorage(this.failedCacheKey);
-        if (!raw)
-            return;
-        let logs = [];
+    return createWebDeviceInfoBaseFields(opts);
+}
+
+/**
+ * 兼容版 ClsLogger（默认入口）
+ * - 保留了自动识别环境 + 动态 import 的逻辑
+ * - 如果业务想瘦身，建议改用 @be-link/cls-logger/web 或 /mini
+ */
+class ClsLogger extends ClsLoggerCore {
+    async loadSdk() {
+        if (this.sdk)
+            return this.sdk;
+        if (this.sdkPromise)
+            return this.sdkPromise;
+        const normalizeSdk = (m) => {
+            const mod = (m?.default && m.default.AsyncClient ? m.default : m);
+            if (mod?.AsyncClient && mod?.Log && mod?.LogGroup && mod?.PutLogsRequest) {
+                return {
+                    AsyncClient: mod.AsyncClient,
+                    Log: mod.Log,
+                    LogGroup: mod.LogGroup,
+                    PutLogsRequest: mod.PutLogsRequest,
+                };
+            }
+            return null;
+        };
+        // 1) 外部注入的 loader（最高优先级）
+        if (this.sdkLoaderOverride) {
+            try {
+                const loaded = await this.sdkLoaderOverride();
+                const sdk = normalizeSdk(loaded);
+                if (sdk) {
+                    this.sdk = sdk;
+                    return sdk;
+                }
+            }
+            catch {
+                // ignore and fallback
+            }
+        }
+        // 2) 外部直接注入的 sdk
+        if (this.sdkOverride) {
+            const sdk = normalizeSdk(this.sdkOverride);
+            if (sdk) {
+                this.sdk = sdk;
+                return sdk;
+            }
+        }
+        const isMini = this.envType === 'miniprogram';
+        // 3) 尝试使用 tryRequire / 全局变量
+        if (isMini) {
+            const reqMod = tryRequire('tencentcloud-cls-sdk-js-mini');
+            const reqSdk = normalizeSdk(reqMod);
+            if (reqSdk) {
+                this.sdk = reqSdk;
+                return reqSdk;
+            }
+        }
+        else {
+            // Web: 优先读全局变量 (UMD)
+            const g = readGlobal('tencentcloudClsSdkJsWeb');
+            const sdk = normalizeSdk(g);
+            if (sdk) {
+                this.sdk = sdk;
+                return sdk;
+            }
+            // Web: 尝试 require
+            const reqMod = tryRequire('tencentcloud-cls-sdk-js-web');
+            const reqSdk = normalizeSdk(reqMod);
+            if (reqSdk) {
+                this.sdk = reqSdk;
+                return reqSdk;
+            }
+        }
+        // 4) 动态导入（兜底方案）
+        // 注意：在某些严格的小程序 ESM 环境下，动态 import 可能失效
         try {
-            const parsed = JSON.parse(raw);
-            logs = Array.isArray(parsed) ? parsed : [];
+            if (isMini) {
+                const m = await import(/* @vite-ignore */ 'tencentcloud-cls-sdk-js-mini');
+                const sdk = normalizeSdk(m);
+                if (sdk) {
+                    this.sdk = sdk;
+                    return sdk;
+                }
+            }
+            else {
+                const m = await import(/* @vite-ignore */ 'tencentcloud-cls-sdk-js-web');
+                const sdk = normalizeSdk(m);
+                if (sdk) {
+                    this.sdk = sdk;
+                    return sdk;
+                }
+            }
         }
         catch {
-            logs = [];
+            // ignore
         }
-        if (logs.length === 0)
-            return;
-        // 先清空，再尝试发送
-        writeStringStorage(this.failedCacheKey, JSON.stringify([]));
-        this.memoryQueue.unshift(...logs);
-        void this.flushBatch();
+        // 5) 最终失败警告
+        console.warn(`[ClsLogger] SDK "${isMini ? 'tencentcloud-cls-sdk-js-mini' : 'tencentcloud-cls-sdk-js-web'}" not found. Logging will be disabled.`);
+        throw new Error('SDK not found');
     }
-    /**
-     * 统计/计数类日志：按字段展开上报（若 data 为空默认 1）
-     */
-    stat(param) {
-        if (!param)
-            return;
-        const payload = normalizeFlatFields({
-            pagePath: typeof window !== 'undefined' ? window.location?.pathname : '',
-            projectId: this.projectId,
-            projectName: this.projectName,
-            ...param,
-            data: param.data ?? 1,
-        }, 'stat');
-        this.report({ type: 'stat', data: payload, timestamp: Date.now() });
+    installRequestMonitor(report, options) {
+        installRequestMonitor(report, options);
+    }
+    installErrorMonitor(report, options) {
+        installErrorMonitor(report, options);
+    }
+    installPerformanceMonitor(report, options) {
+        installPerformanceMonitor(report, options);
+    }
+    installBehaviorMonitor(report, options) {
+        return installBehaviorMonitor(report, this.envType, typeof options === 'boolean' ? {} : options);
+    }
+    createDeviceInfoBaseFields(options) {
+        return createAutoDeviceInfoBaseFields(this.envType, options);
     }
 }