商业化packages/commerce/metering

metering 能力包

基于 ClickHouse 的用量计量 — 秒级写入、按租户查 quota，可直接接 Stripe 计量计费或产品内额度。

稳定性: 稳定
作用域: 按租户隔离
边界: packages/commerce/metering
归属: @nebutra/commerce

@nebutra/metering

tenant_org_abc123Pro实时

API 调用
4,521
/ 10,000
x
AI tokens
84.7万
/ 200万
x
存储
12 GB
/ 50 GB
x
活跃用户
38
/ 100
x

计量项	本期用量	上限	使用率	计费档位
api_calls	4,521	10,000	x 45%	Pro · $0.001/次
ai_tokens	847,000	2,000,000	x 42%	Pro · 按量
storage_bytes	12,000,000,000	50,000,000,000	x 24%	Pro · 含 50 GB
active_seats	38	100	x 38%	Pro · 席位

使用方式metering.ts

typescript

metering.ts

1import { getMetering, createUsageEvent, COMMON_METERS } from "@nebutra/metering";
2
3const metering = await getMetering();
4
5await metering.ingest(
6  createUsageEvent(COMMON_METERS.API_CALLS.id, org.id, 1, {
7    endpoint: "/api/chat",
8    model: "claude-sonnet-4-6",
9  }),
10);
11
12const quota = await metering.getQuota(org.id, "api_calls");
13// → { limit: 10000, used: 4521, remaining: 5479, percentage: 0.4521 }