@rk911/tracker-sdk 1.7.16 → 1.7.18

package/index.js

@@ -1,529 +1,554 @@
-import { Tracker } from './core/tracker.js'
-import {
-  createDadianProxy,
-  createImpressionDirective,
-  createPageStayMixin,
-} from './core/compat.js'
-import { WebAdapter } from './platforms/web.js'
-import { WeappAdapter } from './platforms/weapp.js'
-import { AppAdapter } from './platforms/app.js'
-import { getProjectRules } from './customize/index.js'
-
-// 插件注册表
-import { PageViewPlugin } from './plugins/page-view.js'
-import { ClickPlugin } from './plugins/click.js'
-import { PageStayPlugin } from './plugins/page-stay.js'
-import { ExposurePlugin } from './plugins/exposure.js'
-import { JsErrorPlugin } from './plugins/js-error.js'
-import { ApiWatchPlugin } from './plugins/api-watch.js'
-import { AppLifecyclePlugin } from './plugins/app-lifecycle.js'
-import { PerformancePlugin } from './plugins/performance.js'
-import { ScrollDepthPlugin } from './plugins/scroll-depth.js'
-
-const PLUGIN_MAP = {
-  'page-view': PageViewPlugin,
-  click: ClickPlugin,
-  'page-stay': PageStayPlugin,
-  exposure: ExposurePlugin,
-  'js-error': JsErrorPlugin,
-  performance: PerformancePlugin,
-  'scroll-depth': ScrollDepthPlugin,
-  'api-watch': ApiWatchPlugin,
-  'app-lifecycle': AppLifecyclePlugin,
-}
-
-// 单例
-let trackerInstance = null
-
-/**
- * 自动检测当前运行平台
- */
-function detectPlatform() {
-  try {
-    if (
-      typeof wx !== 'undefined' &&
-      typeof wx.getSystemInfoSync === 'function' &&
-      typeof document === 'undefined'
-    ) {
-      return 'weapp'
-    }
-  } catch (e) {}
-
-  if (typeof window !== 'undefined' && typeof document !== 'undefined') {
-    return 'web'
-  }
-
-  return 'web'
-}
-
-/**
- * 创建平台适配器
- */
-function createAdapter(platform, config) {
-  switch (platform) {
-    case 'weapp':
-      return new WeappAdapter(config)
-    case 'app':
-      return new AppAdapter(config)
-    default:
-      return new WebAdapter(config)
-  }
-}
-
-/**
- * 创建 Tracker 实例
- */
-export function createTracker(config) {
-  if (trackerInstance) {
-    trackerInstance.destroy()
-  }
-
-  var platform = config.platform || detectPlatform()
-  config.platform = platform
-
-  // 自动加载项目定制规则（未显式传入时按 appId 匹配）
-  if (!config.projectRules && config.appId) {
-    config.projectRules = getProjectRules(config.appId)
-  }
-
-  var adapter = createAdapter(platform, config)
-  trackerInstance = new Tracker(config, adapter)
-
-  // 触发 onBeforeInit 钩子（必须在插件注册与首屏事件触发前执行，以便同步/异步注入 Native 上下文）
-  if (typeof config.onBeforeInit === 'function') {
-    try {
-      config.onBeforeInit(trackerInstance)
-    } catch (e) {
-      console.warn('[TrackerSDK] onBeforeInit error:', e)
-    }
-  }
-
-  // 注册插件
-  var pluginNames = config.plugins || []
-  pluginNames.forEach(function (pluginName) {
-    var PluginClass = null
-
-    if (typeof pluginName === 'string') {
-      PluginClass = PLUGIN_MAP[pluginName]
-    } else if (typeof pluginName === 'function') {
-      PluginClass = pluginName
-    } else if (pluginName && typeof pluginName.install === 'function') {
-      // 直接传入插件实例
-      trackerInstance.use(pluginName)
-      return
-    }
-
-    if (PluginClass) {
-      trackerInstance.use(new PluginClass())
-    }
-  })
-
-  return trackerInstance
-}
-
-/**
- * 获取当前 Tracker 单例
- */
-export function getTracker() {
-  return trackerInstance
-}
-
-/**
- * 设备注册 — 无 deviceId 时调用后端接口获取，失败重试最多 3 次
- */
-function registerDeviceIfNeeded(tracker) {
-  var adapter = tracker.getAdapter()
-  var config = tracker.getConfig()
-  var session = tracker.getSession()
-
-  // 如果是由 App/Native 动态注入的临时 DeviceID，跳过 H5 本地注册逻辑
-  if (session.isNativeDeviceId && session.getDeviceId()) {
-    return
-  }
-
-  var existingId = session.getDeviceId() || adapter.getStorage('deviceId') || adapter.getStorage('_tracker_device_id')
-  if (existingId) {
-    tracker.setDeviceId(existingId)
-    return
-  }
-
-  // [PROJECT-ADAPT] appId 默认值
-  // 店长端 appId=1, apph5 appId=12/13, 小程序 appId=18
-  // 各项目在初始化时传入自己的 appId，此处 ||1 为兜底
-  var deviceInfo = { appId: Number(config.appId) || 1, id: '' }
-  if (typeof adapter.getDetailedDeviceInfo === 'function') {
-    Object.assign(deviceInfo, adapter.getDetailedDeviceInfo())
-  }
-
-  // [PROJECT-ADAPT] 设备注册请求头
-  // 当前网关要求 appId/deviceId 作为自定义 header
-  var header = { 'content-type': 'application/json', appId: String(config.appId), deviceId: '' }
-  if (typeof config.getAuthHeaders === 'function') {
-    Object.assign(header, config.getAuthHeaders() || {})
-  }
-
-  var registerUrl = config.dadianUrl + (config.deviceRegister.url || '/api/point/device/add')
-  var maxRetries = 3
-
-  function attempt(retryCount) {
-    adapter
-      .request({ method: 'POST', url: registerUrl, data: deviceInfo, header: header })
-      .then(function (res) {
-        if (res && res.data && res.data.code === 0 && res.data.data) {
-          adapter.setStorage('deviceId', res.data.data)
-          tracker.setDeviceId(res.data.data)
-          if (config.debug) {
-            console.log('[TrackerSDK] device registered:', res.data.data)
-          }
-        } else if (retryCount < maxRetries) {
-          var delay = 1000 * Math.pow(2, retryCount)
-          setTimeout(function () { attempt(retryCount + 1) }, delay)
-          if (config.debug) {
-            console.warn('[TrackerSDK] device register bad response, retry ' + (retryCount + 1) + '/' + maxRetries + ' in ' + delay + 'ms')
-          }
-        }
-      })
-      .catch(function (err) {
-        if (retryCount < maxRetries) {
-          var delay = 1000 * Math.pow(2, retryCount)
-          setTimeout(function () { attempt(retryCount + 1) }, delay)
-          if (config.debug) {
-            console.warn('[TrackerSDK] device register failed, retry ' + (retryCount + 1) + '/' + maxRetries + ' in ' + delay + 'ms')
-          }
-        } else if (config.debug) {
-          console.warn('[TrackerSDK] device register failed after ' + maxRetries + ' retries:', err)
-        }
-      })
-  }
-
-  attempt(0)
-}
-
-function _parseJwtPayload(token) {
-  if (!token || typeof token !== 'string' || token.indexOf('.') === -1) return null
-  try {
-    var tokenParts = token.split('.')
-    if (tokenParts.length >= 2) {
-      var base64Url = tokenParts[1]
-      var base64 = base64Url.replace(/-/g, '+').replace(/_/g, '/')
-      var decodedStr = ''
-      if (typeof atob === 'function') {
-        try {
-          decodedStr = decodeURIComponent(escape(atob(base64)))
-        } catch (e1) {
-          decodedStr = atob(base64)
-        }
-      } else if (typeof Buffer !== 'undefined') {
-        decodedStr = Buffer.from(base64, 'base64').toString('utf-8')
-      }
-      if (decodedStr) {
-        return JSON.parse(decodedStr)
-      }
-    }
-  } catch (e) {}
-  return null
-}
-
-/**
- * 自动检测 userId：多源交叉读取，并确保不把已有的合法身份置空
- */
-function _ensureUserId(tracker) {
-  var session = tracker.getSession()
-  // 若当前 userId 由 Native 容器强行注入（跨端会话），H5 端的 Cookie/Storage 绝不覆盖
-  if (session.isNativeUserId && session.getUserId()) {
-    return
-  }
-
-  var adapter = tracker.getAdapter()
-  var uid = null
-
-  // 1. 跨端 NativeBridge 同步上下文优先（如果运行在 Android/iOS WebView 中）
-  if (typeof window !== 'undefined' && window.NativeBridge && typeof window.NativeBridge.getNativeContextSync === 'function') {
-    try {
-      var nativeRaw = window.NativeBridge.getNativeContextSync()
-      if (nativeRaw) {
-        var nativeCtx = typeof nativeRaw === 'string' ? JSON.parse(nativeRaw) : nativeRaw
-        if (nativeCtx && nativeCtx.userId) {
-          uid = String(nativeCtx.userId)
-        }
-        if (nativeCtx && nativeCtx.currentSequence) {
-          session.setInitialSequence(Number(nativeCtx.currentSequence))
-        }
-      }
-    } catch (e) {}
-  }
-
-  // 2. URL query 跨端注入参数兜底
-  if (!uid && typeof window !== 'undefined' && window.location && window.location.search) {
-    try {
-      var search = window.location.search
-      var matchSeq = search.match(/[?&]_trk_seq=([^&]+)/)
-      if (matchSeq) {
-        session.setInitialSequence(Number(decodeURIComponent(matchSeq[1])))
-      }
-      var matchUid = search.match(/[?&]_trk_userId=([^&]+)/)
-      if (matchUid) {
-        uid = decodeURIComponent(matchUid[1])
-      }
-    } catch (e) {}
-  }
-
-  // 3. 存储单字段：userId / unionid / _tracker_user_id
-  if (!uid) {
-    uid = adapter.getStorage('userId')
-      || adapter.getStorage('unionid')
-      || adapter.getStorage('_tracker_user_id')
-  }
-
-  // 4. 读取 userInfo 复合对象
-  if (!uid) {
-    try {
-      var rawInfo = adapter.getStorage('userInfo')
-      if (rawInfo) {
-        var info = typeof rawInfo === 'string' ? JSON.parse(rawInfo) : rawInfo
-        if (info && typeof info === 'object') {
-          uid = info.userId || info.unionid || info.id || info.uid
-        }
-      }
-    } catch (e) {}
-  }
-
-  // 5. Cookie 兜底：rkfeb-userId 或 static-c-token (JWT payload)
-  if (!uid && typeof document !== 'undefined') {
-    try {
-      var matchCookieUid = document.cookie.match(/(?:^|;\s*)rkfeb-userId=([^;]+)/)
-      if (matchCookieUid) uid = decodeURIComponent(matchCookieUid[1])
-
-      if (!uid) {
-        var matchCookieToken = document.cookie.match(/(?:^|;\s*)(?:token|static-c-token|appToken)=([^;]+)/)
-        if (matchCookieToken) {
-          var payloadCookie = _parseJwtPayload(decodeURIComponent(matchCookieToken[1]))
-          if (payloadCookie) {
-            uid = payloadCookie.unionid || payloadCookie.userId || payloadCookie.uid || payloadCookie.sub
-          }
-        }
-      }
-    } catch (e) {}
-  }
-
-  // 6. JWT Token 存储兜底：token / Token / appToken / rsc-token / rsb-token
-  if (!uid) {
-    var tokenKeys = ['token', 'Token', 'appToken', 'rsc-token', 'rsb-token']
-    for (var i = 0; i < tokenKeys.length; i++) {
-      var tokenVal = adapter.getStorage(tokenKeys[i])
-      if (tokenVal) {
-        var payload = _parseJwtPayload(tokenVal)
-        if (payload) {
-          uid = payload.unionid || payload.userId || payload.uid || payload.sub
-          if (uid) break
-        }
-      }
-    }
-  }
-
-  // 7. 防误置空核心保护：只有获取到有效非空 uid 才更新
-  var currentUid = session.getUserId()
-  if (uid && String(uid) !== String(currentUid)) {
-    tracker.setUser(String(uid))
-  }
-}
-
-/**
- * Vue.use 插件入口
- *
- * 用法：
- *   import TrackerSDK from './tracker-sdk/index.js'
- *   Vue.use(TrackerSDK, {
- *     appId: '1',
- *     dadianUrl: 'https://state.renruikeji.cn',
- *     platform: 'web',
- *     tokenKey: 'token',
- *     plugins: ['page-view', 'click', 'page-stay', 'js-error', 'app-lifecycle', 'api-watch', 'scroll-depth'],
- *     legacy: true,
- *     getAuthHeaders: () => ({ Authorization: orgToken, token: orgToken }),
- *   })
- */
-function install(Vue, options) {
-  if (install._installed) return
-  install._installed = true
-
-  var tracker = createTracker(options || {})
-
-  // 0. 暴露 tracker 实例到 window（供原生容器及验证脚本访问）
-  if (typeof window !== 'undefined') {
-    window.__tracker = tracker
-    window.__tracker_pauseStay = function () { tracker.pausePageStay() }
-    window.__tracker_resumeStay = function () { tracker.resumePageStay() }
-  }
-
-  // 0.1 设备注册（无 deviceId 时自动注册）
-  registerDeviceIfNeeded(tracker)
-
-  // 0.2 自动检测 userId（从 Cookie 或 storage 中读取已登录用户）
-  _ensureUserId(tracker)
-
-  // 0.3 注册 userId 刷新钩子：每次 flush 前从 storage 实时读取，
-  // 避免自动事件（page_view/click）在 userId 更新前用旧值发出
-  tracker.getQueue().setRefreshUserId(function () {
-    _ensureUserId(tracker)
-  })
-
-  // 1. 注册 $dadian（兼容现有所有业务调用）
-  var _rawDadian = createDadianProxy(tracker)
-  Vue.prototype.$dadian = function (frontUrl, postParam) {
-    _ensureUserId(tracker)
-    return _rawDadian(frontUrl, postParam)
-  }
-
-  // 2. 注册 $track（统一的上报方法，替代 $dadian）
-  // 行为与 $dadian 完全一致：第一个参数直接作为 frontUrl，不做任何路由拼接
-  Vue.prototype.$track = function (frontUrl, postParam) {
-    _ensureUserId(tracker)
-
-    // postParam 处理（与 $dadian 一致）
-    var postParamStr = ''
-    if (postParam && Object.keys(postParam).length > 0) {
-      var config = tracker.getConfig()
-      if (config.platform === 'weapp' && config.eventBus) {
-        var bus = config.eventBus
-        postParamStr = JSON.stringify(Object.assign({}, postParam, {
-          wxAppOnLaunch: bus.wxAppOnLaunch,
-          pageFrom: bus.pageFrom,
-          mallOrderExt: bus.mallOrderExt,
-        }))
-      } else {
-        postParamStr = JSON.stringify(postParam)
-      }
-    }
-
-    // 开关关（默认）：旧接口也报一次（与 $dadian 一致）
-    var config = tracker.getConfig()
-    if (!config.useUnifiedReport) {
-      var header = { 'content-type': 'application/json' }
-      var hasLegacyAuth = false
-      if (typeof config.getAuthHeaders === 'function') {
-        var authHeaders = config.getAuthHeaders() || {}
-        if (authHeaders.Authorization || authHeaders.token || authHeaders['rsb-token']) {
-          hasLegacyAuth = true
-          Object.assign(header, authHeaders)
-        }
-      }
-      if (hasLegacyAuth) {
-        tracker.getQueue().pushLegacy(
-          config.dadianUrl + '/api/point/task/activeReport',
-          { frontUrl: frontUrl, postParam: postParamStr },
-          header
-        )
-      }
-    }
-
-    // SDK 事件入队（始终走）
-    tracker.track('custom', {
-      eventName: frontUrl || 'manual',
-      frontUrl: frontUrl,
-      postParam: postParamStr,
-      extraData: postParam,
-      elementId: frontUrl,
-    })
-
-    // 项目定制：从 footer 导航类 frontUrl 中提取目标路由，
-    // 在 track() 之后更新 referrer 链（确保目标页事件能拿到正确来源页）
-    // 必须在 track 之后：否则当前事件的 referrer 会被提前污染
-    var rules = config.projectRules
-    if (rules && typeof rules.extractNavTarget === 'function') {
-      var navTarget = rules.extractNavTarget(null, frontUrl)
-      if (navTarget) {
-        tracker.updatePageRoute(navTarget)
-      }
-    }
-  }
-
-  // 3. 注册 $tracker 实例引用（含 resetSession 供登出时调用）
-  Vue.prototype.$tracker = tracker
-  Vue.prototype.$trackerResetSession = function () {
-    tracker.getSession().resetSession()
-    tracker.getQueue()._flushedEventIds.clear()
-  }
-
-  // 3.1 动态参数解析器快捷方式
-  Vue.prototype.$registerParam = function (name, fn) {
-    tracker.registerParam(name, fn)
-  }
-
-  // 4. 注册 v-impression 指令（兼容旧业务代码）
-  var adapter = tracker.getAdapter()
-  if (adapter.supportsIntersectionObserver()) {
-    Vue.directive('impression', createImpressionDirective(tracker))
-  }
-
-  // 5. 注册 v-track-exposure 指令（新的曝光指令，走自动采集链路）
-  var exposurePlugin = tracker.plugins.find(function (p) {
-    return p.name === 'exposure'
-  })
-  if (exposurePlugin && typeof exposurePlugin.createDirective === 'function') {
-    var trackExposureDirective = exposurePlugin.createDirective()
-    if (trackExposureDirective) {
-      Vue.directive('track-exposure', trackExposureDirective)
-    }
-  }
-
-  // 6. 注册页面停留 mixin
-  var hasPageStayPlugin = (options.plugins || []).some(function (p) {
-    return p === 'page-stay' || (p && p.name === 'page-stay')
-  })
-  if (hasPageStayPlugin) {
-    Vue.mixin(createPageStayMixin(tracker))
-  }
-
-  // 7. 注册 Vue 错误捕获（组件 render/lifecycle/watch 中的异常）
-  var jsErrorPlugin = tracker.plugins.find(function (p) {
-    return p.name === 'js-error'
-  })
-  if (jsErrorPlugin) {
-    var _prevErrorHandler = Vue.config.errorHandler
-    Vue.config.errorHandler = function (err, vm, info) {
-      jsErrorPlugin.handleVueError(err, vm, info)
-      if (_prevErrorHandler) _prevErrorHandler.call(this, err, vm, info)
-    }
-  }
-
-  // [PROJECT-ADAPT] 小程序生命周期注册
-  // H5 端通过 history API 监听路由变化，小程序端通过 onShow/onHide
-  if (tracker.getConfig().platform === 'weapp') {
-    var pageViewPlugin = tracker.plugins.find(function (p) {
-      return p.name === 'page-view'
-    })
-    var lifecyclePlugin = tracker.plugins.find(function (p) {
-      return p.name === 'app-lifecycle'
-    })
-
-    Vue.mixin({
-      onShow: function () {
-        if (pageViewPlugin) {
-          pageViewPlugin.trackPageShow()
-        }
-        if (lifecyclePlugin) {
-          lifecyclePlugin.trackAppShow()
-        }
-      },
-      onHide: function () {
-        if (lifecyclePlugin) {
-          lifecyclePlugin.trackAppHide()
-        }
-      },
-    })
-  }
-}
-
-// 默认导出 Vue 插件对象
-export default {
-  install: install,
-  createTracker: createTracker,
-  getTracker: getTracker,
-}
-
-// 具名导出
-export { Tracker } from './core/tracker.js'
-export { WebAdapter } from './platforms/web.js'
-export { WeappAdapter } from './platforms/weapp.js'
-export { AppAdapter } from './platforms/app.js'
+import { Tracker } from './core/tracker.js'
+import {
+  createDadianProxy,
+  createImpressionDirective,
+  createPageStayMixin,
+} from './core/compat.js'
+import { WebAdapter } from './platforms/web.js'
+import { WeappAdapter } from './platforms/weapp.js'
+import { AppAdapter } from './platforms/app.js'
+import { getProjectRules } from './customize/index.js'
+
+// 插件注册表
+import { PageViewPlugin } from './plugins/page-view.js'
+import { ClickPlugin } from './plugins/click.js'
+import { PageStayPlugin } from './plugins/page-stay.js'
+import { ExposurePlugin } from './plugins/exposure.js'
+import { JsErrorPlugin } from './plugins/js-error.js'
+import { ApiWatchPlugin } from './plugins/api-watch.js'
+import { AppLifecyclePlugin } from './plugins/app-lifecycle.js'
+import { PerformancePlugin } from './plugins/performance.js'
+import { ScrollDepthPlugin } from './plugins/scroll-depth.js'
+
+const PLUGIN_MAP = {
+  'page-view': PageViewPlugin,
+  click: ClickPlugin,
+  'page-stay': PageStayPlugin,
+  exposure: ExposurePlugin,
+  'js-error': JsErrorPlugin,
+  performance: PerformancePlugin,
+  'scroll-depth': ScrollDepthPlugin,
+  'api-watch': ApiWatchPlugin,
+  'app-lifecycle': AppLifecyclePlugin,
+}
+
+// 单例
+let trackerInstance = null
+
+/**
+ * 自动检测当前运行平台
+ */
+function detectPlatform() {
+  try {
+    if (
+      typeof wx !== 'undefined' &&
+      typeof wx.getSystemInfoSync === 'function' &&
+      typeof document === 'undefined'
+    ) {
+      return 'weapp'
+    }
+  } catch (e) {}
+
+  if (typeof window !== 'undefined' && typeof document !== 'undefined') {
+    return 'web'
+  }
+
+  return 'web'
+}
+
+/**
+ * 创建平台适配器
+ */
+function createAdapter(platform, config) {
+  switch (platform) {
+    case 'weapp':
+      return new WeappAdapter(config)
+    case 'app':
+      return new AppAdapter(config)
+    default:
+      return new WebAdapter(config)
+  }
+}
+
+/**
+ * 创建 Tracker 实例
+ */
+export function createTracker(config) {
+  if (trackerInstance) {
+    trackerInstance.destroy()
+  }
+
+  var platform = config.platform || detectPlatform()
+  config.platform = platform
+
+  // 自动加载项目定制规则（未显式传入时按 appId 匹配）
+  if (!config.projectRules && config.appId) {
+    config.projectRules = getProjectRules(config.appId)
+  }
+
+  var adapter = createAdapter(platform, config)
+  trackerInstance = new Tracker(config, adapter)
+
+  // 触发 onBeforeInit 钩子（必须在插件注册与首屏事件触发前执行，以便同步/异步注入 Native 上下文）
+  if (typeof config.onBeforeInit === 'function') {
+    try {
+      config.onBeforeInit(trackerInstance)
+    } catch (e) {
+      console.warn('[TrackerSDK] onBeforeInit error:', e)
+    }
+  }
+
+  // 注册插件
+  var pluginNames = config.plugins || []
+  pluginNames.forEach(function (pluginName) {
+    var PluginClass = null
+
+    if (typeof pluginName === 'string') {
+      PluginClass = PLUGIN_MAP[pluginName]
+    } else if (typeof pluginName === 'function') {
+      PluginClass = pluginName
+    } else if (pluginName && typeof pluginName.install === 'function') {
+      // 直接传入插件实例
+      trackerInstance.use(pluginName)
+      return
+    }
+
+    if (PluginClass) {
+      trackerInstance.use(new PluginClass())
+    }
+  })
+
+  return trackerInstance
+}
+
+/**
+ * 获取当前 Tracker 单例
+ */
+export function getTracker() {
+  return trackerInstance
+}
+
+/**
+ * 设备注册 — 无 deviceId 时调用后端接口获取，失败重试最多 3 次
+ */
+function registerDeviceIfNeeded(tracker) {
+  var adapter = tracker.getAdapter()
+  var config = tracker.getConfig()
+  var session = tracker.getSession()
+
+  // 如果是由 App/Native 动态注入的临时 DeviceID，跳过 H5 本地注册逻辑
+  if (session.isNativeDeviceId && session.getDeviceId()) {
+    return
+  }
+
+  var existingId = session.getDeviceId() || adapter.getStorage('deviceId') || adapter.getStorage('_tracker_device_id')
+  if (existingId) {
+    tracker.setDeviceId(existingId)
+    return
+  }
+
+  // [PROJECT-ADAPT] appId 默认值
+  // 店长端 appId=1, apph5 appId=12/13, 小程序 appId=18
+  // 各项目在初始化时传入自己的 appId，此处 ||1 为兜底
+  var deviceInfo = { appId: Number(config.appId) || 1, id: '' }
+  if (typeof adapter.getDetailedDeviceInfo === 'function') {
+    Object.assign(deviceInfo, adapter.getDetailedDeviceInfo())
+  }
+
+  // [PROJECT-ADAPT] 设备注册请求头
+  // 当前网关要求 appId/deviceId 作为自定义 header
+  var header = { 'content-type': 'application/json', appId: String(config.appId), deviceId: '' }
+  if (typeof config.getAuthHeaders === 'function') {
+    Object.assign(header, config.getAuthHeaders() || {})
+  }
+
+  var registerUrl = config.dadianUrl + (config.deviceRegister.url || '/api/point/device/add')
+  var maxRetries = 3
+
+  function attempt(retryCount) {
+    adapter
+      .request({ method: 'POST', url: registerUrl, data: deviceInfo, header: header })
+      .then(function (res) {
+        if (res && res.data && res.data.code === 0 && res.data.data) {
+          adapter.setStorage('deviceId', res.data.data)
+          tracker.setDeviceId(res.data.data)
+          if (config.debug) {
+            console.log('[TrackerSDK] device registered:', res.data.data)
+          }
+        } else if (retryCount < maxRetries) {
+          var delay = 1000 * Math.pow(2, retryCount)
+          setTimeout(function () { attempt(retryCount + 1) }, delay)
+          if (config.debug) {
+            console.warn('[TrackerSDK] device register bad response, retry ' + (retryCount + 1) + '/' + maxRetries + ' in ' + delay + 'ms')
+          }
+        }
+      })
+      .catch(function (err) {
+        if (retryCount < maxRetries) {
+          var delay = 1000 * Math.pow(2, retryCount)
+          setTimeout(function () { attempt(retryCount + 1) }, delay)
+          if (config.debug) {
+            console.warn('[TrackerSDK] device register failed, retry ' + (retryCount + 1) + '/' + maxRetries + ' in ' + delay + 'ms')
+          }
+        } else if (config.debug) {
+          console.warn('[TrackerSDK] device register failed after ' + maxRetries + ' retries:', err)
+        }
+      })
+  }
+
+  attempt(0)
+}
+
+function _parseJwtPayload(token) {
+  if (!token || typeof token !== 'string' || token.indexOf('.') === -1) return null
+  try {
+    var tokenParts = token.split('.')
+    if (tokenParts.length >= 2) {
+      var base64Url = tokenParts[1]
+      var base64 = base64Url.replace(/-/g, '+').replace(/_/g, '/')
+      var decodedStr = ''
+      if (typeof atob === 'function') {
+        try {
+          decodedStr = decodeURIComponent(escape(atob(base64)))
+        } catch (e1) {
+          decodedStr = atob(base64)
+        }
+      } else if (typeof Buffer !== 'undefined') {
+        decodedStr = Buffer.from(base64, 'base64').toString('utf-8')
+      }
+      if (decodedStr) {
+        return JSON.parse(decodedStr)
+      }
+    }
+  } catch (e) {}
+  return null
+}
+
+/**
+ * 自动检测 userId：多源交叉读取，并确保不把已有的合法身份置空
+ */
+function _ensureUserId(tracker) {
+  var session = tracker.getSession()
+
+  // 0. 跨端会话必须无条件同步序列号（无论是否已有 Native 用户身份，绝对不能被提前 return 阻断）
+  if (typeof window !== 'undefined') {
+    try {
+      if (window.location) {
+        var search = (window.location.search || '') + '&' + (window.location.hash || '')
+        var matchSeq = search.match(/[?&]_trk_seq=([^&]+)/)
+        if (matchSeq) {
+          session.setInitialSequence(Number(decodeURIComponent(matchSeq[1])))
+        }
+      }
+      if (window.NativeBridge && typeof window.NativeBridge.getNativeContextSync === 'function') {
+        var nativeRaw = window.NativeBridge.getNativeContextSync()
+        if (nativeRaw) {
+          var nativeCtx = typeof nativeRaw === 'string' ? JSON.parse(nativeRaw) : nativeRaw
+          if (nativeCtx && nativeCtx.currentSequence) {
+            session.setInitialSequence(Number(nativeCtx.currentSequence))
+          }
+        }
+      }
+    } catch (e) {}
+  }
+
+  // 若当前 userId 由 Native 容器强行注入（跨端会话），H5 端的 Cookie/Storage 绝不覆盖
+  if (session.isNativeUserId && session.getUserId()) {
+    return
+  }
+
+  var adapter = tracker.getAdapter()
+  var uid = null
+
+  // 1. 跨端 NativeBridge 同步上下文优先（如果运行在 Android/iOS WebView 中）
+  if (typeof window !== 'undefined' && window.NativeBridge && typeof window.NativeBridge.getNativeContextSync === 'function') {
+    try {
+      var nativeRaw = window.NativeBridge.getNativeContextSync()
+      if (nativeRaw) {
+        var nativeCtx = typeof nativeRaw === 'string' ? JSON.parse(nativeRaw) : nativeRaw
+        if (nativeCtx && nativeCtx.userId) {
+          uid = String(nativeCtx.userId)
+        }
+        if (nativeCtx && nativeCtx.currentSequence) {
+          session.setInitialSequence(Number(nativeCtx.currentSequence))
+        }
+      }
+    } catch (e) {}
+  }
+
+  // 2. URL query 跨端注入参数兜底（全面兼容标准 search 与 SPA Hash 路由后的 query）
+  if (typeof window !== 'undefined' && window.location) {
+    try {
+      var search = (window.location.search || '') + '&' + (window.location.hash || '')
+      var matchSeq = search.match(/[?&]_trk_seq=([^&]+)/)
+      if (matchSeq) {
+        session.setInitialSequence(Number(decodeURIComponent(matchSeq[1])))
+      }
+      if (!uid) {
+        var matchUid = search.match(/[?&]_trk_userId=([^&]+)/)
+        if (matchUid) {
+          uid = decodeURIComponent(matchUid[1])
+        }
+      }
+    } catch (e) {}
+  }
+
+  // 3. 存储单字段：userId / unionid / _tracker_user_id
+  if (!uid) {
+    uid = adapter.getStorage('userId')
+      || adapter.getStorage('unionid')
+      || adapter.getStorage('_tracker_user_id')
+  }
+
+  // 4. 读取 userInfo 复合对象
+  if (!uid) {
+    try {
+      var rawInfo = adapter.getStorage('userInfo')
+      if (rawInfo) {
+        var info = typeof rawInfo === 'string' ? JSON.parse(rawInfo) : rawInfo
+        if (info && typeof info === 'object') {
+          uid = info.userId || info.unionid || info.id || info.uid
+        }
+      }
+    } catch (e) {}
+  }
+
+  // 5. Cookie 兜底：rkfeb-userId 或 static-c-token (JWT payload)
+  if (!uid && typeof document !== 'undefined') {
+    try {
+      var matchCookieUid = document.cookie.match(/(?:^|;\s*)rkfeb-userId=([^;]+)/)
+      if (matchCookieUid) uid = decodeURIComponent(matchCookieUid[1])
+
+      if (!uid) {
+        var matchCookieToken = document.cookie.match(/(?:^|;\s*)(?:token|static-c-token|appToken)=([^;]+)/)
+        if (matchCookieToken) {
+          var payloadCookie = _parseJwtPayload(decodeURIComponent(matchCookieToken[1]))
+          if (payloadCookie) {
+            uid = payloadCookie.unionid || payloadCookie.userId || payloadCookie.uid || payloadCookie.sub
+          }
+        }
+      }
+    } catch (e) {}
+  }
+
+  // 6. JWT Token 存储兜底：token / Token / appToken / rsc-token / rsb-token
+  if (!uid) {
+    var tokenKeys = ['token', 'Token', 'appToken', 'rsc-token', 'rsb-token']
+    for (var i = 0; i < tokenKeys.length; i++) {
+      var tokenVal = adapter.getStorage(tokenKeys[i])
+      if (tokenVal) {
+        var payload = _parseJwtPayload(tokenVal)
+        if (payload) {
+          uid = payload.unionid || payload.userId || payload.uid || payload.sub
+          if (uid) break
+        }
+      }
+    }
+  }
+
+  // 7. 防误置空核心保护：只有获取到有效非空 uid 才更新
+  var currentUid = session.getUserId()
+  if (uid && String(uid) !== String(currentUid)) {
+    tracker.setUser(String(uid))
+  }
+}
+
+/**
+ * Vue.use 插件入口
+ *
+ * 用法：
+ *   import TrackerSDK from './tracker-sdk/index.js'
+ *   Vue.use(TrackerSDK, {
+ *     appId: '1',
+ *     dadianUrl: 'https://state.renruikeji.cn',
+ *     platform: 'web',
+ *     tokenKey: 'token',
+ *     plugins: ['page-view', 'click', 'page-stay', 'js-error', 'app-lifecycle', 'api-watch', 'scroll-depth'],
+ *     legacy: true,
+ *     getAuthHeaders: () => ({ Authorization: orgToken, token: orgToken }),
+ *   })
+ */
+function install(Vue, options) {
+  if (install._installed) return
+  install._installed = true
+
+  var tracker = createTracker(options || {})
+
+  // 0. 暴露 tracker 实例到 window（供原生容器及验证脚本访问）
+  if (typeof window !== 'undefined') {
+    window.__tracker = tracker
+    window.__tracker_pauseStay = function () { tracker.pausePageStay() }
+    window.__tracker_resumeStay = function () { tracker.resumePageStay() }
+  }
+
+  // 0.1 设备注册（无 deviceId 时自动注册）
+  registerDeviceIfNeeded(tracker)
+
+  // 0.2 自动检测 userId（从 Cookie 或 storage 中读取已登录用户）
+  _ensureUserId(tracker)
+
+  // 0.3 注册 userId 刷新钩子：每次 flush 前从 storage 实时读取，
+  // 避免自动事件（page_view/click）在 userId 更新前用旧值发出
+  tracker.getQueue().setRefreshUserId(function () {
+    _ensureUserId(tracker)
+  })
+
+  // 1. 注册 $dadian（兼容现有所有业务调用）
+  var _rawDadian = createDadianProxy(tracker)
+  Vue.prototype.$dadian = function (frontUrl, postParam) {
+    _ensureUserId(tracker)
+    return _rawDadian(frontUrl, postParam)
+  }
+
+  // 2. 注册 $track（统一的上报方法，替代 $dadian）
+  // 行为与 $dadian 完全一致：第一个参数直接作为 frontUrl，不做任何路由拼接
+  Vue.prototype.$track = function (frontUrl, postParam) {
+    _ensureUserId(tracker)
+
+    // postParam 处理（与 $dadian 一致）
+    var postParamStr = ''
+    if (postParam && Object.keys(postParam).length > 0) {
+      var config = tracker.getConfig()
+      if (config.platform === 'weapp' && config.eventBus) {
+        var bus = config.eventBus
+        postParamStr = JSON.stringify(Object.assign({}, postParam, {
+          wxAppOnLaunch: bus.wxAppOnLaunch,
+          pageFrom: bus.pageFrom,
+          mallOrderExt: bus.mallOrderExt,
+        }))
+      } else {
+        postParamStr = JSON.stringify(postParam)
+      }
+    }
+
+    // 开关关（默认）：旧接口也报一次（与 $dadian 一致）
+    var config = tracker.getConfig()
+    if (!config.useUnifiedReport) {
+      var header = { 'content-type': 'application/json' }
+      var hasLegacyAuth = false
+      if (typeof config.getAuthHeaders === 'function') {
+        var authHeaders = config.getAuthHeaders() || {}
+        if (authHeaders.Authorization || authHeaders.token || authHeaders['rsb-token']) {
+          hasLegacyAuth = true
+          Object.assign(header, authHeaders)
+        }
+      }
+      if (hasLegacyAuth) {
+        tracker.getQueue().pushLegacy(
+          config.dadianUrl + '/api/point/task/activeReport',
+          { frontUrl: frontUrl, postParam: postParamStr },
+          header
+        )
+      }
+    }
+
+    // SDK 事件入队（始终走）
+    tracker.track('custom', {
+      eventName: frontUrl || 'manual',
+      frontUrl: frontUrl,
+      postParam: postParamStr,
+      extraData: postParam,
+      elementId: frontUrl,
+    })
+
+    // 项目定制：从 footer 导航类 frontUrl 中提取目标路由，
+    // 在 track() 之后更新 referrer 链（确保目标页事件能拿到正确来源页）
+    // 必须在 track 之后：否则当前事件的 referrer 会被提前污染
+    var rules = config.projectRules
+    if (rules && typeof rules.extractNavTarget === 'function') {
+      var navTarget = rules.extractNavTarget(null, frontUrl)
+      if (navTarget) {
+        tracker.updatePageRoute(navTarget)
+      }
+    }
+  }
+
+  // 3. 注册 $tracker 实例引用（含 resetSession 供登出时调用）
+  Vue.prototype.$tracker = tracker
+  Vue.prototype.$trackerResetSession = function () {
+    tracker.getSession().resetSession()
+    tracker.getQueue()._flushedEventIds.clear()
+  }
+
+  // 3.1 动态参数解析器快捷方式
+  Vue.prototype.$registerParam = function (name, fn) {
+    tracker.registerParam(name, fn)
+  }
+
+  // 4. 注册 v-impression 指令（兼容旧业务代码）
+  var adapter = tracker.getAdapter()
+  if (adapter.supportsIntersectionObserver()) {
+    Vue.directive('impression', createImpressionDirective(tracker))
+  }
+
+  // 5. 注册 v-track-exposure 指令（新的曝光指令，走自动采集链路）
+  var exposurePlugin = tracker.plugins.find(function (p) {
+    return p.name === 'exposure'
+  })
+  if (exposurePlugin && typeof exposurePlugin.createDirective === 'function') {
+    var trackExposureDirective = exposurePlugin.createDirective()
+    if (trackExposureDirective) {
+      Vue.directive('track-exposure', trackExposureDirective)
+    }
+  }
+
+  // 6. 注册页面停留 mixin
+  var hasPageStayPlugin = (options.plugins || []).some(function (p) {
+    return p === 'page-stay' || (p && p.name === 'page-stay')
+  })
+  if (hasPageStayPlugin) {
+    Vue.mixin(createPageStayMixin(tracker))
+  }
+
+  // 7. 注册 Vue 错误捕获（组件 render/lifecycle/watch 中的异常）
+  var jsErrorPlugin = tracker.plugins.find(function (p) {
+    return p.name === 'js-error'
+  })
+  if (jsErrorPlugin) {
+    var _prevErrorHandler = Vue.config.errorHandler
+    Vue.config.errorHandler = function (err, vm, info) {
+      jsErrorPlugin.handleVueError(err, vm, info)
+      if (_prevErrorHandler) _prevErrorHandler.call(this, err, vm, info)
+    }
+  }
+
+  // [PROJECT-ADAPT] 小程序生命周期注册
+  // H5 端通过 history API 监听路由变化，小程序端通过 onShow/onHide
+  if (tracker.getConfig().platform === 'weapp') {
+    var pageViewPlugin = tracker.plugins.find(function (p) {
+      return p.name === 'page-view'
+    })
+    var lifecyclePlugin = tracker.plugins.find(function (p) {
+      return p.name === 'app-lifecycle'
+    })
+
+    Vue.mixin({
+      onShow: function () {
+        if (pageViewPlugin) {
+          pageViewPlugin.trackPageShow()
+        }
+        if (lifecyclePlugin) {
+          lifecyclePlugin.trackAppShow()
+        }
+      },
+      onHide: function () {
+        if (lifecyclePlugin) {
+          lifecyclePlugin.trackAppHide()
+        }
+      },
+    })
+  }
+}
+
+// 默认导出 Vue 插件对象
+export default {
+  install: install,
+  createTracker: createTracker,
+  getTracker: getTracker,
+}
+
+// 具名导出
+export { Tracker } from './core/tracker.js'
+export { WebAdapter } from './platforms/web.js'
+export { WeappAdapter } from './platforms/weapp.js'
+export { AppAdapter } from './platforms/app.js'