feat: posthog 配置调整

.env.development

@@ -18,7 +18,3 @@ REACT_APP_ENABLE_MOCK=false
 
 # 开发环境标识
 REACT_APP_ENV=development
-
-# PostHog 配置
-# ⚠️ 开发环境下 PostHog 已被完全禁用（见 src/lib/posthog.js:14-17）
-# PostHog 相关配置仅在 .env.production 中配置即可

src/lib/posthog.js

@@ -10,6 +10,11 @@ let isInitialized = false;
  * Should be called once when the app starts
  */
 export const initPostHog = () => {
+  // 开发环境禁用 PostHog（减少日志噪音，仅生产环境启用）
+  if (process.env.NODE_ENV === 'development') {
+    return;
+  }
+
   // 防止重复初始化
   if (isInitializing || isInitialized) {
     console.log('📊 PostHog 已初始化或正在初始化中，跳过重复调用');
@@ -33,79 +38,68 @@ export const initPostHog = () => {
     posthog.init(apiKey, {
       api_host: apiHost,
 
-      // Pageview tracking - auto-capture for DAU/MAU analytics
-      capture_pageview: true, // Auto-capture all page views (required for DAU tracking)
-      capture_pageleave: true, // Auto-capture when user leaves page
+      // 📄 页面浏览追踪
+      capture_pageview: true, // 自动捕获页面浏览事件
+      capture_pageleave: true, // 自动捕获用户离开页面事件
 
-      // Session Recording Configuration
+      // 📹 会话录制配置（Session Recording）
       session_recording: {
         enabled: process.env.REACT_APP_ENABLE_SESSION_RECORDING === 'true',
 
-        // Privacy: Mask sensitive input fields
+        // 🔒 隐私保护：遮蔽敏感输入字段（录制时会自动打码）
         maskInputOptions: {
-          password: true,
-          email: true,
-          phone: true,
-          'data-sensitive': true, // Custom attribute for sensitive fields
+          password: true, // 遮蔽密码输入框
+          email: true, // 遮蔽邮箱输入框
+          phone: true, // 遮蔽手机号输入框
+          'data-sensitive': true, // 遮蔽带有 data-sensitive 属性的字段（可在 HTML 中自定义）
         },
 
-        // Record canvas for charts/graphs
+        // 📊 录制 Canvas 画布内容（用于记录图表、图形等可视化内容）
         recordCanvas: true,
 
-        // Network payload capture (useful for debugging API issues)
+        // 🌐 网络请求数据捕获（用于调试 API 问题）
         networkPayloadCapture: {
-          recordHeaders: true,
-          recordBody: true,
-          // Don't record sensitive endpoints
+          recordHeaders: true, // 捕获请求头
+          recordBody: true, // 捕获请求体
+          // 🚫 敏感接口黑名单（不记录以下接口的数据）
           urlBlocklist: [
-            '/api/auth/session',
-            '/api/auth/login',
-            '/api/auth/register',
-            '/api/payment',
+            '/api/auth/session', // 会话接口
+            '/api/auth/login', // 登录接口
+            '/api/auth/register', // 注册接口
+            '/api/payment', // 支付接口
           ],
         },
       },
 
-      // Performance optimization
-      batch_size: 10, // Send events in batches of 10
-      batch_interval_ms: 3000, // Or every 3 seconds
+      // ⚡ 性能优化：批量发送事件
+      batch_size: 10, // 每 10 个事件发送一次
+      batch_interval_ms: 3000, // 或每 3 秒发送一次（两个条件满足其一即发送）
 
-      // Privacy settings
-      respect_dnt: true, // Respect Do Not Track browser setting
-      persistence: 'localStorage+cookie', // Use both for reliability
+      // 🔐 隐私设置
+      respect_dnt: true, // 尊重浏览器的"禁止追踪"（Do Not Track）设置
+      persistence: 'localStorage+cookie', // 同时使用 localStorage 和 Cookie 存储（提高可靠性）
 
-      // Feature flags (for A/B testing)
+      // 🚩 功能开关（Feature Flags）- 用于 A/B 测试和灰度发布
       bootstrap: {
-        featureFlags: {},
+        featureFlags: {}, // 初始功能开关配置（可从服务端动态加载）
       },
 
-      // Autocapture settings
+      // 🖱️ 自动捕获设置（Autocapture）
       autocapture: {
-        // Automatically capture clicks on buttons, links, etc.
+        // 自动捕获用户交互事件（点击、提交、修改等）
         dom_event_allowlist: ['click', 'submit', 'change'],
 
-        // Capture additional element properties
-        capture_copied_text: false, // Don't capture copied text (privacy)
-      },
-
-      // Development debugging
-      loaded: (posthogInstance) => {
-        if (process.env.NODE_ENV === 'development') {
-          console.log('✅ PostHog initialized successfully');
-          // posthogInstance.debug(); // 已关闭：减少控制台日志噪音
-        }
+        // 捕获额外的元素属性
+        capture_copied_text: false, // 不捕获用户复制的文本（隐私保护）
       },
     });
 
     isInitialized = true;
-    console.log('📊 PostHog Analytics initialized');
   } catch (error) {
     // 忽略 AbortError（通常由热重载或快速导航引起）
     if (error.name === 'AbortError') {
-      console.log('⚠️ PostHog 初始化请求被中断（可能是热重载），这是正常的');
       return;
     }
-    console.error('❌ PostHog initialization failed:', error);
   } finally {
     isInitializing = false;
   }
@@ -142,8 +136,6 @@ export const identifyUser = (userId, userProperties = {}) => {
       last_login: new Date().toISOString(),
       ...userProperties,
     });
-
-    // console.log('👤 User identified:', userId); // 已关闭：减少日志
   } catch (error) {
     console.error('❌ User identification failed:', error);
   }
