用途：为应用添加 PostHog SDK 集成，适用于首次设置 PostHog，或审查需要 PostHog 初始化的 PR。覆盖 SDK 安装、Provider 设置与基础配置，支持任意框架或语言。
支持范围：Next.js、React、React Router、Vue、Nuxt、TanStack Start、SvelteKit、Astro、Angular、Django、Flask、FastAPI、Laravel、PHP、Ruby on Rails、Go、Elixir、Android、iOS、Swift、Flutter、React Native、Expo、Node.js 及原生 JavaScript。
使用方式（按顺序执行）：1）分析代码库并识别平台，通过依赖文件判断框架与语言，通过锁文件判断包管理器；若已存在 PostHog 初始化则不改动代码，提示用户并跳到验证。2）查找匹配框架的参考文件作为初始化与配置的权威来源；无匹配时回退到通用知识与网络搜索，以 posthog.com/docs 为主。3）用包管理器安装 PostHog SDK，不手动编辑 package.json。4）按框架参考初始化 PostHog，并按需设置 Provider/包装组件。5）在客户端登录与注册事件中调用 identify()；若前后端并存，用 X-POSTHOG-DISTINCT-ID 与 X-POSTHOG-SESSION-ID 头传递会话与 distinct ID。6）配置环境变量：已有有效值则跳过；缺少项目 token 时可用 PostHog MCP 的 projects-get 获取 api_token，多项目时询问用户，MCP 未连接或未认证则向用户索取；host 按 region 映射（US 为 https://us.i.posthog.com，EU 为 https://eu.i.posthog.com），无法确定时询问用户，不默认 US Cloud；写入对应 env 文件并在代码中引用而非硬编码。7）验证与清理：检查错误、类型检查或构建脚本，确认创建的组件被使用，仅对本次改动文件运行 lint/格式化脚本，不全局运行。
关键原则：始终用环境变量存 PostHog 密钥；最小改动，与现有集成并存；尽量贴合示例项目模式；将事件名、属性名与功能开关键视为分析契约，复用现有命名，新增时保持清晰一致。
限制：资料未提供具体收费、价格或效果数据；各框架的详细安装与初始化代码需查阅对应参考文件。