@be-link/cls-logger 1.0.1-beta.8 → 1.0.3

package/README.md

@@ -1,6 +1,6 @@
 # @be-link/cls-logger
 
-腾讯云 CLS（`tencentcloud-cls-sdk-js-web`）日志上报封装，参考仓库内 `@be-link/utils` 的构建方式（Rollup 打包 + tsc 仅产出 d.ts）。
+腾讯云 CLS（`tencentcloud-cls-sdk-js-web` / `tencentcloud-cls-sdk-js-mini`）日志上报封装，支持 Web、H5 和小程序环境，提供统一的调用方式。
 
 ## 安装
 
@@ -8,58 +8,92 @@
 pnpm add @be-link/cls-logger
 ```
 
+> 依赖说明：本包依赖了腾讯云的 Web 和小程序 SDK。在使用时，内部会自动根据运行环境加载对应的 SDK。
+
 ## 使用
 
+**统一引入方式**，无需关心运行环境（Web 或 小程序），SDK 内部会自动识别并适配。
+
 ```ts
-import clsLogger, { ClsLogger } from '@be-link/cls-logger';
+import clsLogger from '@be-link/cls-logger';
 
+// 1. 初始化（建议在应用入口处调用）
 clsLogger.init({
-  topic_id: 'xxx',
+  topic_id: 'xxx', // 你的 CLS Topic ID
   projectName: 'my-project',
+  // 可选：环境信息（内部会自动采集，这里可以补充业务相关基础字段）
   generateBaseFields: () => ({ env: 'prod', uid: 'u_1' }),
 });
 
