@be-link/cls-logger 1.0.1-beta.9 → 1.0.4

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,142 @@
 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',
-  projectName: 'my-project',
-  generateBaseFields: () => ({ env: 'prod', uid: 'u_1' }),
+  projectName: 'be-link-pandora',
+  appId: 'be-link-pandora',
+  appVersion: getCurrentVersion(),
+  envType: 'browser',
+  generateBaseFields: () => {
+    return {
+      userId: getUserInfo().id,
+      userName: getUserInfo().name,
+    };
+  },
+
+  performanceMonitor: {
+    ignoreUrls: ['http://localhost:3000'],
+  },
+  requestMonitor: {
+    ignoreUrls: ['http://localhost:3000'],
+  },
+  tencentCloud: {
+    endpoint: 'https://ap-shanghai.cls.tencentcs.com',
+    topicID: '17475bcd-6315-4b20-859c-e7b087fb3683',
+    retry_times: 3,
+    source: 'be-link-pandora',
+  },
+});
+
+// 开发日志： info warn  error 日志
+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)
+
+默认开启 HTTP 请求监控。
+
+- Web: 拦截 `fetch` / `XMLHttpRequest`
+- 小程序: 拦截 `wx.request` / `wx.cloud.callFunction`
+
+如需关闭或配置：
+
+```ts
+clsLogger.init({
+  requestMonitor: {
+    enabled: true,
+    ignoreUrls: ['example.com', /login/], // 忽略特定 URL
+  },
 });
+```
+
+### 3. 性能监控 (Performance Monitor)
+
+默认开启性能指标采集。
+
+- Web: 采集 FCP, LCP, CLS, FID 等 Core Web Vitals 及资源加载耗时。
+- 小程序: 暂不支持性能指标自动采集。
+
+### 4. 行为埋点 (Behavior Monitor)
+
+默认开启，支持 PV (Page View) 和 UV (User View) 自动上报。
+
+- 自动生成/持久化 UV ID。
+- 支持点击事件自动上报（需配置）。
+
+#### 自动上报点击事件（Click Tracking）
 
-// 直接上报（展开字段）
-clsLogger.put({ event: 'login', ok: true });
+SDK 会自动监听点击事件，并上报带有 `track-id` 的元素点击。
 
-// 直接上报（JSON 放进单个 key，默认 “日志内容”）
-clsLogger.putJson({ event: 'click', x: 1, y: 2 });
+**Web / H5**:
 
-// 入队（写入 localStorage，默认 15 条自动 flush）
-clsLogger.enqueue({ event: 'page_view', page: '/home' });
+在需要追踪的元素上添加 `data-track-id` 属性即可。
+
+```html
+<button data-track-id="submit_order_btn">提交订单</button>
+<div data-track-id="banner_ad">广告位</div>
 ```
 
-## 请求监控（requestMonitor）
+**小程序 (Mini Program)**:
 
-初始化后默认会开启 HTTP 请求监控（Web/H5：`fetch`/`XMLHttpRequest`；小程序：`wx.request`/`cloud.callFunction`），并把请求信息通过 `track('http', payload)` 上报。
+在组件上添加 `data-track-id` 属性。
 
-- **关闭**：`clsLogger.init({ requestMonitor: false })`
-- **忽略上报请求避免递归**：默认会忽略 CLS 上报域名（会把 `endpoint` 自动加入 `ignoreUrls`），并在内部增加了“上报发送”保护，避免上报请求在跨域失败时出现递归上报/死循环。
-- **自定义忽略**：`clsLogger.init({ requestMonitor: { ignoreUrls: ['example.com', /\\/internal\\//] } })`
+```html
+<view data-track-id="product_card" bindtap="onProductClick"> 商品卡片 </view>
+```
 
-## 性能监控（performanceMonitor）
+> **注意**：如果不设置 `data-track-id`，SDK 默认会忽略 `body`, `html` (Web) 或 `view`, `scroll-view` (小程序) 等容器标签的点击，避免产生大量无意义的点击日志。
 
