SuperAPI AI 工具集

revenuecat-troubleshoot

智能体与模型

查看项目

更新于 10-16 07:58

技能介绍

用途:当用户反馈 RevenueCat 行为与预期不符时使用本技能,例如商品包(offerings)为空、产品缺失、购买成功但权益未解锁、付费墙无法渲染,或沙盒交易未出现在仪表盘。

主要能力:分两条线排查。代码侧诊断:开启调试日志、按通用清单逐项核对、并进入平台专属检查。仪表盘检查:通过 RevenueCat MCP 服务器读取项目、应用、产品、权益、商品包与 Webhook,并给出修复建议。使用顺序为先代码侧、后仪表盘,多数问题在到达平台专属步骤前即可解决。

必要用法:

  • 平台检测:按工作目录特征识别 React Native、Flutter、Kotlin Multiplatform、原生 Android、原生 iOS,再读取对应平台说明文件;多平台匹配时选最外层拥有构建的项目,仍不明确则询问用户。
  • 通用九步清单:开启调试日志并复现;核对 API 密钥平台(iOS 用 appl_…,Android 用 goog_… 或 amzn_…);核对 bundle ID / package name 一致;用 MCP 检查 offerings(list-offerings 需带 expand=items.package.product,需有 is_current: true 且至少一个包引用商店产品);确认商店产品状态(App Store Connect 为 Ready to Submit,Google Play 为 Active,可用 get-product-store-state 查看 store_status);核对测试账号(iOS 沙盒 Apple ID、Android 许可测试账号并通过内部测试链接安装);检查网络(VPN、门户、DNS 过滤可能静默拦截);核对 appUserID;卸载重装并重试。
  • 仪表盘检查:先 list-projects,若返回多个项目需询问用户选择。随后按清单检查:list-apps 确认项目与应用;list-products 与 get-product-store-state 确认产品;list-entitlements 与 get-products-from-entitlement 确认权益;list-offerings 与 list-packages 确认商品包;list-webhook-integrations 确认 Webhook。发现可修复问题需先向用户确认,再通过 attach-products-to-entitlement、attach-products-to-package 等 MCP 工具执行。
  • 验证修复:原错误日志应出现预期成功信息,仪表盘(如 Customers 页 Sandbox 视图)应反映变更,原始复现步骤应通过。无法本地复现时,请用户提供从启动到失败时刻的完整调试日志。

适用场景:RevenueCat 集成排查、商品/权益/商品包配置核对、沙盒与测试账号问题定位、Webhook 服务端接入检查,以及 App Store 审核被拒相关问题(如拉取产品失败、购买错误、购买后未解锁)。

限制:资料未提供收费、价格或平台支持范围等信息。修复操作依赖 RevenueCat MCP 工具可用;API 密钥可能访问多个项目,务必先调用 list-projects 并让用户选择。部分问题(如商店状态变更、产品提交审核)需另行遵循对应技能或流程,本技能只做读取与有限的配置修复。