SuperAPI AI 工具集

debugging-surveys

测试与质量

查看项目

更新于 10-16 03:45

技能介绍

用途:诊断 PostHog Surveys 的配置与响应问题,覆盖 Web(posthog-js)、iOS、Android、Flutter、React Native 五个 SDK。多数“问卷不显示”工单实为资格判定问题,而非渲染缺陷。

主要能力:先做跨 SDK 功能对齐检查,确认平台是否支持目标功能;梳理 Web 端资格判定流水线(isSurveyRunning、类型、linked_flag、targeting_flag、内部标志、等待期、已见标志,再到 URL/设备/选择器匹配与事件触发);说明响应存储机制(enable_partial_responses 控制采集而非可见性,默认值因创建路径而异);解释“所有问题已回答”实为走到分支路径终点,分支跳过与可选问题会留空;给出事件词汇(survey shown/sent/dismissed/abandoned)与用 getSurveyResponse 读取答案的方法。

使用方式:通过 PostHog MCP 工具或 survey API 检查配置与响应,无需检出 PostHog 仓库。工作流:解析工单(组织/项目 ID、实例、survey ID、平台、症状)→ 区分“无响应”与“响应变少”→ 平台对齐检查→ 拉取问卷定义(GET /api/projects/<id>/surveys/<sid>/)→ 拉取 targeting flag 活动日志→ 用事件确认→ 对照已知原因目录并写回复。

适用场景:问卷不显示、事件触发不生效、响应数据异常、响应率下降等支持工单。

限制:URL 定向、surveyPopupDelaySeconds、部分响应与自动提交仅 Web 支持;Android 无内置 UI,需提供 PostHogSurveysDelegate;React Native 等待期被静默禁用;判定为 SDK bug 前需通过读 JSON、Preview 复现、读源码、复核查询四道关卡。具体版本能力以实际 SDK 源码为准。