用途：在 Next.js（2025）项目中集成 PostHog，实现产品分析、功能开关、A/B 测试与会话回放。
主要能力：事件追踪与用户识别、分组分析；布尔与多变量功能开关、实验；会话回放录制与隐私控制；HogQL 与 Query API 查询、洞察提取；漏斗、留存、错误报告与 SEO 报告。
使用方式：按需加载参考文件——references/nextjs-implementation.md（从零搭建与代码模式）、references/event-taxonomy.md（事件命名与属性规范）、references/feature-flags.md（功能开关与实验）。快速配置需设置环境变量 NEXT_PUBLIC_POSTHOG_KEY 与 NEXT_PUBLIC_POSTHOG_HOST；推荐在 next.config.ts 中配置反向代理，将 /ingest/static/:path*、/ingest/:path*、/ingest/decide 转发到 PostHog 域名，并更新 CSP 的 connect-src 允许 PostHog 连接。客户端通过 posthog-js 与 PostHogProvider 初始化，api_host 设为 /ingest，capture_pageview 设为 false 以手动处理页面浏览；服务端使用 posthog-node 创建客户端。事件命名建议采用 category:object_action 等模式，属性使用 is_、has_、_count、_at 等前缀后缀。追踪位置可按决策树选择：浏览器用户操作与实时 UI 反馈用客户端，API 路由、Webhook、服务端组件渲染及需 100% 准确时用服务端。
适用场景：Next.js 应用的产品分析、转化漏斗、功能灰度与实验、会话回放。
限制与注意：广告拦截器会拦截直连请求，需用反向代理；事件缺失时检查拦截器、API Key 与代理；避免重复页面浏览；功能开关闪烁可通过中间件引导；用户数据缺失应在 $pageview 前调用 identify()；命名需统一。实施前建议先明确关键事件、是否需要服务端追踪、是否做 A/B 测试、认证方式及会话回放的隐私要求。