Changelog

本页内容由 VitePress 直接 include packages/trace/CHANGELOG.md,changesets 在每次发版时自动维护,无需手工编辑。

@tripo3d/trace

2.0.1

Patch Changes

• 924ba10: - @tripo3d/lens & @tripo3d/trace: landing 上报去重窗口从「当日一次」改为「滚动 1 分钟一次」，去重存储由日期串改为标记时间戳，旧数据自动 GC 无需迁移

2.0.0

Major Changes

• f7781ed: - @tripo3d/trace: 拆分 initLanding 为 init 和 landing 两个方法，landing 改为 fire-and-forget 不阻塞业务

1.0.0

Major Changes

• 878560e: 白名单机制改造：从硬编码的 bd_vid 单参数检测改为基于 CDN 远程 JSON 的 utm_source 白名单。

  破坏性变更

  • 删除 TripoTraceParams.channels 入参。
  • 删除导出 ChannelName / ChannelDetector / baiduChannel / matchChannel。
  • onReport 钩子签名从 (payload, channel) => void 改为 (payload) => void。
  • TraceErrorContext 删除 channel 字段，phase 新增 'config' 取值。

  新增

  • TripoTraceParams.configUrl: string（必填）——CDN 白名单 JSON 的完整 URL。
  • 导出类型 RemoteTraceConfig，对应 CDN JSON 契约。
  • CDN 配置 schema：{ version: 1, killSwitch: boolean, utm_source: string[] }。
  • 行为变化：
    • 构造时立即缓存 window.location.href 为 entry URL，业务方需在「任何 URL 操作之前」new TripoTrace。
    • initLanding 使用 entry URL 提取 utm_source（统一小写），命中 CDN 白名单才上报。
    • CDN 配置 killSwitch=true 时完全不上报；拉取失败 / schema 不识别时 fail-open（继续上报所有带 utm_source 的流量）。
    • 同实例内 CDN 配置只拉取一次（in-memory promise 缓存）。

  详见 doc 站 /trace/quickstart 与 /trace/advanced 的 CDN 配置文件维护指南。

0.1.3

Patch Changes

• 重构 landing dedupe 存储策略：从 per-URL 多 localStorage key（tripo:trace:lp:<murmur-hash>）改为单 map key（tripo:trace:landing-dedupe）。新策略自动 GC 非当日条目，避免 localStorage 残留过期 key。
• 新增内部 helper safeRemoveLocal（storage.ts），用于安全删除 localStorage 项；遇到不可用环境（隐身模式 / 配额超限）静默忽略。