用途:在 Epicenter 项目中集成 Autumn 用量计费,管理功能、套餐、信用额度与按量计费的 AI 用量。
主要能力:用 autumn.config.ts 定义 Feature、Product、Plan 等;支持 metered、credit_system、boolean 等特性类型;通过 creditSchema 将信用池映射到计量特性;支持套餐分组互斥、附加项、autoEnable 免费层;支持按模型比例计费(单一 ai_usage 特性配合动态 requiredBalance)。
使用方式:用 autumn-js 初始化客户端(secretKey 取自环境变量),调用 customers.getOrCreate 同步客户(必须 await),用 check() 做信用检查并可通过 sendEvent: true 原子扣减,失败时用 track({ value: -credits }) 退款。CLI 用 bun x atmn login、env、preview、push、push --prod、pull 等命令管理配置与类型。
适用场景:AI 功能按模型成本扣信用、套餐升级降级、Stripe 支付集成、Cloudflare Workers + Hono 中间件鉴权后计费。
限制:所有 ID 使用 snake_case;reset.interval 与 price.interval 互斥;check() 前客户必须已存在;生产环境需连接 Stripe;具体价格与平台细节以官方资料为准,本文未提供。