用途：帮助使用 PostHog 私有 API（需 phx_... 个人 API Key）的开发者避免 429 错误，通过退避、排队与缓存控制请求速率。
主要能力与限流档位：事件采集端点（/capture/、/batch/）与 /decide/ 端点无限流；分析 API（insights、persons、recordings）为 240/分钟、1200/小时；HogQL 查询 API（/api/projects/:id/query/）为 1200/小时；功能开关本地评估轮询为 600/分钟；其余私有端点 240/分钟、1200/小时。
使用方式分四步：一是封装 postHogApiCall，遇 429 时优先读取 Retry-After 头，否则用带随机抖动的指数退避重试，客户端 4xx（除 429）不重试、5xx 重试；二是用 p-queue 建请求队列，例如 concurrency 2、每 1000 毫秒最多 4 个请求，把 240/分钟换算成 4 请求/秒；三是用内存缓存（如 5 分钟 TTL）缓存趋势等不常变的数据；四是读取 X-RateLimit-Remaining 与 X-RateLimit-Reset 头监控余量，接近阈值时主动等待。
适用场景：批量拉取 insights、频繁查询 HogQL、服务端轮询功能开关定义等高频调用场景。
限制与注意：仅私有端点受限，posthog.capture() 不会触发 429；需正确的 API Key 与请求头；退避要加随机抖动避免惊群；缓存 TTL 与重试次数需按业务调整。文档中的具体代码示例此处未完整保留，以原技能资料为准；官方限流数值可能变动，暂未提供更多信息。