Zaraz Implementation Summary

# Zaraz 参考实现摘要 ## 创建的文件 | 文件 | 行数 | 用途 | |------|-------|---------| | README.md | 111 | 导航、决策树、快速入门 | | api.md | 287 | Web API 参考，Zaraz 上下文 | | configuration.md | 307 | 仪表板设置、触发器、工具、许可 | | patterns.md | 430 | SPA、电子商务、Worker 集成 | | gotchas.md | 317 | 故障排除、限制、特定工具问题 | | **总计** | **1,452** | **对比原 366 行** | ## 应用的关键改进 ### 结构 - ✅ 创建了 5 文件渐进式披露系统 - ✅ 在 README 中添加了导航表 - ✅ 添加了路由决策树 - ✅ 添加了“按任务阅读顺序”指南 - ✅ 全文交叉引用文件 ### 新增内容 - ✅ Zaraz 上下文（系统/客户端属性） - ✅ 用于 SPA 跟踪的历史记录更改触发器 - ✅ 上下文丰富器模式 - ✅ Worker 变量模式 - ✅ 许可管理深度解析 - ✅ 特定工具的怪癖（GA4、Facebook、Google Ads） - ✅ GTM 迁移指南 - ✅ 全面故障排除 - ✅ “何时不使用 Zaraz”章节 - ✅ TypeScript 类型定义 ### 保留内容 - ✅ 所有原始 API 方法 - ✅ 电子商务跟踪示例 - ✅ 许可管理 - ✅ Workers 集成（已扩展） - ✅ 常见模式（已扩展） - ✅ 调试工具 - ✅ 参考链接 ## 渐进式披露的影响 ### 之前（单体式） 无论需求如何，所有任务都会加载 366 行内容。 ### 之后（渐进式） - **跟踪事件任务**: README (111) + api.md (287) = 398 行 - **调试问题**: gotchas.md (317) = 317 行（减少 13%） - **配置工具**: configuration.md (307) = 307 行（减少 16%） - **SPA 跟踪**: README + patterns.md (SPA 部分) ~180 行（减少 51%） **净效果：** 按任务加载根据用例减少了 13-51% 的不必要内容。 ## 文件摘要 ### README.md (111 行) - 概述和核心概念 - 快速入门指南 - 何时使用 Zaraz 与 Workers - 导航表 - 按任务阅读顺序 - 决策树 ### api.md (287 行) - zaraz.track() - zaraz.set() - zaraz.ecommerce() - Zaraz 上下文（系统/客户端属性） - zaraz.consent API - zaraz.debug - Cookie 方法 - TypeScript 定义 ### configuration.md (307 行) - 仪表板设置流程 - 触发器类型（包括历史记录更改） - 工具配置（GA4、Facebook、Google Ads） - 操作和操作规则 - 选择性加载 - 许可管理设置 - 隐私功能 - 测试工作流 ### patterns.md (430 行) - SPA