用途:帮助在 Python 应用中添加 PostHog 功能开关,参考资料含 Python 安装、添加功能开关代码和最佳实践三份文档。
主要能力与原则:键值一律用环境变量,不硬编码;以最小改动方式在既有逻辑旁追加开关代码,不重构原有代码;默认使用布尔开关,除非明确需要多变量开关;尽量在服务端评估开关以避免界面闪烁。
使用方式:安装依赖用 pip install posthog 或 pip install -r requirements.txt,不要在 shell 命令中直接使用 >= 这类未加引号的版本限定符。使用 Posthog() 类构造器(实例化 API),不要用模块级 posthog.api_key 配置;构造函数需包含 enable_exception_autocapture=True 以自动捕获异常。在 CLI 和脚本中必须在退出前调用 posthog.shutdown(),否则事件会丢失;可用 atexit.register() 注册 posthog_client.shutdown。Python SDK 没有 identify() 方法,设置人员属性用 posthog_client.set(distinct_id=user_id, properties={...}),或在上下文中用 identify_context(user_id)。
其他:若已连接 PostHog MCP 服务器,可查找创建、列出、更新、删除开关相关工具,直接在 PostHog 中管理开关。capture() 事件属性中禁止发送 PII(邮箱、全名、电话、地址、IP、用户生成内容),PII 应放在 identify() 的人员属性中,安全的事件属性如 message_length、form_type、布尔标记等。
限制:文档未提供具体 API 细节、框架专属模式、收费与价格信息,需查阅所附参考文档;未提供各框架的逐步操作说明。