@@ -158,7 +150,6 @@ export const identifyUser = (userId, userProperties = {}) => {
 export const setUserProperties = (properties) => {
   try {
     posthog.people.set(properties);
-    // console.log('📝 User properties updated'); // 已关闭：减少日志
   } catch (error) {
     console.error('❌ Failed to update user properties:', error);
   }
@@ -176,10 +167,6 @@ export const trackEvent = (eventName, properties = {}) => {
       ...properties,
       timestamp: new Date().toISOString(),
     });
-
-    // if (process.env.NODE_ENV === 'development') {
-    //   console.log('📍 Event tracked:', eventName, properties);
-    // } // 已关闭：减少日志
   } catch (error) {
     console.error('❌ Event tracking failed:', error);
   }
@@ -225,9 +212,6 @@ export const trackPageView = (pagePath, properties = {}) => {
       ...properties,
     });
 
-    // if (process.env.NODE_ENV === 'development') {
-    //   console.log('📄 Page view tracked:', pagePath);
-    // } // 已关闭：减少日志
   } catch (error) {
     console.error('❌ Page view tracking failed:', error);
   }
@@ -240,7 +224,6 @@ export const trackPageView = (pagePath, properties = {}) => {
 export const resetUser = () => {
   try {
     posthog.reset();
-    // console.log('🔄 User session reset'); // 已关闭：减少日志
   } catch (error) {
     console.error('❌ Session reset failed:', error);
   }
@@ -252,7 +235,6 @@ export const resetUser = () => {
 export const optOut = () => {
   try {
     posthog.opt_out_capturing();
-    // console.log('🚫 User opted out of tracking'); // 已关闭：减少日志
   } catch (error) {
     console.error('❌ Opt-out failed:', error);
   }
@@ -264,7 +246,6 @@ export const optOut = () => {
 export const optIn = () => {
   try {
     posthog.opt_in_capturing();
-    // console.log('✅ User opted in to tracking'); // 已关闭：减少日志
   } catch (error) {
     console.error('❌ Opt-in failed:', error);
   }