@be-link/cls-logger 1.0.1-beta.12 → 1.0.1-beta.14

package/dist/index.umd.js

@@ -137,156 +137,827 @@
         }
     }
 
-    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 = null;
+            this.endpoint = 'ap-shanghai.cls.tencentcs.com';
+            this.retryTimes = 10;
+            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.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';
             }
-            try {
-                if (rule.test(url))
-                    return true;
+            return 'browser';
+        }
+        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;
             }
-            catch {
-                // ignore invalid regex
+            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.failedCacheKey = options.failedCacheKey ?? this.failedCacheKey;
+            this.failedCacheMax = options.failedCacheMax ?? this.failedCacheMax;
+            // 预热（避免首条日志触发 import/初始化开销）
+            void this.getInstance().catch(() => {
+                // ignore
+            });
+            if (this.enabled) {
+                // 启动时尝试发送失败缓存
+                this.flushFailed();
+                // 初始化后立即启动请求监听
+                this.startRequestMonitor(options.requestMonitor);
+                // 初始化后立即启动错误监控/性能监控
+                this.startErrorMonitor(options.errorMonitor);
+                this.startPerformanceMonitor(options.performanceMonitor);
+                // 初始化后立即启动行为埋点（PV/UV/点击）
+                this.startBehaviorMonitor(options.behaviorMonitor);
             }
         }
-        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();
+        getBaseFields() {
+            let auto = undefined;
+            let user = undefined;
             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 autoRaw = this.autoGenerateBaseFields ? this.autoGenerateBaseFields() : undefined;
+                if (autoRaw && isPlainObject(autoRaw))
+                    auto = normalizeFlatFields(autoRaw, 'deviceInfo');
             }
             catch {
-                // ignore
+                auto = undefined;
             }
-            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({
-                    url: absUrl,
-                    method,
-                    query,
-                    body,
-                    startTime: startTs,
-                    duration,
-                    status,
-                    success: ok,
-                    options,
-                });
-                if (payload)
-                    report(options.reportType, payload);
-                return res;
+                const userRaw = this.userGenerateBaseFields ? this.userGenerateBaseFields() : undefined;
+                if (userRaw && isPlainObject(userRaw))
+                    user = normalizeFlatFields({ ...userRaw }, 'generateBaseFields');
             }
-            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;
+            catch {
+                user = undefined;
             }
-        };
+            if (auto && user)
+                return mergeFields(user, auto);
+            if (user)
+                return user;
+            if (auto)
+                return auto;
+            return undefined;
+        }
+        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.batchTimer = setTimeout(() => {
+                    void this.flushBatch();
+                }, desiredDelay);
+                return;
+            }
+            // 启动合并窗口内：如果当前 timer 会“更早”触发，则延后到窗口结束，尽量减少多次发送
+            if (this.batchTimerDueAt !== null && this.batchTimerDueAt < desiredDueAt) {
+                try {
+                    clearTimeout(this.batchTimer);
+                }
+                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 = {}) {
+            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');
+            this.report({ type: 'info', data: payload, timestamp: Date.now() });
+        }
+        warn(message, data = {}) {
+            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');
+            this.report({ type: 'warn', data: payload, timestamp: Date.now() });
+        }
+        error(message, data = {}) {
+            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');
+            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);
+            }
+            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')
@@ -335,7 +1006,7 @@
                         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,
@@ -352,171 +1023,36 @@
                     }
                     catch {
                         // ignore
-                    }
-                };
-                // 避免重复绑定
-                if (!this.__beLinkClsLoggerBound__) {
-                    this.__beLinkClsLoggerBound__ = true;
-                    this.addEventListener('loadend', () => {
-                        try {
-                            const status = typeof this.status === 'number' ? this.status : 0;
-                            onDone(status >= 200 && status < 400);
-                        }
-                        catch {
-                            onDone(true);
-                        }
-                    });
-                    this.addEventListener('error', (e) => onDone(false, e));
-                    this.addEventListener('timeout', () => onDone(false, 'timeout'));
-                    this.addEventListener('abort', () => onDone(false, 'abort'));
-                }
-            }
-            catch {
-                // ignore
-            }
-            return rawSend.apply(this, args);
-        };
-    }
-    function installMiniProgramWxRequest(report, options) {
-        const wxAny = globalThis.wx;
-        if (!wxAny || typeof wxAny.request !== 'function')
-            return;
-        if (wxAny.__beLinkClsLoggerWxRequestInstalled__)
-            return;
-        wxAny.__beLinkClsLoggerWxRequestInstalled__ = true;
-        const rawRequest = wxAny.request.bind(wxAny);
-        wxAny.request = (reqOptions) => {
-            const startTs = Date.now();
-            try {
-                const url = String(reqOptions?.url ?? '');
-                const method = String(reqOptions?.method ?? 'GET');
-                const data = reqOptions?.data;
-                const wrapCb = (cb, success) => {
-                    return (res) => {
-                        try {
-                            const duration = Date.now() - startTs;
-                            const status = typeof res?.statusCode === 'number'
-                                ? res.statusCode
-                                : typeof res?.status === 'number'
-                                    ? res.status
-                                    : undefined;
-                            const payload = buildPayload({
-                                url,
-                                method,
-                                query: '',
-                                body: data,
-                                startTime: startTs,
-                                duration,
-                                status,
-                                success,
-                                error: success ? undefined : res,
-                                options,
-                            });
-                            if (payload)
-                                report(options.reportType, payload);
-                        }
-                        catch {
-                            // ignore
-                        }
-                        if (typeof cb === 'function')
-                            return cb(res);
-                        return undefined;
-                    };
-                };
-                const next = { ...(reqOptions ?? {}) };
-                next.success = wrapCb(next.success, true);
-                next.fail = wrapCb(next.fail, false);
-                return rawRequest(next);
-            }
-            catch {
-                // ignore
-            }
-            return rawRequest(reqOptions);
-        };
-    }
-    function installMiniProgramWxCloudCallFunction(report, options) {
-        const wxAny = globalThis.wx;
-        const cloud = wxAny?.cloud;
-        if (!cloud || typeof cloud.callFunction !== 'function')
-            return;
-        if (cloud.__beLinkClsLoggerWxCloudCallFunctionInstalled__)
-            return;
-        cloud.__beLinkClsLoggerWxCloudCallFunctionInstalled__ = true;
-        const rawCallFunction = cloud.callFunction.bind(cloud);
-        cloud.callFunction = (callOptions) => {
-            const startTs = Date.now();
-            const name = (() => {
-                try {
-                    return String(callOptions?.name ?? '');
-                }
-                catch {
-                    return '';
-                }
-            })();
-            const data = callOptions?.data;
-            let reported = false;
-            const onDone = (success, err) => {
-                if (reported)
-                    return;
-                reported = true;
-                try {
-                    const duration = Date.now() - startTs;
-                    const payload = buildPayload({
-                        // 统一走 url 字段，便于和 http 一起检索/聚合
-                        url: `cloud.callFunction/${name || 'unknown'}`,
-                        method: 'callFunction',
-                        query: '',
-                        body: data,
-                        startTime: startTs,
-                        duration,
-                        success,
-                        error: success ? undefined : err,
-                        options,
-                    });
-                    if (payload) {
-                        payload.requestType = 'cloud-function';
-                        payload.name = name || 'unknown';
-                        report(options.reportType, payload);
-                    }
-                }
-                catch {
-                    // ignore
-                }
-            };
-            try {
-                const next = { ...(callOptions ?? {}) };
-                const rawSuccess = next.success;
-                const rawFail = next.fail;
-                next.success = (res) => {
-                    onDone(true);
-                    if (typeof rawSuccess === 'function')
-                        return rawSuccess(res);
-                    return undefined;
-                };
-                next.fail = (err) => {
-                    onDone(false, err?.message ?? err);
-                    if (typeof rawFail === 'function')
-                        return rawFail(err);
-                    return undefined;
-                };
-                const ret = rawCallFunction(next);
-                // 兼容 Promise 风格（有些版本/写法不传 success/fail）
-                if (ret && typeof ret.then === 'function') {
-                    ret.then(() => onDone(true), (err) => onDone(false, err?.message ?? err));
+                    }
+                };
+                // 避免重复绑定
+                if (!this.__beLinkClsLoggerBound__) {
+                    this.__beLinkClsLoggerBound__ = true;
+                    this.addEventListener('loadend', () => {
+                        try {
+                            const status = typeof this.status === 'number' ? this.status : 0;
+                            onDone(status >= 200 && status < 400);
+                        }
+                        catch {
+                            onDone(true);
+                        }
+                    });
+                    this.addEventListener('error', (e) => onDone(false, e));
+                    this.addEventListener('timeout', () => onDone(false, 'timeout'));
+                    this.addEventListener('abort', () => onDone(false, 'abort'));
                 }
-                return ret;
             }
-            catch (err) {
-                onDone(false, err);
-                throw err;
+            catch {
+                // ignore
             }
+            return rawSend.apply(this, args);
         };
     }
