全部技能

用量积分

usage-credits
付费收款版本 1.0.0

基于 Creem 的预付积分包：每次请求只扣一次积分，失败自动退回，余额不足时返回 402 并提示购买。

完整说明（英文）

Adds prepaid usage credits to an app on Creem's Customer Credits API. Credit-pack products grant credits on payment and claw them back on refund; the app links buyers from the webhook or the success page, charges each request once with an idempotency key, gives credits back when work fails, and answers 402 with a buy prompt when the balance is short. Ships a zero-dependency core, Next.js App Router routes, a local SQLite ledger with the same interface (Paddle or manual grants), 17 offline tests, a live test-mode smoke test, and a headless test-card helper. Use when the user wants credits, tokens, a pay-as-you-go or top-up model, AI generation limits, "out of credits" handling, or to bill per request on Creem.

Creem 测试模式下的 Next.js 示例应用：用完 3 个免费积分，返回 402 且不扣费，用测试卡真实下单，回到应用后到账 100 积分。 · 录制于 2026-11-03

  1. 1每写一条文案通过 Creem API 扣 1 积分；第 4 次请求返回 402，什么也不执行
  2. 2点“购买 100 积分”进入 Creem 测试收银台，用测试卡付款（这段 2.5 倍速）
  3. 3成功页向 Creem 核对订单并关联账户：余额 100，再写一条变 99
  4. 4终端：17 个离线测试，再对 test-api.creem.io 跑冒烟测试

预览

它能做什么

基于 Creem 的预付积分包：每次请求只扣一次积分，失败自动退回，余额不足时返回 402 并提示购买。

  • 直接用 Creem 的 Customer Credits：积分包商品付款后自动加积分、退款时自动扣回，你的应用不用自己记余额
  • spendCredits() 先扣积分再干活，失败就把这次扣款撤回；同一个请求 id 重试只扣一次
  • 附 Next.js 路由：购买积分包、支付成功页（向 Creem 核对订单，不信 URL 参数）、查余额、余额不足返回 402 的付费接口、webhook
  • 所有行为在 2026-11-03 用 Creem 测试 API 实测过，包括文档没写清的情况：退款后余额可能变负，API 不允许撤回已用掉的积分
  • 同一套接口也能跑在你自己的 SQLite 账本上（Paddle 或其他）：积分过期、退款欠账、并发超扣拦截；17 个离线测试 + 一个真实 API 冒烟测试
试试这句提示词
用 usage-credits 技能给我的应用加上预付积分：在 Creem 上卖 100 积分的包，每次生成扣 1 积分，余额用完时提示购买。

购买后可查看完整说明

这是付费技能，可单独购买，也可通过套餐获得全部技能。购买后可在本页或账户页下载。

目录

  1. 01When to use / when not to
  2. 02What you get
  3. 03Steps
  4. 04Rules
  5. 05Done when
  6. 06Troubleshooting

里面有什么

25 个文件：SKILL.md、5 个脚本、8 份参考资料、10 个模板和资源文件、1 个测试。

usage-credits/
  • SKILL.md7.7 KB
  • assets/(10)44.3 KB
    • lib/(1)27.7 KB
      • credits-core.mjs27.7 KB
    • nextjs/(9)16.5 KB
      • src/(8)15.9 KB
        • app/(5)6.7 KB
          • api/(4)5.1 KB
            • credits/(2)1.8 KB
              • balance/(1)503 B
                • route.ts503 B
              • checkout/(1)1.3 KB
                • route.ts1.3 KB
            • generate/(1)1.6 KB
              • route.ts1.6 KB
            • webhooks/(1)1.7 KB
              • creem/(1)1.7 KB
                • route.ts1.7 KB
          • credits/(1)1.6 KB
            • success/(1)1.6 KB
              • page.tsx1.6 KB
        • lib/(3)9.2 KB
          • credits-core.d.mts4.7 KB
          • credits.ts4.0 KB
          • current-user.ts600 B
      • .env.example620 B
  • references/(8)15.7 KB
    • fixtures/(5)7.4 KB
      • checkout.completed.json3.0 KB
      • credits.consumed.json486 B
      • credits.granted.json478 B
      • customer_credits.exhausted.json419 B
      • refund.created.json3.0 KB
    • creem-credits.md4.8 KB
    • ledger-design.md1.5 KB
    • pricing-credits.md1.9 KB
  • scripts/(6)35.0 KB
    • template-check/(1)5.7 KB
      • routes.test.ts5.7 KB
    • check_nextjs_template.sh2.0 KB
    • create_credit_pack.mjs2.9 KB
    • credits_smoke.mjs4.7 KB
    • pay_test_checkout.mjs4.2 KB
    • selftest.mjs15.6 KB

常见问题

用量积分 是做什么的？

基于 Creem 的预付积分包：每次请求只扣一次积分，失败自动退回，余额不足时返回 402 并提示购买。

支持哪些 AI 工具？

Claude Code、Codex、Cursor，以及其他支持 Agent Skills 格式（带 SKILL.md 的文件夹）的工具。把安装提示词贴给 AI，或者把文件夹解压到它的技能目录即可。

下载包里有什么？

25 个文件：SKILL.md、5 个脚本、8 份参考资料、10 个模板和资源文件、1 个测试。

多少钱？

单独购买 US$6.99，一次性付款，含 12 个月更新。它也包含在 Get Paid 套装里。年付和终身版包含所有付费技能。

可以退款吗？

首次付款 14 天内、且没有下载任何付费技能的，可以全额退款。下载之后不退款，除非技能有缺陷且我们无法修复。

怎么获取更新？

一次性购买含 12 个月更新；年付和终身版在有效期内持续更新。在本页或账户页重新下载即可。当前版本：1.0.0。