用途：为应用脚手架一套完整的积分（credit）系统，包括数据库结构、后端中间件、支付回调、前端状态与 UI 组件。会先阅读项目，在现有基础上构建。适合需要售卖与消耗积分（如按次计费的生成类操作）的应用。
主要流程与能力：
- 先理解项目：检测后端框架（Next.js API 路由 / FastAPI / Express / Django / Rails）、数据库（Supabase / Postgres / PlanetScale / MongoDB / Prisma）、鉴权（Clerk / NextAuth / Supabase Auth / Firebase Auth / 自定义 JWT）、前端状态（Zustand / Redux / React Context / Jotai）及已有支付。随后向用户确认：什么操作消耗积分、免费额度、支付渠道偏好、积分包定价；默认 50 免费积分、Stripe。
- 数据库结构：提供非负余额、不可变的积分流水审计、按用户和时间的索引、不可竞态为负的原子变更；仅在用户要求时加入优惠码存储。
- 后端积分服务：核心函数 get_credits、deduct_credits、add_credits；扣减前必须服务端校验余额，使用数据库约束或事务防止竞态，例如 UPDATE users SET credits = credits - $amount WHERE id = $id AND credits >= $amount 并检查受影响行数，且始终写流水。另提供按框架适配的积分校验中间件，余额不足返回 HTTP 402。
- 支付集成：在结算元数据里放用户标识与积分数量，校验 webhook 签名，用支付/事件 ID 保证幂等，验证支付后才加积分并记账。
- 前端积分状态：推荐 Zustand store 与同步 hook，支持乐观扣减与失败回滚，含低积分阈值、预检查等 UX 模式。
- UI 组件：余额展示、购买弹窗、低积分提醒、动作旁积分成本标识、结算成功页（轮询 /api/user/credits）、可选交易历史。
- 优惠码与后台工具：兑换端点 POST /api/credits/redeem、管理员创建码端点、管理员加积分端点与积分分析查询。
- 串联与验证：各受保护端点加中间件、每次动作做客户端与服务端双重校验、注册 webhook、创建成功页，并按注册、消耗、购买、优惠码、边界情况等流程逐项核对。
限制：资料未提供具体安装命令、官方文本、许可与收费信息；实际实现依赖检测到的技术栈与用户确认的决策。