Remove Analytics

核心用法

Remove Analytics 是一个专注于隐私合规的代码清理技能，用于彻底移除项目中的 Google Analytics 追踪体系。其工作流程分为五步：用户意图确认、代码扫描定位、安全移除代码、依赖清理、最终报告汇总。

显著优点

1. 全面扫描：覆盖 gtag 脚本、dataLayer、组件文件、环境变量、npm 依赖等多维度追踪代码
2. 安全确认机制：执行前强制二次确认，避免误操作导致数据丢失
3. 依赖自动清理：自动识别并卸载 @types/gtag.js、react-ga4、vue-gtag 等关联包
4. 环境变量处理：同步清理 .env.example 中的 GA_/GTAG_/MEASUREMENT_ID 等配置
5. 可追溯报告：最终生成文件删除、修改、包移除的完整清单

潜在缺点与局限性

• 破坏性操作：一旦执行无法自动回滚，需依赖版本控制恢复
• 框架覆盖有限：主要针对 React/Vue 生态的常用库，小众 analytics 工具可能漏检
• 实际环境变量需手动处理：仅清理 .env.example，生产环境的真实 .env 文件需用户自行处理
• 无预览模式：未提供"仅扫描不删除"的试运行选项

适合人群

• 需要快速通过 GDPR/CCPA 合规审计的开发团队
• 从数据驱动转型隐私优先产品的技术负责人
• 接手遗留项目、需要清理第三方追踪代码的维护者

常规风险

1. 业务数据中断：移除后将永久丢失网站流量分析能力，需提前迁移至替代方案
2. SEO/性能副作用：若 gtag 加载策略与页面渲染耦合，移除后可能出现布局偏移或加载异常
3. A/B 测试依赖：部分项目将 analytics 与实验框架绑定，移除可能导致功能异常

建议执行前完整备份代码库，并确认团队已切换至 Plausible、Fathom 等隐私友好型分析工具。

核心用法

Remove Analytics 是一款面向开发者的代码清理工具，专用于从项目中彻底移除 Google Analytics 追踪体系。其工作流采用五步递进式设计：首先强制用户输入"yes"确认意图，防止误操作；继而全局搜索 gtag、dataLayer、GoogleAnalytics 等关键词定位追踪代码；随后逐文件展示并清理脚本、组件及工具函数；接着卸载 @types/gtag.js、react-ga4 等关联 npm 包并清除环境变量；最终生成结构化移除报告。整个流程强调可视化确认与可追溯审计，确保每一次删除操作都经过用户知情同意。

显著优点

1. 隐私合规增强：主动移除追踪代码符合 GDPR 数据最小化原则，降低数据合规风险。
2. 零依赖安全架构：纯 Markdown 文档实现，无可执行代码、无外部 API 调用、无供应链攻击面。
3. 操作可逆可追溯：分步确认机制配合详细变更清单，便于版本控制回滚与团队协作审计。
4. 框架无关通用：覆盖 React（react-ga4）、Vue（vue-gtag）、原生 JS 等多技术栈的清理策略。
5. 清理彻底性：不仅删除代码，同步清理环境变量、类型定义及文档引用，避免配置残留。

潜在缺点与局限性

1. 需人工复核边界：自动搜索可能遗漏动态注入、混淆代码或第三方 SDK 内嵌的追踪逻辑。
2. 环境变量实际值未处理：仅清理 .env.example 模板，真实 .env 文件需用户手动处理。
3. T3 来源可信度：个人开发者作品，缺乏企业级维护背书，长期更新承诺存不确定性。
4. 无回滚自动化：删除操作不可逆，未提供一键恢复功能，误删后需依赖 Git 历史回溯。

适合目标群体

• 隐私优先团队：受 GDPR、CCPA 等法规约束、需主动削减数据收集面的组织；
• 遗留项目维护者：接手含历史 analytics 代码、需精简依赖的工程师；
• 合规审计准备者：上市前安全审查、需证明"无未授权追踪"的初创企业；
• 性能敏感开发者：追求极致 bundle size、欲剔除无用监控代码的前端优化人员。

使用风险提醒

• 破坏性操作风险：虽设二次确认，批量删除仍可能影响 A/B 测试或业务监控埋点，需提前评估业务影响。
• 配置漂移风险：多人协作项目中，若未及时同步 .env.example 变更，可能导致 CI/CD 构建失败。
• 遗漏风险：对 gtag 函数的自定义封装或动态加载场景，纯文本搜索可能失效，建议结合运行时测试验证。
• 无持续维护保障：当前认证有效期 90 天，建议关注作者更新动态或自行 fork 维护。