-初始化后默认会开启性能监控，并通过 `track('perf', payload)` 上报，包含：
+你也可以自定义属性名（Web 默认为 `data-track-id`，小程序默认为 `data-trackId`）：
 
-- **Web Vitals**：FCP/LCP/CLS/FID
-- **Navigation Timing**：TTFB 等
-- **Resource Timing**：资源加载耗时（`PerformanceObserver({ type: 'resource', buffered: true })`，首屏会比较多）
+```ts
+clsLogger.init({
+  behaviorMonitor: {
+    clickTrackIdAttr: 'data-my-track-id', // Web 自定义属性名
+  },
+});
+```
+
+## 高级用法
+
+### 手动注入 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

@@ -21,6 +21,7 @@ export declare abstract class ClsLoggerCore {
     protected endpoint: string;
     protected retryTimes: number;
     protected source: string;
+    protected enabled: boolean;
     protected projectId: string;
     protected projectName: string;
     protected appId: string;
@@ -101,9 +102,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,
@@ -1104,18 +1121,28 @@ function installMiniProgramPerformanceMonitor(report, options) {
                         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: entry.duration,
+                            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: entry.duration,
+                            duration,
                             pagePath: entry.path || '',
                             unit: 'ms',
                         });
@@ -1459,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)
@@ -1500,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）
@@ -1855,6 +1886,7 @@ class ClsLoggerCore {
         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 = '';
@@ -1885,9 +1917,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) {
@@ -1925,6 +1962,7 @@ class ClsLoggerCore {
         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;
@@ -1941,15 +1979,17 @@ class ClsLoggerCore {
         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);
+        if (this.enabled) {
+            // 启动时尝试发送失败缓存
+            this.flushFailed();
+            // 初始化后立即启动请求监听
+            this.startRequestMonitor(options.requestMonitor);
+            // 初始化后立即启动错误监控/性能监控
+            this.startErrorMonitor(options.errorMonitor);
+            this.startPerformanceMonitor(options.performanceMonitor);
+            // 初始化后立即启动行为埋点（PV/UV/点击）
+            this.startBehaviorMonitor(options.behaviorMonitor);
+        }
     }
     getBaseFields() {
         let auto = undefined;
@@ -2074,6 +2114,8 @@ class ClsLoggerCore {
      * - 最终会把 fields 展开成 CLS 的 content（key/value 都会转成 string）
      */
     put(fields, options = {}) {
+        if (!this.enabled)
+            return;
         if (!fields)
             return;
         if (!this.topicId) {
@@ -2132,6 +2174,8 @@ class ClsLoggerCore {
      * - 埋点入参必须是一维（扁平）Object，非原始值会被 stringify
      */
     enqueue(fields, options = {}) {
+        if (!this.enabled)
+            return;
         if (!fields)
             return;
         const time = Date.now();
@@ -2170,6 +2214,8 @@ class ClsLoggerCore {
      * 批量上报（每条 item.data 展开为 log content）
      */
     putBatch(queue) {
+        if (!this.enabled)
+            return;
         if (!queue || queue.length === 0)
             return;
         if (!this.topicId) {
@@ -2213,6 +2259,8 @@ class ClsLoggerCore {
      * 参考《一、概述》：统一上报入口（内存队列 + 批量发送）
      */
     report(log) {
+        if (!this.enabled)
+            return;
         if (!log?.type)
             return;
         if (!this.topicId) {
@@ -2260,15 +2308,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 = {}) {
@@ -2375,6 +2465,8 @@ class ClsLoggerCore {
         writeStringStorage(this.failedCacheKey, JSON.stringify(next));
     }
     flushFailed() {
+        if (!this.enabled)
+            return;
         const raw = readStringStorage(this.failedCacheKey);
         if (!raw)
             return;
@@ -2490,38 +2582,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;
     }
 }