用途：为订阅计费实现提供通用模式参考，覆盖从创建到取消的完整生命周期，示例基于 @commet/node，但逻辑可迁移到其他计费系统。
主要能力：订阅状态机（draft、pending_payment、trialing、active、past_due、paused、canceled）；trialing、active、past_due 授予访问权限，paused 无访问权限；每位客户仅保留一个开放的订阅关系。快速参考按任务指向对应文件：试用与介绍优惠见 trials-and-intro-offers.md；升级、降级与计费周期变更见 upgrades-downgrades.md；按比例计费与周期中变更见 proration-logic.md；失败支付重试与宽限期见 dunning-and-retries.md；取消、暂停、恢复与重新激活见 cancellation-flows.md；附加项与周期中激活按比例计费见 addons-and-extras.md。
使用方式：按需查阅对应参考文件，以 active 端点和当前 API 错误作为是否可创建新订阅的判断依据，不要依据过时状态列表重建生命周期规则。
限制：不要用通用公平规则推断订阅行为；在 Commet 中，套餐变更依据计费周期、套餐组顺序及付费/免费转换分类；价格编辑通过所选目录价格影响续费，而已接受的 Offer 阶段不可变。具体操作请使用对应链接参考。