用途：为应用添加 PostHog SDK 集成，适用于首次配置 PostHog，或审查需要 PostHog 初始化的 PR。覆盖 SDK 安装、provider 设置与基础配置，支持任意框架或语言。
支持的框架：Next.js、React、React Router、Vue、Nuxt、TanStack Start、SvelteKit、Astro、Angular、Django、Flask、FastAPI、Laravel、Ruby on Rails、Android、Swift、React Native、Expo、Node.js 及 vanilla JavaScript。
使用方式按顺序执行七步：1) 分析代码库并检测平台，查看依赖文件与锁定文件判断框架、语言和包管理器；若已安装并初始化 PostHog，则不改动其代码并跳至验证。2) 查找与检测框架匹配的参考文件，作为 SDK 初始化、provider 设置与配置模式的依据；若无匹配则回退到通用知识和网络搜索，以 posthog.com/docs 为主要来源。3) 安装 PostHog SDK，使用包管理器的安装命令而非手动编辑 package.json，并作为后台任务执行。4) 初始化 PostHog，按框架参考确定位置与方式，并按需设置 provider/包装组件。5) 识别用户，在客户端登录和注册事件中添加 identify() 调用；若前后端并存，通过 X-POSTHOG-DISTINCT-ID 和 X-POSTHOG-SESSION-ID 请求头将客户端会话和 distinct ID 传给服务端。6) 设置环境变量，将 API key 和 host 存入环境变量并在代码中引用。7) 验证与清理，检查错误、运行类型检查/构建/linter/prettier 等脚本，确保创建的组件被实际使用。
关键原则：始终使用环境变量存放密钥，不硬编码；在现有集成旁添加代码，不替换或重构；实现尽量贴合示例项目模式；将事件名、属性名和功能开关 key 视为分析契约，复用项目已有命名与模式。
限制：本资料未提供具体收费、价格、平台可用性、实际效果等信息；各框架的详细初始化位置因框架而异，需查阅对应参考文件。