用途：帮助开发者安全升级 PostHog 的 posthog-js 与 posthog-node SDK，识别并处理重大版本间的破坏性变更。
主要能力：审计当前安装版本与最新可用版本；梳理破坏性变更，重点包括 posthog-node v5.5.0 起 sendFeatureFlags 不再随本地评估自动发送、需显式设为 true，以及 posthog-js 的 autocapture 改为对象格式、before_send 取代旧的事件过滤方式；提供升级、废弃模式搜索、暂存环境验证与回滚步骤。
使用方式：先运行 npm list posthog-js、npm list posthog-node、pip3 show posthog 检查版本，并用 npm view 查询最新版本；创建升级分支后执行 npm install posthog-node@latest、npm install posthog-js@latest，Python 用 pip install --upgrade posthog；用 npx tsc --noEmit 检查类型错误，grep 搜索 posthog、sendFeatureFlags、硬编码密钥等模式；在暂存环境用 capture、getAllFlags、identify、flush、shutdown 验证；必要时用 npm install posthog-node@4.2.1 --save-exact 等命令回滚。
适用场景：需要跨主版本升级 PostHog SDK、排查升级后类型错误或功能标志未随事件发送、迁移旧版 autocapture 配置的项目。
限制：资料未提供具体价格、平台支持范围或效果保证；版本兼容性表仅列出 posthog-node 5.x 需 Node.js 20+、4.x 需 18+，posthog-js 面向现代浏览器；实际变更请以官方 changelog 与迁移指南为准。