-    function installRequestMonitor(report, opts = {}) {
+    function installWebRequestMonitor(report, opts = {}) {
         const enabled = opts.enabled ?? true;
         if (!enabled)
             return;
-        const ignoreUrls = [...DEFAULT_IGNORE$1, ...(opts.ignoreUrls ?? [])];
+        const ignoreUrls = [...DEFAULT_IGNORE$2, ...(opts.ignoreUrls ?? [])];
         if (opts.clsEndpoint)
             ignoreUrls.push(opts.clsEndpoint);
         const options = {
@@ -530,2002 +1066,1821 @@
             maxParamLength: opts.maxParamLength ?? 2000,
             clsEndpoint: opts.clsEndpoint ?? '',
         };
-        if (isMiniProgramEnv()) {
-            installMiniProgramWxRequest(report, options);
-            installMiniProgramWxCloudCallFunction(report, options);
-            return;
-        }
         installBrowserFetch(report, options);
         installBrowserXhr(report, options);
     }
 
-    const DEFAULT_MAX_TEXT = 4000;
-    const DEFAULT_DEDUPE_WINDOW_MS = 3000;
-    const DEFAULT_DEDUPE_MAX_KEYS = 200;
-    function truncate$2(s, maxLen) {
-        if (!s)
-            return s;
-        return s.length > maxLen ? `${s.slice(0, maxLen)}...` : s;
+    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$1(sampleRate) {
+    function sampleHit$4(sampleRate) {
         if (sampleRate >= 1)
             return true;
         if (sampleRate <= 0)
             return false;
         return Math.random() < sampleRate;
     }
-    function getPagePath$1() {
-        try {
-            if (typeof window === 'undefined')
-                return '';
-            return window.location?.pathname ?? '';
-        }
-        catch {
-            return '';
-        }
-    }
-    function getMpPagePath() {
-        try {
-            const pages = globalThis.getCurrentPages?.();
-            if (Array.isArray(pages) && pages.length > 0) {
-                const page = pages[pages.length - 1];
-                return page.route || page.__route__ || '';
-            }
-            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) {
-            // refresh insertion order
-            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 truncate$4(s, maxLen) {
+        if (!s)
+            return s;
+        return s.length > maxLen ? `${s.slice(0, maxLen)}...` : s;
     }
-    function buildErrorKey(type, payload) {
-        // 使用最核心、最稳定的字段构造签名，避免把瞬态字段（如 time）带入导致失效
-        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 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 installBrowserErrorMonitor(report, options) {
-        if (typeof window === 'undefined')
+    function installMiniProgramWxRequest(report, options) {
+        const wxAny = globalThis.wx;
+        if (!wxAny || typeof wxAny.request !== 'function')
             return;
-        const w = window;
-        if (w.__beLinkClsLoggerErrorInstalled__)
+        if (wxAny.__beLinkClsLoggerWxRequestInstalled__)
             return;
-        w.__beLinkClsLoggerErrorInstalled__ = true;
-        const shouldReport = createDedupeGuard(options);
-        window.addEventListener('error', (event) => {
-            try {
-                if (!sampleHit$1(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.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);
-                        if (e.name)
-                            payload.errorName = e.name;
-                        if (e.stack)
-                            payload.stack = e.stack;
-                    }
-                    if (!shouldReport(buildErrorKey(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);
-                    if (!shouldReport(buildErrorKey(options.reportType, payload)))
-                        return;
-                    report(options.reportType, payload);
-                }
-            }
-            catch {
-                // ignore
-            }
-        }, true);
-        window.addEventListener('unhandledrejection', (event) => {
+        wxAny.__beLinkClsLoggerWxRequestInstalled__ = true;
+        const rawRequest = wxAny.request.bind(wxAny);
+        wxAny.request = (reqOptions) => {
+            const startTs = Date.now();
             try {
-                if (!sampleHit$1(options.sampleRate))
-                    return;
-                const reason = event?.reason;
-                const e = normalizeErrorLike(reason, options.maxTextLength);
-                const payload = {
-                    pagePath: getPagePath$1(),
-                    source: 'unhandledrejection',
-                    message: e.message,
-                    errorName: e.name,
-                    stack: e.stack,
+                const url = String(reqOptions?.url ?? '');
+                const method = String(reqOptions?.method ?? 'GET');
+                const data = reqOptions?.data;
+                const wrapCb = (cb, success) => {
+                    return (res) => {
+                        try {
+                            const duration = Date.now() - startTs;
+                            const status = typeof res?.statusCode === 'number'
+                                ? res.statusCode
+                                : typeof res?.status === 'number'
+                                    ? res.status
+                                    : undefined;
+                            const payload = buildPayload({
+                                url,
+                                method,
+                                query: '',
+                                body: data,
+                                startTime: startTs,
+                                duration,
+                                status,
+                                success,
+                                error: success ? undefined : res,
+                                options,
+                            });
+                            if (payload)
+                                report(options.reportType, payload);
+                        }
+                        catch {
+                            // ignore
+                        }
+                        if (typeof cb === 'function')
+                            return cb(res);
+                        return undefined;
+                    };
                 };
-                if (!shouldReport(buildErrorKey(options.reportType, payload)))
-                    return;
-                report(options.reportType, payload);
+                const next = { ...(reqOptions ?? {}) };
+                next.success = wrapCb(next.success, true);
+                next.fail = wrapCb(next.fail, false);
+                return rawRequest(next);
             }
             catch {
                 // ignore
             }
-        });
+            return rawRequest(reqOptions);
+        };
     }
-    function installMiniProgramErrorMonitor(report, options) {
-        const g = globalThis;
-        if (g.__beLinkClsLoggerMpErrorInstalled__)
-            return;
-        g.__beLinkClsLoggerMpErrorInstalled__ = true;
-        const shouldReport = createDedupeGuard(options);
+    function installMiniProgramWxCloudCallFunction(report, options) {
         const wxAny = globalThis.wx;
-        // wx.* 事件（兼容在 App 已经创建后的场景）
-        try {
-            if (wxAny && typeof wxAny.onError === 'function') {
-                wxAny.onError((msg) => {
-                    try {
-                        if (!sampleHit$1(options.sampleRate))
-                            return;
-                        const e = normalizeErrorLike(msg, options.maxTextLength);
-                        const payload = {
-                            pagePath: getMpPagePath(),
-                            source: 'wx.onError',
-                            message: e.message,
-                            errorName: e.name,
-                            stack: e.stack,
-                        };
-                        if (!shouldReport(buildErrorKey(options.reportType, payload)))
-                            return;
-                        report(options.reportType, payload);
-                    }
-                    catch {
-                        // ignore
-                    }
-                });
-            }
-        }
-        catch {
-            // ignore
-        }
-        try {
-            if (wxAny && typeof wxAny.onUnhandledRejection === 'function') {
-                wxAny.onUnhandledRejection((res) => {
-                    try {
-                        if (!sampleHit$1(options.sampleRate))
-                            return;
-                        const e = normalizeErrorLike(res?.reason, options.maxTextLength);
-                        const payload = {
-                            pagePath: getMpPagePath(),
-                            source: 'wx.onUnhandledRejection',
-                            message: e.message,
-                            errorName: e.name,
-                            stack: e.stack,
-                        };
-                        if (!shouldReport(buildErrorKey(options.reportType, payload)))
-                            return;
+        const cloud = wxAny?.cloud;
+        if (!cloud || typeof cloud.callFunction !== 'function')
+            return;
+        if (cloud.__beLinkClsLoggerWxCloudCallFunctionInstalled__)
+            return;
+        cloud.__beLinkClsLoggerWxCloudCallFunctionInstalled__ = true;
+        const rawCallFunction = cloud.callFunction.bind(cloud);
+        cloud.callFunction = (callOptions) => {
+            const startTs = Date.now();
+            const name = (() => {
+                try {
+                    return String(callOptions?.name ?? '');
+                }
+                catch {
+                    return '';
+                }
+            })();
+            const data = callOptions?.data;
+            let reported = false;
+            const onDone = (success, err) => {
+                if (reported)
+                    return;
+                reported = true;
+                try {
+                    const duration = Date.now() - startTs;
+                    const payload = buildPayload({
+                        // 统一走 url 字段，便于和 http 一起检索/聚合
+                        url: `cloud.callFunction/${name || 'unknown'}`,
+                        method: 'callFunction',
+                        query: '',
+                        body: data,
+                        startTime: startTs,
+                        duration,
+                        success,
+                        error: success ? undefined : err,
+                        options,
+                    });
+                    if (payload) {
+                        payload.requestType = 'cloud-function';
+                        payload.name = name || 'unknown';
                         report(options.reportType, payload);
                     }
-                    catch {
-                        // ignore
-                    }
-                });
-            }
-        }
-        catch {
-            // ignore
-        }
-        // 包装 App({...}) 注入 onError/onUnhandledRejection（推荐）
-        try {
-            if (typeof g.App === 'function' && !g.__beLinkClsLoggerAppWrapped__) {
-                g.__beLinkClsLoggerAppWrapped__ = true;
-                const rawApp = g.App;
-                g.App = (appOptions) => {
-                    const next = { ...(appOptions ?? {}) };
-                    const rawOnError = next.onError;
-                    next.onError = function (...args) {
-                        try {
-                            if (sampleHit$1(options.sampleRate)) {
-                                const e = normalizeErrorLike(args?.[0], options.maxTextLength);
-                                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 {
-                            // ignore
-                        }
-                        if (typeof rawOnError === 'function')
-                            return rawOnError.apply(this, args);
-                        return undefined;
-                    };
-                    const rawOnUnhandled = next.onUnhandledRejection;
-                    next.onUnhandledRejection = function (...args) {
-                        try {
-                            if (sampleHit$1(options.sampleRate)) {
-                                const reason = args?.[0]?.reason ?? args?.[0];
-                                const e = normalizeErrorLike(reason, options.maxTextLength);
-                                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 {
-                            // ignore
-                        }
-                        if (typeof rawOnUnhandled === 'function')
-                            return rawOnUnhandled.apply(this, args);
-                        return undefined;
-                    };
-                    return rawApp(next);
+                }
+                catch {
+                    // ignore
+                }
+            };
+            try {
+                const next = { ...(callOptions ?? {}) };
+                const rawSuccess = next.success;
+                const rawFail = next.fail;
+                next.success = (res) => {
+                    onDone(true);
+                    if (typeof rawSuccess === 'function')
+                        return rawSuccess(res);
+                    return undefined;
+                };
+                next.fail = (err) => {
+                    onDone(false, err?.message ?? err);
+                    if (typeof rawFail === 'function')
+                        return rawFail(err);
+                    return undefined;
                 };
+                const ret = rawCallFunction(next);
+                // 兼容 Promise 风格（有些版本/写法不传 success/fail）
+                if (ret && typeof ret.then === 'function') {
+                    ret.then(() => onDone(true), (err) => onDone(false, err?.message ?? err));
+                }
+                return ret;
             }
-        }
-        catch {
-            // ignore
-        }
+            catch (err) {
+                onDone(false, err);
+                throw err;
+            }
+        };
     }
-    function installErrorMonitor(report, opts = {}) {
-        const enabled = opts === undefined ? true : !!opts;
+    function installMiniRequestMonitor(report, opts = {}) {
+        const enabled = opts.enabled ?? true;
         if (!enabled)
             return;
-        const raw = typeof opts === 'object' && opts ? opts : {};
+        const ignoreUrls = [...DEFAULT_IGNORE$1, ...(opts.ignoreUrls ?? [])];
+        if (opts.clsEndpoint)
+            ignoreUrls.push(opts.clsEndpoint);
         const options = {
             enabled: true,
-            reportType: raw.reportType ?? 'error',
-            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,
+            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 ?? '',
         };
+        installMiniProgramWxRequest(report, options);
+        installMiniProgramWxCloudCallFunction(report, options);
+    }
+
+    function installRequestMonitor(report, opts = {}) {
         if (isMiniProgramEnv()) {
-            installMiniProgramErrorMonitor(report, options);
-            return;
+            return installMiniRequestMonitor(report, opts);
         }
-        installBrowserErrorMonitor(report, options);
+        return installWebRequestMonitor(report, opts);
     }
 
-    const DEFAULT_IGNORE = ['cls.tencentcs.com', /\/cls\//i];
-    function truncate$1(s, maxLen) {
+    const DEFAULT_MAX_TEXT$1 = 4000;
+    const DEFAULT_DEDUPE_WINDOW_MS$1 = 3000;
+    const DEFAULT_DEDUPE_MAX_KEYS$1 = 200;
+    function truncate$3(s, maxLen) {
         if (!s)
             return s;
         return s.length > maxLen ? `${s.slice(0, maxLen)}...` : s;
     }
-    function sampleHit(sampleRate) {
+    function sampleHit$3(sampleRate) {
         if (sampleRate >= 1)
             return true;
         if (sampleRate <= 0)
             return false;
         return Math.random() < sampleRate;
     }
-    function shouldIgnoreUrl(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
+    function getPagePath$1() {
+        try {
+            if (typeof window === 'undefined')
+                return '';
+            return window.location?.pathname ?? '';
+        }
+        catch {
+            return '';
+        }
+    }
+    function normalizeErrorLike$1(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$3(String(rawMsg ?? ''), maxTextLength);
+            const name = truncate$3(String(anyErr.name ?? ''), 200);
+            const stack = truncate$3(String(anyErr.stack ?? ''), maxTextLength);
+            return { message, name, stack };
         }
-        return false;
+        const message = truncate$3(stringifyLogValue(err), maxTextLength);
+        return { message, name: '', stack: '' };
     }
-    function getPagePath() {
-        try {
-            if (typeof window === 'undefined')
-                return '';
-            return window.location?.pathname ?? '';
-        }
-        catch {
-            return '';
+    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 reportMetric(report, reportType, metric, value, extra = {}) {
-        report(reportType, {
-            pagePath: getPagePath(),
-            metric,
-            value,
-            ...extra,
-        });
+    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 installBrowserPerformanceMonitor(report, options) {
+    function installBrowserErrorMonitor(report, options) {
         if (typeof window === 'undefined')
             return;
         const w = window;
-        if (w.__beLinkClsLoggerPerfInstalled__)
+        if (w.__beLinkClsLoggerErrorInstalled__)
             return;
-        w.__beLinkClsLoggerPerfInstalled__ = true;
-        const ignoreUrls = [...DEFAULT_IGNORE, ...(options.ignoreUrls ?? [])];
-        // Navigation timing: TTFB 等
-        if (options.navigationTiming) {
-            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' });
-                }
-            }
-            catch {
-                // ignore
-            }
-        }
-        // Web Vitals: FCP/LCP/CLS/FID
-        if (options.webVitals && typeof globalThis.PerformanceObserver === 'function') {
-            // FCP
-            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
-                    }
-                });
-                po.observe({ type: 'paint', buffered: true });
-            }
-            catch {
-                // ignore
-            }
-            // LCP（最后一次为准）
-            let lastLcp = null;
-            try {
-                const po = new PerformanceObserver((list) => {
-                    try {
-                        const entries = list.getEntries();
-                        if (entries && entries.length)
-                            lastLcp = entries[entries.length - 1];
-                    }
-                    catch {
-                        // ignore
-                    }
-                });
-                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
+        w.__beLinkClsLoggerErrorInstalled__ = true;
+        const shouldReport = createDedupeGuard$1(options);
+        window.addEventListener('error', (event) => {
             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
-                    }
-                });
-                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
-                    }
+                if (!sampleHit$3(options.sampleRate))
+                    return;
+                const payload = {
+                    pagePath: getPagePath$1(),
+                    source: 'window.error',
                 };
-                window.addEventListener('pagehide', flushCls, { once: true });
-                document.addEventListener('visibilitychange', () => {
-                    if (document.visibilityState === 'hidden')
-                        flushCls();
-                }, { once: true });
-            }
-            catch {
-                // ignore
-            }
-            // FID
-            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
-                    }
-                });
-                po.observe({ type: 'first-input', buffered: true });
-            }
-            catch {
-                // ignore
-            }
-        }
-        // Resource timing：资源加载耗时
-        if (options.resourceTiming && typeof globalThis.PerformanceObserver === 'function') {
-            try {
-                const po = new PerformanceObserver((list) => {
-                    try {
-                        if (!sampleHit(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 但不强制）
-                            if (!['xmlhttprequest', 'fetch', 'img', 'script', 'css'].includes(initiatorType))
-                                continue;
-                            const payload = {
-                                pagePath: getPagePath(),
-                                metric: 'resource',
-                                initiatorType,
-                                url: truncate$1(name, options.maxTextLength),
-                                startTime: typeof entry?.startTime === 'number' ? entry.startTime : undefined,
-                                duration: typeof entry?.duration === 'number' ? entry.duration : undefined,
-                            };
-                            // 兼容字段（部分浏览器支持）
-                            if (typeof entry?.transferSize === 'number')
-                                payload.transferSize = entry.transferSize;
-                            if (typeof entry?.encodedBodySize === 'number')
-                                payload.encodedBodySize = entry.encodedBodySize;
-                            if (typeof entry?.decodedBodySize === 'number')
-                                payload.decodedBodySize = entry.decodedBodySize;
-                            if (typeof entry?.nextHopProtocol === 'string')
-                                payload.nextHopProtocol = entry.nextHopProtocol;
-                            if (typeof entry?.responseStatus === 'number')
-                                payload.status = entry.responseStatus;
-                            report(options.reportType, payload);
-                        }
-                    }
-                    catch {
-                        // ignore
+                if (event && typeof event === 'object' && 'message' in event) {
+                    payload.message = truncate$3(String(event.message ?? ''), options.maxTextLength);
+                    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$1(err, options.maxTextLength);
+                        if (e.name)
+                            payload.errorName = e.name;
+                        if (e.stack)
+                            payload.stack = e.stack;
                     }
-                });
-                po.observe({ type: 'resource', buffered: true });
+                    if (!shouldReport(buildErrorKey$1(options.reportType, payload)))
+                        return;
+                    report(options.reportType, payload);
+                    return;
+                }
+                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$3(url, 2000);
+                    if (!shouldReport(buildErrorKey$1(options.reportType, payload)))
+                        return;
+                    report(options.reportType, payload);
+                }
             }
             catch {
                 // ignore
             }
-        }
-    }
-    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;
-        try {
-            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: 'page-render',
-                                duration,
-                                pagePath: entry.path || '',
-                                unit: 'ms',
-                            });
-                        }
-                        // 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',
-                            });
-                        }
-                    }
-                }
-                catch {
-                    // ignore
-                }
-            });
-            observer.observe({ entryTypes: ['navigation', 'render'] });
-        }
-        catch {
-            // ignore
-        }
+        }, true);
+        window.addEventListener('unhandledrejection', (event) => {
+            try {
+                if (!sampleHit$3(options.sampleRate))
+                    return;
+                const reason = event?.reason;
+                const e = normalizeErrorLike$1(reason, options.maxTextLength);
+                const payload = {
+                    pagePath: getPagePath$1(),
+                    source: 'unhandledrejection',
+                    message: e.message,
+                    errorName: e.name,
+                    stack: e.stack,
+                };
+                if (!shouldReport(buildErrorKey$1(options.reportType, payload)))
+                    return;
+                report(options.reportType, payload);
+            }
+            catch {
+                // ignore
+            }
+        });
     }
