用途：在 React Native Expo（SDK 53+）应用中集成 Superwall 付费墙与订阅权限门控，使用 expo-superwall SDK。该 SDK 基于原生模块，因此必须使用 Expo Development Build（npx expo run:ios|android 或 EAS dev client），Expo Go 不支持；最低系统要求为 iOS deployment target 15.1+、Android minSdkVersion 21+。
主要能力：正确安装并配置 expo-superwall；通过 placements（远程活动）展示付费墙并实现功能门控；管理用户与属性并保持订阅状态同步（含 RevenueCat）；接入深链与 web checkout，并排查常见集成故障。
使用方式：先确认 Expo SDK 版本不低于 53 且非 Expo Go；安装 expo-superwall（必要时加 expo-build-properties）；用 expo-build-properties 设置 iOS/Android 最低版本；在应用根部包裹 <SuperwallProvider>（配合 <SuperwallLoading/>、<SuperwallError/>、<SuperwallLoaded/>）；用 usePlacement().registerPlacement({ placement: "…" }) 注册首个放置点；可选通过 feature: () => … 回调实现功能门控；可选用 useUser().identify(userId) 识别用户、useUser().signOut() 登出、useUser().update({ … }) 设置或合并属性（传 null 取消）；原生变更后重建 dev client（必要时 npx expo prebuild --clean）；用 node {baseDir}/scripts/check-setup.mjs 验证。RevenueCat 场景下用 CustomPurchaseControllerProvider 由 RevenueCat 负责购买、Superwall 负责付费墙与实验，并同步权益状态。
注意：Superwall 配置在热重载时不会重新拉取，仪表盘改动（付费墙/产品/活动）后需完全重启应用。遇到 Cannot find native module 'SuperwallExpo' 或付费墙不显示时，运行 setup 检查脚本、确认使用 dev build、重新生成原生目录并重建、清理缓存重装依赖，详细排查见 references/TROUBLESHOOTING.md。