-// 直接上报（展开字段）
-clsLogger.put({ event: 'login', ok: true });
+// 2. 日志上报
+// Info 日志
+clsLogger.info('应用启动', { startUpTime: 120 });
+
+// Error 日志（支持直接传入 Error 对象，自动解析堆栈）
+try {
+  doSomething();
+} catch (err) {
+  clsLogger.error(err, { module: 'payment' });
+}
+
+// 3. 自定义埋点 (Track)
+clsLogger.track('click_event', {
+  button: 'submit',
+  page: '/home',
+});
+```
+
+## 功能特性
+
+### 1. 自动环境适配
+
+- **Web / H5**: 自动加载 `tencentcloud-cls-sdk-js-web`，采集浏览器环境信息（UserAgent、Web Vitals 等）。
+- **小程序**: 自动加载 `tencentcloud-cls-sdk-js-mini`，适配 `wx.request`，采集小程序环境信息（SystemInfo、NetworkType 等）。
+
+### 2. 请求监控 (Request Monitor)
 
-// 直接上报（JSON 放进单个 key，默认 “日志内容”）
-clsLogger.putJson({ event: 'click', x: 1, y: 2 });
+默认开启 HTTP 请求监控。
 
-// 入队（写入 localStorage，默认 15 条自动 flush）
-clsLogger.enqueue({ event: 'page_view', page: '/home' });
+- Web: 拦截 `fetch` / `XMLHttpRequest`
+- 小程序: 拦截 `wx.request` / `wx.cloud.callFunction`
+
+如需关闭或配置：
+
+```ts
+clsLogger.init({
+  requestMonitor: {
+    enabled: true,
+    ignoreUrls: ['example.com', /login/], // 忽略特定 URL
+  },
+});
 ```
 
-## 请求监控（requestMonitor）
+### 3. 性能监控 (Performance Monitor)
+
+默认开启性能指标采集。
+
+- Web: 采集 FCP, LCP, CLS, FID 等 Core Web Vitals 及资源加载耗时。
+- 小程序: 暂不支持性能指标自动采集。
 
-初始化后默认会开启 HTTP 请求监控（Web/H5：`fetch`/`XMLHttpRequest`；小程序：`wx.request`/`cloud.callFunction`），并把请求信息通过 `track('http', payload)` 上报。
+### 4. 行为埋点 (Behavior Monitor)
 
-- **关闭**：`clsLogger.init({ requestMonitor: false })`
-- **忽略上报请求避免递归**：默认会忽略 CLS 上报域名（会把 `endpoint` 自动加入 `ignoreUrls`），并在内部增加了“上报发送”保护，避免上报请求在跨域失败时出现递归上报/死循环。
-- **自定义忽略**：`clsLogger.init({ requestMonitor: { ignoreUrls: ['example.com', /\\/internal\\//] } })`
+默认开启，支持 PV (Page View) 和 UV (User View) 自动上报。
 
-## 性能监控（performanceMonitor）
+- 自动生成/持久化 UV ID。
+- 支持点击事件自动上报（需配置）。
 
-初始化后默认会开启性能监控，并通过 `track('perf', payload)` 上报，包含：
+## 高级用法
 
-- **Web Vitals**：FCP/LCP/CLS/FID
-- **Navigation Timing**：TTFB 等
-- **Resource Timing**：资源加载耗时（`PerformanceObserver({ type: 'resource', buffered: true })`，首屏会比较多）
+### 手动注入 SDK
 
-常见降噪配置：
+在某些特殊构建环境（如某些不允许动态 require 的小程序框架）下，如果自动加载 SDK 失败，可以手动注入：
 
 ```ts
 import clsLogger from '@be-link/cls-logger';
+import * as MiniSdk from 'tencentcloud-cls-sdk-js-mini';
 
 clsLogger.init({
   topic_id: 'xxx',
-  projectName: 'my-project',
-  performanceMonitor: {
-    // 降低采样（0~1）
-    sampleRate: 0.1,
-    // 忽略本地开发资源 & sourcemap（按你的资源特征调整）
-    ignoreUrls: ['localhost:8080', /\\.map$/],
-  },
-  // 可选：启动阶段合并窗口，减少首屏 perf/resource 被 intervalMs 拆成多次上报
-  // batch: { startupDelayMs: 2000 },
+  sdk: MiniSdk, // 手动传入 SDK 实例
 });
 ```

package/dist/ClsLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClsLogger.d.ts","sourceRoot":"","sources":["../src/ClsLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,aAAa;cAC1B,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;CA8EjD"}
+{"version":3,"file":"ClsLogger.d.ts","sourceRoot":"","sources":["../src/ClsLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,aAAa;cAC1B,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;CAkHjD"}

package/dist/ClsLoggerCore.d.ts

@@ -101,9 +101,9 @@ export declare abstract class ClsLoggerCore {
      */
     report(log: ReportLog): void;
     private getDesiredBatchFlushDueAt;
-    info(message: string, data?: FlatFields): void;
-    warn(message: string, data?: FlatFields): void;
-    error(message: string, data?: FlatFields): void;
+    info(message: string | Error, data?: FlatFields): void;
+    warn(message: string | Error, data?: FlatFields): void;
+    error(message: string | Error, data?: FlatFields): void;
     track(trackType: string, data?: FlatFields): void;
     /**
      * 立即发送内存队列

package/dist/ClsLoggerCore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClsLoggerCore.d.ts","sourceRoot":"","sources":["../src/ClsLoggerCore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ClsLoggerCore.d.ts","sourceRoot":"","sources":["../src/ClsLoggerCore.ts"],"names":[],"mappings":"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"}

package/dist/behaviorMonitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"behaviorMonitor.d.ts","sourceRoot":"","sources":["../src/behaviorMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG3E,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;AA8FzD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,sBAA2B,GACnC,MAAM,IAAI,CA4WZ"}
+{"version":3,"file":"behaviorMonitor.d.ts","sourceRoot":"","sources":["../src/behaviorMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG3E,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;AA8FzD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,sBAA2B,GACnC,MAAM,IAAI,CAiXZ"}

package/dist/errorMonitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorMonitor.d.ts","sourceRoot":"","sources":["../src/errorMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG/D,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;AA6RzD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAE,OAAO,GAAG,mBAAmB,GAAG,SAAc,GAAG,IAAI,CAqBhH"}
+{"version":3,"file":"errorMonitor.d.ts","sourceRoot":"","sources":["../src/errorMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG/D,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;AA8SzD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAE,OAAO,GAAG,mBAAmB,GAAG,SAAc,GAAG,IAAI,CAqBhH"}

package/dist/index.esm.js

@@ -558,6 +558,19 @@ function getPagePath$1() {
         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;
@@ -717,6 +730,7 @@ function installMiniProgramErrorMonitor(report, options) {
                         return;
                     const e = normalizeErrorLike(msg, options.maxTextLength);
                     const payload = {
+                        pagePath: getMpPagePath(),
                         source: 'wx.onError',
                         message: e.message,
                         errorName: e.name,
@@ -743,6 +757,7 @@ function installMiniProgramErrorMonitor(report, options) {
                         return;
                     const e = normalizeErrorLike(res?.reason, options.maxTextLength);
                     const payload = {
+                        pagePath: getMpPagePath(),
                         source: 'wx.onUnhandledRejection',
                         message: e.message,
                         errorName: e.name,
@@ -774,6 +789,7 @@ function installMiniProgramErrorMonitor(report, options) {
                         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,
@@ -797,6 +813,7 @@ function installMiniProgramErrorMonitor(report, options) {
                             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,
@@ -1084,140 +1101,68 @@ function installBrowserPerformanceMonitor(report, options) {
         }
     }
 }
-function wrapMiniProgramRouteApi(report, reportType, apiName, options) {
-    const wxAny = globalThis.wx;
-    if (!wxAny || typeof wxAny[apiName] !== 'function')
-        return;
-    const flagKey = `__beLinkClsLoggerMpRouteWrapped__${apiName}`;
-    if (wxAny[flagKey])
-        return;
-    wxAny[flagKey] = true;
-    const raw = wxAny[apiName].bind(wxAny);
-    wxAny[apiName] = (opts) => {
-        const start = Date.now();
-        const url = opts?.url ? String(opts.url) : '';
-        const wrapCb = (cb, success) => {
-            return (...args) => {
-                try {
-                    if (sampleHit(options.sampleRate)) {
-                        report(reportType, {
-                            metric: 'route',
-                            api: apiName,
-                            url,
-                            duration: Date.now() - start,
-                            success: success ? 1 : 0,
-                            error: success ? '' : truncate$1(stringifyLogValue(args?.[0]), options.maxTextLength),
-                            unit: 'ms',
-                        });
-                    }
-                }
-                catch {
-                    // ignore
-                }
-                if (typeof cb === 'function')
-                    return cb(...args);
-                return undefined;
-            };
-        };
-        const next = { ...(opts ?? {}) };
-        next.success = wrapCb(next.success, true);
-        next.fail = wrapCb(next.fail, false);
-        return raw(next);
-    };
-}
-function installMiniProgramPageRenderMonitor(report, reportType, options) {
-    const g = globalThis;
-    if (typeof g.Page !== 'function')
-        return;
-    if (g.__beLinkClsLoggerPageWrapped__)
-        return;
-    g.__beLinkClsLoggerPageWrapped__ = true;
-    const rawPage = g.Page;
-    g.Page = (pageOptions) => {
-        const next = { ...(pageOptions ?? {}) };
-        const rawOnLoad = next.onLoad;
-        const rawOnReady = next.onReady;
-        next.onLoad = function (...args) {
-            try {
-                this.__beLinkClsLoggerPageLoadTs__ = Date.now();
-            }
-            catch {
-                // ignore
-            }
-            if (typeof rawOnLoad === 'function')
-                return rawOnLoad.apply(this, args);
-            return undefined;
-        };
-        next.onReady = function (...args) {
-            try {
-                const start = this.__beLinkClsLoggerPageLoadTs__;
-                if (typeof start === 'number' && sampleHit(options.sampleRate)) {
-                    report(reportType, {
-                        metric: 'page-render',
-                        route: this?.route ? String(this.route) : '',
-                        duration: Date.now() - start,
-                        unit: 'ms',
-                    });
-                }
-            }
-            catch {
-                // ignore
-            }
-            if (typeof rawOnReady === 'function')
-                return rawOnReady.apply(this, args);
-            return undefined;
-        };
-        return rawPage(next);
-    };
-}
 function installMiniProgramPerformanceMonitor(report, options) {
     const g = globalThis;
+    const ctx = g.wx || g.Taro;
+    if (!ctx || typeof ctx.getPerformance !== 'function')
+        return;
     if (g.__beLinkClsLoggerMpPerfInstalled__)
         return;
     g.__beLinkClsLoggerMpPerfInstalled__ = true;
-    // 路由切换耗时（用 API 回调近似）
-    for (const apiName of ['navigateTo', 'redirectTo', 'switchTab', 'reLaunch']) {
-        try {
-            wrapMiniProgramRouteApi(report, options.reportType, apiName, options);
-        }
-        catch {
-            // ignore
-        }
-    }
-    // 页面渲染耗时（onLoad -> onReady）
     try {
-        installMiniProgramPageRenderMonitor(report, options.reportType, options);
-    }
-    catch {
-        // ignore
-    }
-    // wx.getPerformance()（若可用，尝试读取已有 entries）
-    try {
-        const wxAny = globalThis.wx;
-        if (wxAny && typeof wxAny.getPerformance === 'function') {
-            const perf = wxAny.getPerformance();
-            if (perf && isPlainObject(perf)) {
-                // 不同基础库实现差异较大：尽量容错
-                setTimeout(() => {
-                    try {
-                        if (!sampleHit(options.sampleRate))
-                            return;
-                        const entries = typeof perf.getEntries === 'function'
-                            ? perf.getEntries()
-                            : typeof perf.getEntriesByType === 'function'
-                                ? perf.getEntriesByType('navigation')
-                                : [];
+        const perf = ctx.getPerformance();
+        if (!perf || typeof perf.createObserver !== 'function')
+            return;
+        const observer = perf.createObserver((entryList) => {
+            try {
+                const entries = entryList.getEntries();
+                for (const entry of entries) {
+                    if (!sampleHit(options.sampleRate))
+                        continue;
+                    // Page Render: firstRender
+                    if (entry.entryType === 'render' && entry.name === 'firstRender') {
+                        const duration = typeof entry.duration === 'number'
+                            ? entry.duration
+                            : typeof entry.startTime === 'number' && typeof entry.endTime === 'number'
+                                ? entry.endTime - entry.startTime
+                                : 0;
                         report(options.reportType, {
-                            metric: 'mp-performance',
-                            entries: truncate$1(stringifyLogValue(entries), options.maxTextLength),
+                            metric: 'page-render',
+                            duration,
+                            pagePath: entry.path || '',
+                            unit: 'ms',
                         });
                     }
-                    catch {
-                        // ignore
+                    // Route Switch: route
+                    else if (entry.entryType === 'navigation' && entry.name === 'route') {
+                        const duration = typeof entry.duration === 'number'
+                            ? entry.duration
+                            : typeof entry.startTime === 'number' && typeof entry.endTime === 'number'
+                                ? entry.endTime - entry.startTime
+                                : 0;
+                        report(options.reportType, {
+                            metric: 'route',
+                            duration,
+                            pagePath: entry.path || '',
+                            unit: 'ms',
+                        });
                     }
-                }, 0);
+                    // 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
@@ -1541,7 +1486,7 @@ function installBehaviorMonitor(report, envType, options = {}) {
             const tag = (el.tagName || '').toLowerCase();
             const trackId = getAttr(el, clickTrackIdAttr);
             // 过滤无效点击：白名单 tag + 没有 trackId
-            if (clickWhiteList.includes(tag) && !trackId)
+            if (clickWhiteList.includes(tag) || !trackId)
                 return;
             void uvStatePromise.then(({ uvId, meta }) => {
                 if (destroyed)
@@ -1582,8 +1527,12 @@ function installBehaviorMonitor(report, envType, options = {}) {
                 g.Page = function patchedPage(conf) {
                     const originalOnShow = conf?.onShow;
                     conf.onShow = function (...args) {
-                        if (pvEnabled)
-                            reportPv(getPagePath());
+                        if (pvEnabled) {
+                            const pagePath = getPagePath();
+                            if (pagePath?.length > 0) {
+                                reportPv(pagePath);
+                            }
+                        }
                         return typeof originalOnShow === 'function' ? originalOnShow.apply(this, args) : undefined;
                     };
                     // 点击：wrap 页面 methods（bindtap 等会调用到这里的 handler）
@@ -1967,9 +1916,14 @@ class ClsLoggerCore {
      * 子类可按需重写（默认检测 wx）
      */
     detectEnvType() {
-        const wxAny = globalThis.wx;
-        if (wxAny && typeof wxAny.getSystemInfoSync === 'function')
+        const g = globalThis;
+        // 微信、支付宝、字节跳动、UniApp 等小程序环境通常都有特定全局变量
+        if ((g.wx && typeof g.wx.getSystemInfoSync === 'function') ||
+            (g.my && typeof g.my.getSystemInfoSync === 'function') ||
+            (g.tt && typeof g.tt.getSystemInfoSync === 'function') ||
+            (g.uni && typeof g.uni.getSystemInfoSync === 'function')) {
             return 'miniprogram';
+        }
         return 'browser';
     }
     init(options) {
@@ -2342,15 +2296,57 @@ class ClsLoggerCore {
         return nowTs + this.batchIntervalMs;
     }
     info(message, data = {}) {
-        const payload = normalizeFlatFields({ message, ...data }, 'info');
+        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 = {}) {
-        const payload = normalizeFlatFields({ message, ...data }, 'warn');
+        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 = {}) {
-        const payload = normalizeFlatFields({ message, ...data }, 'error');
+        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 = {}) {
@@ -2572,38 +2568,78 @@ class ClsLogger extends ClsLoggerCore {
             }
         }
         const isMini = this.envType === 'miniprogram';
-        // 静态字面量，方便打包器识别（但在此兼容入口里，仍然可能被一起分析）
-        const WEB_SDK = 'tencentcloud-cls-sdk-js-web';
-        const MINI_SDK = 'tencentcloud-cls-sdk-js-mini';
-        // UMD（浏览器脚本）优先读全局变量
-        if (!isMini) {
+        // 3) 尝试 require / 全局变量
+        // Mini Program: 尝试直接 require
+        if (isMini) {
+            // 显式使用字面量 require，帮助打包工具识别依赖（尤其是 CJS 构建模式下）
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const req = typeof require === 'function' ? require('tencentcloud-cls-sdk-js-mini') : null;
+                const reqSdk = normalizeSdk(req);
+                if (reqSdk) {
+                    this.sdk = reqSdk;
+                    return reqSdk;
+                }
+            }
+            catch {
+                // ignore
+            }
+            // 尝试使用 tryRequire（作为补充）
+            const reqMod = tryRequire('tencentcloud-cls-sdk-js-mini');
+            const reqSdk = normalizeSdk(reqMod);
+            if (reqSdk) {
+                this.sdk = reqSdk;
+                return reqSdk;
+            }
+        }
+        else {
+            // Web: 优先读全局变量 (UMD)
             const g = readGlobal('tencentcloudClsSdkJsWeb');
             const sdk = normalizeSdk(g);
             if (sdk) {
                 this.sdk = sdk;
                 return sdk;
             }
+            // Web: 尝试 require
+            const reqMod = tryRequire('tencentcloud-cls-sdk-js-web');
+            const reqSdk = normalizeSdk(reqMod);
+            if (reqSdk) {
+                this.sdk = reqSdk;
+                return reqSdk;
+            }
+        }
+        // 4) 动态 import
+        // 使用字符串字面量，确保 Bundler 能正确识别并进行 Code Splitting
+        if (isMini) {
+            this.sdkPromise = import('tencentcloud-cls-sdk-js-mini')
+                .then((m) => {
+                const sdk = normalizeSdk(m);
+                if (!sdk)
+                    throw new Error(`ClsLogger.loadSdk: invalid sdk module for mini`);
+                this.sdk = sdk;
+                return sdk;
+            })
+                .catch((err) => {
+                this.sdkPromise = null;
+                console.error('[ClsLogger] Failed to load mini sdk:', err);
+                throw err;
+            });
+        }
+        else {
+            this.sdkPromise = import('tencentcloud-cls-sdk-js-web')
+                .then((m) => {
+                const sdk = normalizeSdk(m);
+                if (!sdk)
+                    throw new Error(`ClsLogger.loadSdk: invalid sdk module for web`);
+                this.sdk = sdk;
+                return sdk;
+            })
+                .catch((err) => {
+                this.sdkPromise = null;
+                console.error('[ClsLogger] Failed to load web sdk:', err);
+                throw err;
+            });
         }
-        // 尽量同步 require
-        const reqMod = tryRequire(isMini ? MINI_SDK : WEB_SDK);
-        const reqSdk = normalizeSdk(reqMod);
-        if (reqSdk) {
-            this.sdk = reqSdk;
-            return reqSdk;
-        }
-        // 动态 import
-        this.sdkPromise = (isMini ? import(MINI_SDK) : import(WEB_SDK))
-            .then((m) => {
-            const sdk = normalizeSdk(m);
-            if (!sdk)
-                throw new Error(`ClsLogger.loadSdk: invalid sdk module for ${isMini ? MINI_SDK : WEB_SDK}`);
-            this.sdk = sdk;
-            return sdk;
-        })
-            .catch((err) => {
-            this.sdkPromise = null;
-            throw err;
-        });
         return this.sdkPromise;
     }
 }