-    function installPerformanceMonitor(report, opts = {}) {
+    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 ?? 'perf',
+            reportType: raw.reportType ?? 'error',
             sampleRate: raw.sampleRate ?? 1,
-            ignoreUrls: raw.ignoreUrls ?? [],
-            webVitals: raw.webVitals ?? true,
-            navigationTiming: raw.navigationTiming ?? true,
-            resourceTiming: raw.resourceTiming ?? true,
-            maxTextLength: raw.maxTextLength ?? 2000,
+            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,
         };
-        if (isMiniProgramEnv()) {
-            installMiniProgramPerformanceMonitor(report, options);
-            return;
-        }
-        installBrowserPerformanceMonitor(report, options);
+        installBrowserErrorMonitor(report, options);
     }
 
-    function shouldSample(sampleRate) {
-        const r = sampleRate ?? 1;
-        if (r >= 1)
+    const DEFAULT_MAX_TEXT = 4000;
+    const DEFAULT_DEDUPE_WINDOW_MS = 3000;
+    const DEFAULT_DEDUPE_MAX_KEYS = 200;
+    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 (r <= 0)
+        if (sampleRate <= 0)
             return false;
-        return Math.random() < r;
-    }
-    function generateUUID() {
-        // 优先使用更安全的 crypto.randomUUID
-        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) {
-        const raw = readStringStorage(key);
-        if (!raw)
-            return { firstVisitTs: Date.now(), visitCount: 0 };
-        try {
-            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 {
-            return { firstVisitTs: Date.now(), visitCount: 0 };
-        }
-    }
-    function writeUvMeta(key, meta) {
-        writeStringStorage(key, JSON.stringify(meta));
-    }
-    function getWebPagePath() {
-        if (typeof window === 'undefined')
-            return '';
-        return window.location?.pathname || '';
+        return Math.random() < sampleRate;
     }
-    function getMiniProgramPagePath() {
-        const g = globalThis;
+    function getMpPagePath() {
         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 {
+            const pages = globalThis.getCurrentPages?.();
+            if (Array.isArray(pages) && pages.length > 0) {
+                const page = pages[pages.length - 1];
+                return page.route || page.__route__ || '';
+            }
             return '';
         }
-    }
-    function buildCommonUvFields(uvId, uvMeta, isFirstVisit) {
-        return {
-            uvId,
-            isFirstVisit,
-            firstVisitTs: uvMeta.firstVisitTs,
-            visitCount: uvMeta.visitCount,
-        };
-    }
-    function getAttr(el, attrName) {
-        try {
-            return el.getAttribute(attrName) ?? '';
-        }
         catch {
             return '';
         }
     }
-    function truncateText(s, maxLen) {
-        if (!s)
-            return '';
-        if (s.length <= maxLen)
-            return s;
-        return s.slice(0, maxLen);
-    }
-    function installBehaviorMonitor(report, envType, 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 defaultClickWhiteList = envType === 'miniprogram' || isMiniProgramEnv() ? ['view', 'scroll-view'] : ['body', 'html'];
-        const clickWhiteList = (options.trackOptions?.clickWhiteList ?? options.clickWhiteList ?? defaultClickWhiteList).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();
-            });
-        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 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 });
-                writeStringStorage(uvIdStorageKey, '');
-            }
-            // 如果外部提供 getUvId，优先使用；否则本地生成
-            try {
-                if (options.getUvId) {
-                    const maybe = options.getUvId();
-                    const resolved = typeof maybe?.then === 'function' ? await maybe : maybe;
-                    if (resolved && typeof resolved === 'string')
-                        existingUvId = resolved;
+    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);
                 }
