用途:帮助在项目中安装 PostHog SDK 并完成认证配置,适用于新建 PostHog 集成或配置 API 密钥的场景。
主要能力:区分两类密钥——Project API Key(phc_ 前缀)用于事件采集与功能开关评估,可暴露在前端;Personal API Key(phx_ 前缀)用于管理 API、本地开关评估和 HogQL 查询,绝不可暴露给客户端。支持浏览器、Node.js 服务端和 Python 三种 SDK。
使用方式:前置条件为 Node.js 20+ 或 Python 3.10+、PostHog 账号及对应密钥。安装命令:npm install posthog-js、npm install posthog-node、pip install posthog。通过环境变量配置密钥与主机(美国云 https://us.i.posthog.com,欧盟云 https://eu.i.posthog.com,自托管用自有域名)。浏览器端用 posthog.init 初始化,需用 typeof window 判断避免服务端调用;服务端用 new PostHog 并设置 flushAt、flushInterval,进程退出前须调用 shutdown 刷新,无服务器环境尤其重要;Python 端设置 project_api_key、host、personal_api_key 后调用 posthog.capture。
验证:发送测试事件并 flush,在 PostHog 后台 Activity 标签查看。
限制与常见问题:密钥前缀错误会导致事件不出现;Personal Key 过期或缺失会返回 401;主机区域选错会 ECONNREFUSED;SDK 未安装会报模块找不到。.env 应加入 .gitignore,切勿提交。具体价格、平台支持范围等资料暂未提供。