subscription-lifecycle

用途：为 iOS 应用生成 StoreKit 2 订阅生命周期管理代码，与负责购买界面和首次交易的 paywall-generator 互补，专注购买之后的状态监控与留存处理。\n\n主要能力：生成订阅状态枚举、实时状态监控（基于 Transaction.updates 与 Product.SubscriptionInfo）、产品 ID 到功能权限的映射；可选生成宽限期处理、账单重试、优惠码兑换、挽留优惠（win-back）、升级/降级/交叉升级，以及订阅管理面板 UI。区分宽限期与账单重试：宽限期保留完整服务，账单重试建议降为受限访问并显示修复付款提示，不对重试用户再推销或打折。\n\n使用方式：技能在用户提及订阅管理、宽限期、账单重试、挽留优惠、状态监控、升降级、优惠码时激活。生成前会检测部署目标（StoreKit 2 需 iOS 15+）、Swift 版本（需 5.9+）、已有 StoreKit 代码与 In-App Purchase 权限，并通过提问确认订阅层级、功能选项、是否含面板 UI、是否服务端验证。生成文件包括 SubscriptionState.swift、SubscriptionMonitor.swift、SubscriptionEntitlement.swift，以及可选的 GracePeriodHandler.swift、OfferManager.swift、SubscriptionDashboardView.swift。集成时向已有 StoreKitManager 加入生命周期监控，在 App 入口启动并可用环境注入，用 currentEntitlements 做简单访问判断，用 SubscriptionInfo.status 处理生命周期状态，注意调用 transaction.finish()。\n\n适用场景：需要处理订阅续费、付款失败、挽留流失用户、管理层级变更的 iOS 应用。\n\n限制：依赖 StoreKit 2 与对应系统版本，部分能力（如 win-back 优惠）需 iOS 18+；沙盒与生产行为不同，优惠类型支持有限；服务端验证部分需 App Store Server API v2；具体价格、配置与效果资料未提供。