-            }
-            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);
+                else {
+                    rawMsg = str;
                 }
-                catch {
-                    // ignore
+            }
+            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);
                 }
-                if (!existingUvId) {
+            }
+        }
+        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;
+        try {
+            if (wxAny && typeof wxAny.onError === 'function') {
+                wxAny.onError((msg) => {
                     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()}`;
+                        if (!sampleHit$2(options.sampleRate))
+                            return;
+                        const e = normalizeErrorLike(msg, options.maxTextLength);
+                        const payload = {
+                            pagePath: getMpPagePath(),
+                            source: 'wx.onError',
+                            message: e.message,
+                            errorName: e.name,
+                            stack: e.stack,
+                        };
+                        if (!shouldReport(buildErrorKey(options.reportType, payload)))
+                            return;
+                        report(options.reportType, payload);
                     }
                     catch {
                         // ignore
                     }
-                }
-            }
-            if (!existingUvId) {
-                existingUvId = generateUUID();
-                isFirstVisit = true;
-            }
-            // 只要拿到了 uvId，就写入持久化（便于下次启动复用）
-            writeStringStorage(uvIdStorageKey, existingUvId);
-            const meta = safeReadUvMeta(uvMetaStorageKey);
-            // 每次启动都 +1（“累计访问次数”）
-            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,
-            };
-            // 如果是首次访问，刷新 firstVisitTs
-            if (isFirstVisit) {
-                nextMeta.firstVisitTs = now;
-                nextMeta.createdAtTs = now;
-            }
-            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 reportUvOncePerSession() {
-            if (!uvEnabled)
-                return;
-            void uvStatePromise.then(({ uvId, meta }) => {
-                if (destroyed)
-                    return;
-                safeReport(uvReportType, {
-                    ...buildUvFieldsOnce(uvId, meta),
-                    timestamp: Date.now(),
-                    pagePath: getPagePath(),
-                });
-            });
-        }
-        function reportPv(pagePath) {
-            if (!pvEnabled)
-                return;
-            void uvStatePromise.then(({ uvId, meta }) => {
-                if (destroyed)
-                    return;
-                const payload = {
-                    ...buildUvFieldsOnce(uvId, meta),
-                    timestamp: Date.now(),
-                    pagePath,
-                };
-                // 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 ---
-        let removeWebPvListeners = null;
-        if (!destroyed && 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
-                }
-            };
+        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) {
-                                const pagePath = getPagePath();
-                                if (pagePath?.length > 0) {
-                                    reportPv(pagePath);
-                                }
-                            }
-                            return typeof originalOnShow === 'function' ? originalOnShow.apply(this, args) : undefined;
+        try {
+            if (wxAny && typeof wxAny.onUnhandledRejection === 'function') {
+                wxAny.onUnhandledRejection((res) => {
+                    try {
+                        if (!sampleHit$2(options.sampleRate))
+                            return;
+                        const e = normalizeErrorLike(res?.reason, options.maxTextLength);
+                        const payload = {
+                            pagePath: getMpPagePath(),
+                            source: 'wx.onUnhandledRejection',
+                            message: e.message,
+                            errorName: e.name,
+                            stack: e.stack,
                         };
-                        // 点击：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);
+                        if (!shouldReport(buildErrorKey(options.reportType, payload)))
+                            return;
+                        report(options.reportType, payload);
+                    }
+                    catch {
+                        // ignore
+                    }
+                });
+            }
+        }
+        catch {
+            // ignore
+        }
+        try {
+            if (typeof g.App === 'function' && !g.__beLinkClsLoggerAppWrapped__) {
+                g.__beLinkClsLoggerAppWrapped__ = true;
+                const rawApp = g.App;
+                g.App = (appOptions) => {
+                    const next = { ...(appOptions ?? {}) };
+                    const rawOnError = next.onError;
+                    next.onError = function (...args) {
+                        try {
+                            if (sampleHit$2(options.sampleRate)) {
+                                const e = normalizeErrorLike(args?.[0], options.maxTextLength);
+                                const payload = {
+                                    pagePath: getMpPagePath(),
+                                    source: 'App.onError',
+                                    message: e.message,
+                                    errorName: e.name,
+                                    stack: e.stack,
                                 };
-                                conf[key].__beLinkWrapped__ = true;
+                                if (shouldReport(buildErrorKey(options.reportType, payload)))
+                                    report(options.reportType, payload);
                             }
                         }
-                        return originalPage(conf);
+                        catch {
+                            // ignore
+                        }
+                        if (typeof rawOnError === 'function')
+                            return rawOnError.apply(this, args);
+                        return undefined;
                     };
-                    restoreMiniProgramPatch = () => {
+                    const rawOnUnhandled = next.onUnhandledRejection;
+                    next.onUnhandledRejection = function (...args) {
                         try {
-                            g.Page = originalPage;
-                            g[patchedKey] = false;
+                            if (sampleHit$2(options.sampleRate)) {
+                                const reason = args?.[0]?.reason ?? args?.[0];
+                                const e = normalizeErrorLike(reason, options.maxTextLength);
+                                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 {
                             // ignore
                         }
+                        if (typeof rawOnUnhandled === 'function')
+                            return rawOnUnhandled.apply(this, args);
+                        return undefined;
                     };
-                }
+                    return rawApp(next);
+                };
             }
-            // 启动时也尝试报一次（避免 Page patch 未生效的场景）
-            if (pvEnabled)
-                reportPv(getPagePath());
         }
-        // UV：每次启动上报一次（可关闭）
-        reportUvOncePerSession();
-        return () => {
-            if (destroyed)
-                return;
-            destroyed = true;
-            try {
-                removeWebPvListeners?.();
-                removeWebClickListener?.();
-                restoreMiniProgramPatch?.();
-            }
-            catch {
-                // ignore
-            }
+        catch {
+            // ignore
+        }
+    }
+    function installMiniErrorMonitor(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,
+            dedupeWindowMs: raw.dedupeWindowMs ?? DEFAULT_DEDUPE_WINDOW_MS,
+            dedupeMaxKeys: raw.dedupeMaxKeys ?? DEFAULT_DEDUPE_MAX_KEYS,
         };
+        installMiniProgramErrorMonitor(report, options);
     }
 
-    function truncate(s, maxLen) {
+    function installErrorMonitor(report, opts = {}) {
+        if (isMiniProgramEnv()) {
+            return installMiniErrorMonitor(report, opts);
+        }
+        return installWebErrorMonitor(report, opts);
+    }
+
+    const DEFAULT_IGNORE = ['cls.tencentcs.com', /\/cls\//i];
+    function truncate$1(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 sampleHit$1(sampleRate) {
+        if (sampleRate >= 1)
+            return true;
+        if (sampleRate <= 0)
+            return false;
+        return Math.random() < sampleRate;
     }
-    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
+    function shouldIgnoreUrl(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 getPagePath() {
         try {
-            out.dpr = typeof window.devicePixelRatio === 'number' ? window.devicePixelRatio : undefined;
+            if (typeof window === 'undefined')
+                return '';
+            return window.location?.pathname ?? '';
         }
         catch {
-            // ignore
-        }
-        try {
-            const navAny = navigator;
-            out.hardwareConcurrency = typeof navAny.hardwareConcurrency === 'number' ? navAny.hardwareConcurrency : undefined;
-            out.deviceMemory = typeof navAny.deviceMemory === 'number' ? navAny.deviceMemory : undefined;
+            return '';
         }
-        catch {
-            // ignore
+    }
+    function reportMetric(report, reportType, metric, value, extra = {}) {
+        report(reportType, {
+            pagePath: getPagePath(),
+            metric,
+            value,
+            ...extra,
+        });
+    }
+    function installBrowserPerformanceMonitor(report, options) {
+        if (typeof window === 'undefined')
+            return;
+        const w = window;
+        if (w.__beLinkClsLoggerPerfInstalled__)
+            return;
+        w.__beLinkClsLoggerPerfInstalled__ = true;
+        const ignoreUrls = [...DEFAULT_IGNORE, ...(options.ignoreUrls ?? [])];
+        // Navigation timing: TTFB 等
+        if (options.navigationTiming) {
+            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$1(options.sampleRate))
+                        reportMetric(report, options.reportType, 'TTFB', ttfb, { unit: 'ms' });
+                }
+            }
+            catch {
+                // ignore
+            }
         }
-        if (options.includeNetwork) {
+        // Web Vitals: FCP/LCP/CLS/FID
+        if (options.webVitals && typeof globalThis.PerformanceObserver === 'function') {
+            // FCP
+            try {
+                const po = new PerformanceObserver((list) => {
+                    try {
+                        if (!sampleHit$1(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
+                    }
+                });
+                po.observe({ type: 'paint', buffered: true });
+            }
+            catch {
+                // ignore
+            }
+            // LCP（最后一次为准）
+            let lastLcp = null;
             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;
-                }
+                const po = new PerformanceObserver((list) => {
+                    try {
+                        const entries = list.getEntries();
+                        if (entries && entries.length)
+                            lastLcp = entries[entries.length - 1];
+                    }
+                    catch {
+                        // ignore
+                    }
+                });
+                po.observe({ type: 'largest-contentful-paint', buffered: true });
+                const flushLcp = () => {
+                    try {
+                        if (!lastLcp)
+                            return;
+                        if (!sampleHit$1(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
             }
-        }
-        return out;
-    }
-    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) : '';
-        }
-        catch {
-            // ignore
-        }
-        if (options.includeNetworkType) {
+            // CLS
             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
+                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
+                    }
+                });
+                po.observe({ type: 'layout-shift', buffered: true });
+                const flushCls = () => {
+                    try {
+                        if (!sampleHit$1(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
+            try {
+                const po = new PerformanceObserver((list) => {
+                    try {
+                        if (!sampleHit$1(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
+                    }
+                });
+                po.observe({ type: 'first-input', buffered: true });
             }
             catch {
                 // ignore
             }
+        }
+        // Resource timing：资源加载耗时
+        if (options.resourceTiming && typeof globalThis.PerformanceObserver === 'function') {
             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) : '';
+                const po = new PerformanceObserver((list) => {
+                    try {
+                        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 但不强制）
+                            if (!['xmlhttprequest', 'fetch', 'img', 'script', 'css'].includes(initiatorType))
+                                continue;
+                            const payload = {
+                                pagePath: getPagePath(),
+                                metric: 'resource',
+                                initiatorType,
+                                url: truncate$1(name, options.maxTextLength),
+                                startTime: typeof entry?.startTime === 'number' ? entry.startTime : undefined,
+                                duration: typeof entry?.duration === 'number' ? entry.duration : undefined,
+                            };
+                            // 兼容字段（部分浏览器支持）
+                            if (typeof entry?.transferSize === 'number')
+                                payload.transferSize = entry.transferSize;
+                            if (typeof entry?.encodedBodySize === 'number')
+                                payload.encodedBodySize = entry.encodedBodySize;
+                            if (typeof entry?.decodedBodySize === 'number')
+                                payload.decodedBodySize = entry.decodedBodySize;
+                            if (typeof entry?.nextHopProtocol === 'string')
+                                payload.nextHopProtocol = entry.nextHopProtocol;
+                            if (typeof entry?.responseStatus === 'number')
+                                payload.status = entry.responseStatus;
+                            report(options.reportType, payload);
+                        }
+                    }
+                    catch {
+                        // ignore
+                    }
+                });
+                po.observe({ type: 'resource', buffered: true });
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    function installWebPerformanceMonitor(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 ?? 'perf',
+            sampleRate: raw.sampleRate ?? 1,
+            ignoreUrls: raw.ignoreUrls ?? [],
+            webVitals: raw.webVitals ?? true,
+            navigationTiming: raw.navigationTiming ?? true,
+            resourceTiming: raw.resourceTiming ?? true,
+            maxTextLength: raw.maxTextLength ?? 2000,
+        };
+        installBrowserPerformanceMonitor(report, options);
+    }
+
+    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;
+        try {
+            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: 'page-render',
+                                duration,
+                                pagePath: entry.path || '',
+                                unit: 'ms',
+                            });
+                        }
+                        // 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',
+                            });
                         }
-                        catch {
-                            // ignore
+                        // 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',
+                            });
                         }
-                    });
+                    }
                 }
-            }
-            catch {
-                // ignore
-            }
+                catch {
+                    // ignore
+                }
+            });
+            observer.observe({ entryTypes: ['navigation', 'render'] });
+        }
+        catch {
+            // ignore
         }
-        return out;
     }
-    function createAutoDeviceInfoBaseFields(envType, opts) {
+    function installMiniPerformanceMonitor(report, opts = {}) {
         const enabled = opts === undefined ? true : !!opts;
         if (!enabled)
-            return null;
+            return;
         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 =
-                    envType === 'miniprogram' || isMiniProgramEnv()
-                        ? getMiniProgramDeviceInfo(options)
-                        : getBrowserDeviceInfo(options);
-                try {
-                    const g = globalThis;
-                    if (!g[globalKey])
-                        g[globalKey] = { ...base };
-                }
-                catch {
-                    // ignore
-                }
-            }
-            try {
-                const g = globalThis;
-                const extra = g[globalKey];
-                if (extra && isPlainObject(extra))
-                    return { ...base, ...extra };
-            }
-            catch {
-                // ignore
-            }
-            return base;
+            enabled: true,
+            reportType: raw.reportType ?? 'perf',
+            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 enterClsSendingGuard() {
+    function installPerformanceMonitor(report, opts = {}) {
+        if (isMiniProgramEnv()) {
+            return installMiniPerformanceMonitor(report, opts);
+        }
+        return installWebPerformanceMonitor(report, opts);
+    }
+
+    function shouldSample$1(sampleRate) {
+        const r = sampleRate ?? 1;
+        if (r >= 1)
+            return true;
+        if (r <= 0)
+            return false;
+        return Math.random() < r;
+    }
+    function generateUUID$1() {
         const g = globalThis;
-        const next = (g.__beLinkClsLoggerSendingCount__ ?? 0) + 1;
-        g.__beLinkClsLoggerSendingCount__ = next;
-        return () => {
-            const cur = g.__beLinkClsLoggerSendingCount__ ?? 0;
-            g.__beLinkClsLoggerSendingCount__ = cur > 0 ? cur - 1 : 0;
-        };
+        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);
+        });
     }
-    /**
-     * 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 = 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 safeReadUvMeta$1(key) {
+        const raw = readStringStorage(key);
+        if (!raw)
+            return { firstVisitTs: Date.now(), visitCount: 0 };
+        try {
+            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 };
         }
-        /**
-         * 子类可按需重写（默认检测 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';
+        catch {
+            return { firstVisitTs: Date.now(), visitCount: 0 };
         }
-        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;
-            }
-            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;
-            // 可选：外部注入 SDK（优先级：sdkLoader > sdk）
-            this.sdkLoaderOverride = options.sdkLoader ?? this.sdkLoaderOverride;
-            this.sdkOverride = options.sdk ?? this.sdkOverride;
-            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;
-            // 预热（避免首条日志触发 import/初始化开销）
-            void this.getInstance().catch(() => {
-                // ignore
-            });
-            // 启动时尝试发送失败缓存
-            this.flushFailed();
-            // 初始化后立即启动请求监听
-            this.startRequestMonitor(options.requestMonitor);
-            // 初始化后立即启动错误监控/性能监控
-            this.startErrorMonitor(options.errorMonitor);
-            this.startPerformanceMonitor(options.performanceMonitor);
-            // 初始化后立即启动行为埋点（PV/UV/点击）
-            this.startBehaviorMonitor(options.behaviorMonitor);
+    }
+    function writeUvMeta$1(key, meta) {
+        writeStringStorage(key, JSON.stringify(meta));
+    }
+    function getWebPagePath() {
+        if (typeof window === 'undefined')
+            return '';
+        return window.location?.pathname || '';
+    }
+    function buildCommonUvFields$1(uvId, uvMeta, isFirstVisit) {
+        return {
+            uvId,
+            isFirstVisit,
+            firstVisitTs: uvMeta.firstVisitTs,
+            visitCount: uvMeta.visitCount,
+        };
+    }
+    function getAttr(el, attrName) {
+        try {
+            return el.getAttribute(attrName) ?? '';
         }
-        getBaseFields() {
-            let auto = undefined;
-            let user = undefined;
+        catch {
+            return '';
+        }
+    }
+    function truncateText$1(s, maxLen) {
+        if (!s)
+            return '';
+        if (s.length <= maxLen)
+            return s;
+        return s.slice(0, maxLen);
+    }
+    function installWebBehaviorMonitor(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 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 ?? ['body', 'html']).map((s) => String(s).toLowerCase());
+        const clickTrackIdAttr = options.clickTrackIdAttr ?? 'data-track-id';
+        const clickMaxTextLength = options.clickMaxTextLength ?? 120;
+        const getPagePath = options.getPagePath ?? getWebPagePath;
+        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$1(uvMetaStorageKey);
+            const lastSeenForExpire = metaBefore.lastSeenTs ?? metaBefore.createdAtTs ?? metaBefore.firstVisitTs ?? now;
+            const expired = uvExpireMs > 0 && now - lastSeenForExpire > uvExpireMs;
+            if (expired) {
+                existingUvId = null;
+                writeUvMeta$1(uvMetaStorageKey, { firstVisitTs: now, visitCount: 0, createdAtTs: now, lastSeenTs: now });
+                writeStringStorage(uvIdStorageKey, '');
+            }
             try {
-                const autoRaw = this.autoGenerateBaseFields ? this.autoGenerateBaseFields() : undefined;
-                if (autoRaw && isPlainObject(autoRaw))
-                    auto = normalizeFlatFields(autoRaw, 'deviceInfo');
+                if (options.getUvId) {
+                    const maybe = options.getUvId();
+                    const resolved = typeof maybe?.then === 'function' ? await maybe : maybe;
+                    if (resolved && typeof resolved === 'string')
+                        existingUvId = resolved;
+                }
             }
             catch {
-                auto = undefined;
+                /* ignore */
             }
-            try {
-                const userRaw = this.userGenerateBaseFields ? this.userGenerateBaseFields() : undefined;
-                if (userRaw && isPlainObject(userRaw))
-                    user = normalizeFlatFields({ ...userRaw }, 'generateBaseFields');
+            if (!existingUvId) {
+                existingUvId = generateUUID$1();
+                isFirstVisit = true;
             }
-            catch {
-                user = undefined;
+            writeStringStorage(uvIdStorageKey, existingUvId);
+            const meta = safeReadUvMeta$1(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;
             }
-            if (auto && user)
-                return mergeFields(user, auto);
-            if (user)
-                return user;
-            if (auto)
-                return auto;
-            return undefined;
-        }
-        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,
-            });
-        }
-        startErrorMonitor(errorMonitor) {
-            if (this.errorMonitorStarted)
+            writeUvMeta$1(uvMetaStorageKey, nextMeta);
+            firstVisitFlag = isFirstVisit;
+            return { uvId: existingUvId, isFirstVisit, meta: nextMeta };
+        })();
+        function safeReport(type, data) {
+            if (destroyed)
                 return;
-            const enabled = errorMonitor === undefined ? true : !!errorMonitor;
-            if (!enabled)
+            if (!shouldSample$1(options.sampleRate))
                 return;
-            this.errorMonitorStarted = true;
-            installErrorMonitor((type, data) => this.track(type, data), errorMonitor);
+            report(type, data);
         }
-        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);
+        function buildUvFieldsOnce(uvId, meta) {
+            const once = firstVisitFlag && !firstVisitConsumed;
+            if (once)
+                firstVisitConsumed = true;
+            return buildCommonUvFields$1(uvId, meta, once);
         }
-        startBehaviorMonitor(behaviorMonitor) {
-            if (this.behaviorMonitorStarted)
-                return;
-            const enabled = behaviorMonitor === undefined ? true : !!behaviorMonitor;
-            if (!enabled)
+        function reportPv(pagePath) {
+            if (!pvEnabled)
                 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,
+            void uvStatePromise.then(({ uvId, meta }) => {
+                if (destroyed)
+                    return;
+                const payload = {
+                    ...buildUvFieldsOnce(uvId, meta),
+                    timestamp: Date.now(),
+                    pagePath,
+                    referrer: typeof document !== 'undefined' ? document.referrer || '' : '',
+                };
+                safeReport(pvReportType, payload);
             });
         }
-        /**
-         * 停止行为埋点监听（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,
+        // Web PV Listeners
+        let removeWebPvListeners = null;
+        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());
+            onRouteChanged();
+            if (originalPushState) {
+                window.history.pushState = ((...args) => {
+                    const r = originalPushState.apply(window.history, args);
+                    onRouteChanged();
+                    return r;
                 });
-                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 (!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();
+            if (originalReplaceState) {
+                window.history.replaceState = ((...args) => {
+                    const r = originalReplaceState.apply(window.history, args);
+                    onRouteChanged();
+                    return r;
+                });
             }
-            await p;
+            window.addEventListener('popstate', onRouteChanged);
+            removeWebPvListeners = () => {
+                window.removeEventListener('popstate', onRouteChanged);
+                if (originalPushState)
+                    window.history.pushState = originalPushState;
+                if (originalReplaceState)
+                    window.history.replaceState = originalReplaceState;
+            };
         }
-        /**
-         * 直接上报：把 data 序列化后放入指定 key（默认 “日志内容”）
-         */
-        putJson(data, clsLoggerKey = '日志内容', options = {}) {
-            // put 的入参要求扁平；这里直接把数据序列化为 string
-            this.put({ [clsLoggerKey]: stringifyLogValue(data) }, options);
+        // 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);
         }
-        /**
-         * 入队：写入 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,
+        // UV Initial Report
+        if (uvEnabled) {
+            void uvStatePromise.then(({ uvId, meta }) => {
+                if (destroyed)
+                    return;
+                safeReport(uvReportType, {
+                    ...buildUvFieldsOnce(uvId, meta),
+                    timestamp: Date.now(),
+                    pagePath: getPagePath(),
+                });
             });
-            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, []);
+        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 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 };
         }
-        /**
-         * 批量上报（每条 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;
-            }
-            void this.putBatchAsync(queue).catch(() => {
-                // ignore
-            });
+        catch {
+            return { firstVisitTs: Date.now(), visitCount: 0 };
         }
-        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);
+    }
+    function writeUvMeta(key, meta) {
+        writeStringStorage(key, JSON.stringify(meta));
+    }
+    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 '';
+        }
+    }
+    function buildCommonUvFields(uvId, uvMeta, isFirstVisit) {
+        return {
+            uvId,
+            isFirstVisit,
+            firstVisitTs: uvMeta.firstVisitTs,
+            visitCount: uvMeta.visitCount,
+        };
+    }
+    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, '');
             }
-            if (logGroup.getLogs().length === 0)
-                return;
-            const request = new sdk.PutLogsRequest(this.topicId, logGroup);
-            const exit = enterClsSendingGuard();
-            let p;
             try {
-                p = client.PutLogs(request);
+                if (options.getUvId) {
+                    const maybe = options.getUvId();
+                    const resolved = typeof maybe?.then === 'function' ? await maybe : maybe;
+                    if (resolved && typeof resolved === 'string')
+                        existingUvId = resolved;
+                }
             }
-            finally {
-                exit();
+            catch {
+                /* ignore */
             }
-            await p;
-        }
-        /**
-         * 参考《一、概述》：统一上报入口（内存队列 + 批量发送）
-         */
-        report(log) {
-            if (!log?.type)
-                return;
-            if (!this.topicId) {
-                // eslint-disable-next-line no-console
-                console.warn('ClsLogger.report：未初始化 topicID/topic_id');
-                return;
+            if (!existingUvId) {
+                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 */
+                    }
+                }
             }
-            this.memoryQueue.push(log);
-            if (this.memoryQueue.length >= this.batchMaxSize) {
-                void this.flushBatch();
+            if (!existingUvId) {
+                existingUvId = generateUUID();
+                isFirstVisit = true;
+            }
+            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;
+            }
+            writeUvMeta(uvMetaStorageKey, nextMeta);
+            firstVisitFlag = isFirstVisit;
+            return { uvId: existingUvId, isFirstVisit, meta: nextMeta };
+        })();
+        function safeReport(type, data) {
+            if (destroyed)
                 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);
+            if (!shouldSample(options.sampleRate))
                 return;
-            }
-            // 启动合并窗口内：如果当前 timer 会“更早”触发，则延后到窗口结束，尽量减少多次发送
-            if (this.batchTimerDueAt !== null && this.batchTimerDueAt < desiredDueAt) {
-                try {
-                    clearTimeout(this.batchTimer);
-                }
-                catch {
-                    // ignore
-                }
-                this.batchTimerDueAt = desiredDueAt;
-                this.batchTimer = setTimeout(() => {
-                    void this.flushBatch();
-                }, desiredDelay);
-            }
+            report(type, data);
         }
-        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;
+        function buildUvFieldsOnce(uvId, meta) {
+            const once = firstVisitFlag && !firstVisitConsumed;
+            if (once)
+                firstVisitConsumed = true;
+            return buildCommonUvFields(uvId, meta, once);
         }
-        info(message, data = {}) {
-            let msg = '';
-            let extra = {};
-            if (message instanceof Error) {
-                msg = message.message;
-                extra = {
-                    stack: message.stack,
-                    name: message.name,
-                    ...data,
+        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) || '',
                 };
-            }
-            else {
-                msg = String(message);
-                extra = data;
-            }
-            const payload = normalizeFlatFields({ message: msg, ...extra }, 'info');
-            this.report({ type: 'info', data: payload, timestamp: Date.now() });
+                writeStringStorage(lastPagePathStorageKey, pagePath);
+                safeReport(pvReportType, payload);
+            });
         }
-        warn(message, data = {}) {
-            let msg = '';
-            let extra = {};
-            if (message instanceof Error) {
-                msg = message.message;
-                extra = {
-                    stack: message.stack,
-                    name: message.name,
-                    ...data,
+        // MiniProgram Page Patch
+        let restoreMiniProgramPatch = null;
+        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) {
+                            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);
                 };
-            }
-            else {
-                msg = String(message);
-                extra = data;
-            }
-            const payload = normalizeFlatFields({ message: msg, ...extra }, 'warn');
-            this.report({ type: 'warn', data: payload, timestamp: Date.now() });
-        }
-        error(message, data = {}) {
-            let msg = '';
-            let extra = {};
-            if (message instanceof Error) {
-                msg = message.message;
-                extra = {
-                    stack: message.stack,
-                    name: message.name,
-                    ...data,
+                restoreMiniProgramPatch = () => {
+                    g.Page = originalPage;
+                    g[patchedKey] = false;
                 };
             }
-            else {
-                msg = String(message);
-                extra = data;
-            }
-            const payload = normalizeFlatFields({ message: msg, ...extra }, '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(),
+        if (pvEnabled)
+            reportPv(getPagePath());
+        if (uvEnabled) {
+            void uvStatePromise.then(({ uvId, meta }) => {
+                if (destroyed)
+                    return;
+                safeReport(uvReportType, {
+                    ...buildUvFieldsOnce(uvId, meta),
+                    timestamp: Date.now(),
+                    pagePath: getPagePath(),
+                });
             });
         }
-        /**
-         * 立即发送内存队列
-         */
-        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 = [];
+        return () => {
+            destroyed = true;
+            restoreMiniProgramPatch?.();
+        };
+    }
+
+    function installBehaviorMonitor(report, envType, options = {}) {
+        if (envType === 'miniprogram' || isMiniProgramEnv()) {
+            return installMiniBehaviorMonitor(report, options);
+        }
+        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, '.');
+        }
+        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
+        }
+        try {
+            out.dpr = typeof window.devicePixelRatio === 'number' ? window.devicePixelRatio : undefined;
+        }
+        catch {
+            // ignore
+        }
+        try {
+            const navAny = navigator;
+            out.hardwareConcurrency = typeof navAny.hardwareConcurrency === 'number' ? navAny.hardwareConcurrency : undefined;
+            out.deviceMemory = typeof navAny.deviceMemory === 'number' ? navAny.deviceMemory : undefined;
+        }
+        catch {
+            // ignore
+        }
+        if (options.includeNetwork) {
             try {
-                await this.sendReportLogs(logs);
+                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 {
-                this.retrySendReportLogs(logs, 1);
+                // ignore
             }
         }
-        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]));
+        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 {
+                    const g = globalThis;
+                    if (!g[globalKey])
+                        g[globalKey] = { ...base };
+                }
+                catch {
+                    // ignore
                 }
-                logGroup.addLog(log);
             }
-            const request = new sdk.PutLogsRequest(this.topicId, logGroup);
-            // 只在“发起网络请求”的同步阶段打标记，避免 requestMonitor 监控 CLS 上报请求导致递归
-            const exit = enterClsSendingGuard();
-            let p;
             try {
-                p = client.PutLogs(request);
+                const g = globalThis;
+                const extra = g[globalKey];
+                if (extra && isPlainObject(extra))
+                    return { ...base, ...extra };
             }
-            finally {
-                exit();
+            catch {
+                // ignore
             }
-            await p;
+            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) : '';
         }
-        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);
+        catch {
+            // ignore
         }
-        cacheFailedReportLogs(logs) {
-            const raw = readStringStorage(this.failedCacheKey);
-            let current = [];
+        if (options.includeNetworkType) {
             try {
-                const parsed = raw ? JSON.parse(raw) : [];
-                current = Array.isArray(parsed) ? parsed : [];
+                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 {
-                current = [];
+                // ignore
             }
-            const next = [...current, ...logs].slice(-this.failedCacheMax);
-            writeStringStorage(this.failedCacheKey, JSON.stringify(next));
-        }
-        flushFailed() {
-            const raw = readStringStorage(this.failedCacheKey);
-            if (!raw)
-                return;
-            let logs = [];
             try {
-                const parsed = JSON.parse(raw);
-                logs = Array.isArray(parsed) ? parsed : [];
+                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 {
-                logs = [];
+                // ignore
             }
-            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() });
         }
+        return out;
     }
-
-    function readGlobal(key) {
-        try {
-            const g = globalThis;
-            return g[key] ?? null;
-        }
-        catch {
+    function createMiniDeviceInfoBaseFields(opts) {
+        const enabled = opts === undefined ? true : !!opts;
+        if (!enabled)
             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) {
+        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 {
-                    return fn(moduleName);
+                    const g = globalThis;
+                    if (!g[globalKey])
+                        g[globalKey] = { ...base };
                 }
                 catch {
-                    // continue
+                    // ignore
                 }
             }
-            return null;
-        }
-        catch {
-            return null;
+            try {
+                const g = globalThis;
+                const extra = g[globalKey];
+                if (extra && isPlainObject(extra))
+                    return { ...base, ...extra };
+            }
+            catch {
+                // ignore
+            }
+            return base;
+        };
+    }
+
+    function createAutoDeviceInfoBaseFields(envType, opts) {
+        if (envType === 'miniprogram' || isMiniProgramEnv()) {
+            return createMiniDeviceInfoBaseFields(opts);
         }
+        return createWebDeviceInfoBaseFields(opts);
     }
 
     /**
@@ -2615,9 +2970,12 @@
                 }
             }
             // 4) 动态 import
-            // 使用字符串字面量，确保 Bundler 能正确识别并进行 Code Splitting
+            // 使用 /* @vite-ignore */ 告知 Vite 忽略对可选依赖的静态解析，
+            // 这样在用户未安装 SDK 时，Vite 不会抛出编译时/构建时错误。
+            const miniPkg = 'tencentcloud-cls-sdk-js-mini';
+            const webPkg = 'tencentcloud-cls-sdk-js-web';
             if (isMini) {
-                this.sdkPromise = import('tencentcloud-cls-sdk-js-mini')
+                this.sdkPromise = import(/* @vite-ignore */ miniPkg)
                     .then((m) => {
                     const sdk = normalizeSdk(m);
                     if (!sdk)
@@ -2627,12 +2985,13 @@
                 })
                     .catch((err) => {
                     this.sdkPromise = null;
-                    console.error('[ClsLogger] Failed to load mini sdk:', err);
+                    // 仅打印警告，不阻塞主流程
+                    console.warn(`[ClsLogger] Optional SDK "${miniPkg}" not found. Logging will be disabled.`, err);
                     throw err;
                 });
             }
             else {
-                this.sdkPromise = import('tencentcloud-cls-sdk-js-web')
+                this.sdkPromise = import(/* @vite-ignore */ webPkg)
                     .then((m) => {
                     const sdk = normalizeSdk(m);
                     if (!sdk)
@@ -2642,12 +3001,27 @@
                 })
                     .catch((err) => {
                     this.sdkPromise = null;
-                    console.error('[ClsLogger] Failed to load web sdk:', err);
+                    console.warn(`[ClsLogger] Optional SDK "${webPkg}" not found. Logging will be disabled.`, err);
                     throw err;
                 });
             }
             return this.sdkPromise;
         }
+        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);
+        }
     }
 
     const clsLogger = new ClsLogger();