《AI 产品的商业化·成本、毛利与收入运营》7.1 价格表与规则引擎

计费引擎的核心不是扣款函数,而是带版本与生效窗口的价格表。本节用 LumenDesk 的 49 美元席位费、Verba 的 0.006 美元单分钟价与 ClausePilot 的 2400 美元平台费,拆解规则匹配、优先级、金额舍入与历史报价回放,并给出规则冲突与未定价的处理边界。

以下三家公司与全部数字均为教学假设,用于演示商业化计算,不代表任何真实企业。

计费引擎的第一件事不是扣款

很多团队做计费,第一反应是写一个扣款函数:拿到用量,乘上单价,写入账单。这个函数在演示环境里永远正确,因为价格只有一套、用量只有一条、时间只有一个点。到了生产环境,三件事同时变化:价格会调、客户会有专属折扣、用量事件会迟到。扣款函数本身没有错,错的是把价格当成了代码里的常量。

计费引擎真正的核心是一张价格表,以及一个把「事件 + 时间 + 客户」解析成「适用规则」的解释器。扣款只是解释之后的一步。把顺序倒过来,系统会在第一次调价时崩溃:旧账单被新价格重算,客户看到的历史金额变了,财务无法对账,客服无法解释。

这也是为什么计费引擎不能和业务代码长在一起。业务代码的发布节奏是按天算的,价格表的变更节奏是按合同算的。两者的审批人、回滚方式、审计要求都不同。把价格写进业务代码,等于让一次产品发布顺带修改了所有客户的合同。

一条价格规则至少要有七个字段

一条价格规则不是一个数字,而是一行带上下文的数据。最小可用的规则至少包含七个字段:

  • 规则 ID:稳定不变,账单行引用它,不用价格本身做标识。
  • 版本:同一规则 ID 的不同版本,例如 2026-11。
  • 计量单位:对话、分钟、案件、席位,单位不同不能比较。
  • 单价:以 micro-USD 存储,避免小数在累加中漂移。
  • 生效窗口:开始时间与结束时间,左闭右开。
  • 适用范围:全局、某个套餐、某个客户。
  • 优先级:同一适用范围下的显式排序。

七个字段里,最容易被省掉的是版本和生效窗口。很多团队用「当前价格」一张表打天下,调价时直接改数字。这样做看起来简单,实际把历史账单变成了不可复现的文档:三个月后客户问「当时为什么收这个价」,系统里只剩今天的价格,没人能证明当时适用的是哪一版。

单价用 micro-USD 而不是美元小数,是为了让累加保持整数。Verba API 的转写单价是 0.006 美元,写成 6,000 micro-USD;LumenDesk 的单次变动成本是 0.015 美元,写成 15,000 micro-USD。只有在生成账单行时,才把总额一次性换算成美分。换算点越少,舍入误差越可控。

规则解析:具体度先于优先级

规则解析不是「找到第一条匹配的规则」,而是「在所有匹配的规则里选一条,并证明没有第二条同样有资格」。顺序通常是:

  1. 按计量单位过滤。
  2. 按事件发生时间过滤生效窗口。
  3. 按套餐与客户过滤适用范围。
  4. 按具体度排序:客户级高于套餐级,套餐级高于全局。
  5. 具体度相同时按显式优先级排序。
  6. 仍然并列时,不猜,直接报规则冲突。

第 6 步是关键。很多引擎在这里用「后写入的覆盖先写入的」或者「按 ID 排序取第一条」蒙混过关。这两种做法在测试环境都能跑,在生产环境会制造一种极难排查的问题:同一个客户、同一时刻、同一指标,昨天的报价和今天不一样,但价格表里没有任何一行被修改过。排序不稳定,账单就不稳定。

具体度先于优先级,是因为客户级规则的存在意义就是覆盖。一个客户谈到了专属单价,这条规则应该赢过任何全局规则,不管全局规则的优先级数字写得多大。优先级只应该用来解决同一具体度内部的顺序,比如同一个套餐下「促销价」高于「标准价」。

没有匹配规则时,引擎必须返回一个显式的未定价状态,而不是默认零元。零元是一个合法的价格,未定价不是。把两者混在一起,收入会在无人察觉的情况下漏掉。未定价事件应该进入延迟计费队列,由 7.3 的兜底流程处理,而不是当场写一张 0 美元账单。

用事件时间,而不是账单时间

价格规则带生效窗口,随之而来的问题是:用哪个时间去找规则?

正确答案是事件发生时间,不是账单生成时间。假设 LumenDesk 在 10 月 15 日宣布 11 月 1 日起调整席位价。一个发生在 10 月 31 日 23:59 的对话,应该按调整前的规则计价;一张在 11 月 2 日生成的账单,不能把这个事件重新按调整后的价格算。

用账单时间会带来两个后果。第一,跨月调价时,同一批事件在月初和月末生成的两张账单可能采用不同价格,客户对不上。第二,补录和重放会改变结果:6.2 讲过,迟到事件可能在几天后补进来,如果计价依赖「处理时间」,同一事件补录前后会得到不同金额。

事件时间还会影响版本选择。一个事件应该同时记录「发生时间」和「计价时间」:前者用来选规则,后者用来审计「我们是什么时候知道这件事的」。两者都保留,才能在事后解释清楚,为什么一笔 10 月的用量用了 10 月的价格,却出现在 11 月的账单上。

一次报价的完整链路

下面这段代码把价格表、规则解析与报价串起来。规则用整数 micro-USD 表示单价,金额累加后一次性换算成美分。

// file: src/ops/07-1-rate-engine.ts
// tier: L1
// verify: node --test test/ops/07-1-rate-engine.test.ts

// 价格表与规则引擎:价格是带生效窗口的版本化数据,规则按具体度与优先级定序。
import { type Result, ok, fail } from "../core/result.ts";

export type Metric = "conversation" | "transcribe_minute" | "diarization_minute" | "platform_month" | "case" | "seat";

export type RateRule = {
  id: string;
  version: string;
  metric: Metric;
  unitPriceMicros: number;
  effectiveFrom: number;
  effectiveTo: number;
  plan: string | null;
  account: string | null;
  priority: number;
};

export type Scope = { plan: string; account: string | null };
export type Quote = { ruleId: string; version: string; quantity: number; amountMicros: number };

function specificity(rule: RateRule): number {
  return rule.account !== null ? 2 : rule.plan !== null ? 1 : 0;
}

function matches(rule: RateRule, metric: Metric, scope: Scope, at: number): boolean {
  return (
    rule.metric === metric &&
    at >= rule.effectiveFrom &&
    at < rule.effectiveTo &&
    (rule.plan === null || rule.plan === scope.plan) &&
    (rule.account === null || rule.account === scope.account)
  );
}

/** 同一时刻同一指标只应命中一条规则;并列冲突显式失败,不赌排序。 */
export function selectRule(
  rules: readonly RateRule[],
  metric: Metric,
  scope: Scope,
  at: number,
): Result<RateRule> {
  const hits = rules.filter((rule) => matches(rule, metric, scope, at));
  if (hits.length === 0) return fail(`UNRATED: ${metric}`);
  hits.sort((a, b) => specificity(b) - specificity(a) || b.priority - a.priority || b.effectiveFrom - a.effectiveFrom || a.id.localeCompare(b.id));
  const [top, second] = hits;
  if (second && specificity(second) === specificity(top) && second.priority === top.priority) {
    return fail(`AMBIGUOUS: ${top.id} / ${second.id}`);
  }
  return ok(top);
}

/** 报价金额用 micro-USD 累加,入库前再统一舍入到美分。 */
export function quote(rule: RateRule, quantity: number): Quote {
  if (!Number.isInteger(quantity) || quantity < 0) throw new Error("quantity 必须是非负整数");
  return { ruleId: rule.id, version: rule.version, quantity, amountMicros: quantity * rule.unitPriceMicros };
}

export function microsToCents(micros: number): number {
  return Math.round(micros / 10_000);
}

const ALL_TIME = { effectiveFrom: 0, effectiveTo: 9_999_999_999_999 };
const GLOBAL = { plan: null, account: null, priority: 10 };

export const RATE_BOOK: readonly RateRule[] = [
  { id: "lumen.seat", version: "2026-11", metric: "seat", unitPriceMicros: 49_000_000, ...ALL_TIME, ...GLOBAL },
  { id: "lumen.overage", version: "2026-11", metric: "conversation", unitPriceMicros: 40_000, ...ALL_TIME, ...GLOBAL },
  { id: "verba.transcribe", version: "2026-11", metric: "transcribe_minute", unitPriceMicros: 6_000, ...ALL_TIME, ...GLOBAL },
  { id: "verba.diarize", version: "2026-11", metric: "diarization_minute", unitPriceMicros: 2_000, ...ALL_TIME, ...GLOBAL },
  { id: "clause.platform", version: "2026-11", metric: "platform_month", unitPriceMicros: 2_400_000_000, ...ALL_TIME, ...GLOBAL },
  { id: "clause.case", version: "2026-11", metric: "case", unitPriceMicros: 180_000_000, ...ALL_TIME, ...GLOBAL },
];

代码里的 selectRule 返回 Result,而不是抛异常或返回 null。计费链路上的失败有两类:一类是「没有规则」,一类是「规则冲突」。两者都需要被上层看见,而不是被一个默认值吞掉。Result 让调用方必须显式处理这两种情况。

把三家公司的量代进去,可以得到三组可核对的报价。

LumenDesk 的席位费:1,920 个席位 × 49 美元 = 94,080 美元。超额部分:1,920 个席位 × 120 次 = 230,400 次,每次 0.04 美元,合计 9,216 美元。两项相加,MRR 为 103,296 美元,与事实表一致。

Verba API 是两条计量行:转写 42,000,000 分钟 × 0.006 美元 = 252,000 美元;说话人分离 42,000,000 分钟 × 0.002 美元 = 84,000 美元。合计 336,000 美元。注意这里的 0.006 与 0.002 是两个独立指标,不能合并成一条「0.008 美元」的规则再去乘一次,否则以后调其中一项价格时,另一项会被动跟着变。

ClausePilot 是平台费加案件费:85 家 × 2,400 美元 = 204,000 美元;3,230 件 × 180 美元 = 581,400 美元。合计 785,400 美元。平台费按月收取,案件费按件收取,两者的计量周期不同,必须分成两条规则、两行账单。

三组数字都能从价格表重新算出来,这是规则引擎的第一个验收标准:给定同一批事件和同一版价格表,任何一次重放都必须得到同一组金额。

舍入:一次调用一次舍入会把成本放大三成

金额舍入是计费引擎里最不起眼、也最容易造成系统性偏差的地方。

LumenDesk 的单次变动成本是 0.015 美元,也就是 1.5 美分。一个席位每月 620 次,精确成本是 620 × 1.5 = 930 美分。如果引擎在每次调用后都把金额四舍五入到美分,1.5 美分会变成 2 美分,620 次就是 1,240 美分。相对精确值高出 33.3%。

这个偏差不是随机误差,而是单向的。只要单价带有半分位,逐次舍入就会稳定地向上偏。调用量越大,偏差越像一笔隐形的加价。客户可能察觉不到,但你的毛利表和供应商账单会对不上。

正确做法是:计价阶段全部用 micro-USD 累加,只在生成账单行时舍入一次。舍入规则也要写死,比如「四舍五入到美分」,并在测试里用固定样例锁住。退款和负数金额要用同一套规则,否则冲正时会出现一分钱的差额,财务对账永远差一点。

还有一类舍入发生在用量侧,而不是金额侧。按分钟计费时,不足一分钟算一分钟,还是按秒折算,会直接改变用量。Verba API 按分钟计价,如果每次调用都向上取整到分钟,大量短音频的账单会明显高于实际时长。用量口径必须和金额口径一起定义,不能只定义其中一个。

价格表要能被回放

价格表的价值不只是「现在能算对」,而是「三个月后还能算对」。这要求账单行保存计价时的快照,而不是只保存一个指向当前规则的 ID。

一条账单行至少应该冻结四个值:规则 ID、规则版本、单价、计价时间。有了这四个值,即使价格表后来改了十版,历史账单仍然可以逐行解释。反过来,如果账单行只存了规则 ID,而价格表是原地更新,那么历史账单在数据库里看起来还在,实际已经无法复现。

价格表的修改也应该走版本化流程,而不是原地更新。一次调价应该新增一行规则、关闭旧行的生效窗口,而不是把旧行的单价改掉。旧行保留,历史才有依据;新行生效,未来才有价格。这个模式在数据库里表现为只追加,不更新。

审批同样重要。价格变更应该至少经过两个人:一个负责商业判断,一个负责核对适用范围与生效时间。单人可以直接改价格表,等于单人可以直接改所有客户的账单。这不是技术问题,是控制问题。

最后是测试。价格表应该有「黄金报价」测试:固定一组事件、固定一版价格表、固定一个时间点,断言算出来的金额。三家公司的月度报价就是天然的黄金样例。每次修改解析逻辑或舍入规则,这组测试必须仍然通过;如果不通过,要么是逻辑错了,要么是价格表被意外改动了。

版本号、生效时间与审批时间

价格表的版本号最好人能读懂,但不要只有人能读懂。2026-11 这种按月命名的版本适合对外沟通,数据库里还应该有一个单调递增的序号,用来保证同一规则 ID 的版本不会重复。只靠日期命名,一天内两次调价就会撞号;只靠自增序号,客户看不懂账单上写的是什么。

一条规则实际上有三个时间:审批时间、生效时间、录入时间。审批时间是商务和法务签字的时间,生效时间是这条价格开始适用于事件的时间,录入时间是它被写进系统的时间。三者可以不同,而且经常不同。

审批在 10 月 20 日完成、11 月 1 日生效、10 月 25 日录入,这是正常流程。审批在 11 月 1 日完成、要求追溯到 10 月 15 日生效,这是补录,必须留下单独标记,不能伪装成正常调价。录入时间晚于生效时间本身不是问题,问题是事后修改历史。

紧急调价也应该走新增版本,而不是修改旧版本。紧急只意味着审批可以加急,不意味着可以绕过版本化。旧版本继续对旧事件生效,新版本对新事件生效,中间不留断档,这是价格表最基本的纪律。

一个最小可用的上线检查清单

价格表上线前,至少跑完下面六项检查。它们不追求覆盖所有情况,但能挡住绝大多数会在生产环境里变成争议的错误。

  1. 每个计量指标至少有一条全局规则,确保没有客户会掉进「无规则」的空档。
  2. 每条客户级规则都填了 account,并且用一个不属于该客户的样例验证它不会命中。
  3. 同一规则 ID 的相邻版本之间,生效窗口既不重叠也不留缺口。
  4. 三家公司的黄金报价与事实表一致:LumenDesk 103,296 美元、Verba 336,000 美元、ClausePilot 785,400 美元。
  5. 窗口的第一秒、最后一秒、以及窗口之外的下一秒,分别返回预期规则或 UNRATED。
  6. 人为删掉一条规则,确认未定价事件进入延迟计费队列,而不是生成 0 美元账单。

六项里最容易漏的是第 2 项和第 6 项。前者是范围错误,后者是失败路径。范围错误往往要等到一个不该享受专属价的客户被发现才暴露;失败路径则可能几个月都不触发,直到某次调价留下一个窗口缺口。两者都不会在 happy path 上出现,所以必须主动演练。

三种规则冲突

规则冲突不是罕见事故,而是价格表变大之后的常态。最常见的三种形态如下。

冲突形态表现处理
生效窗口重叠同一指标、同一适用范围出现两条有效规则解析时报 AMBIGUOUS,拒绝出账
具体度误配客户级规则把 account 写成 null,变成全局规则上线前用样例客户跑一遍匹配
版本断档旧规则已过期,新规则尚未生效报 UNRATED,进入延迟计费

第一种冲突通常来自调价:新版本规则建好了,旧版本忘记关闭生效窗口。第二种冲突来自复制粘贴:从全局规则复制一条客户专属规则,只改了价格,忘了填客户 ID,结果这条规则对所有客户生效,而且因为具体度相同,可能和原规则并列冲突。第三种冲突来自时间:价格表在月初切换,但事件时间落在切换前的空档里。

三种冲突的共同点是「不会在正常路径上暴露」。平均用量、标准客户、当月事件,往往都能绕过它们。真正触发冲突的,是长尾客户、补录事件和跨月调价。所以价格表的上线检查不能只跑一条正常样例,要跑边界样例:窗口的第一秒、最后一秒、客户专属与全局同时命中的客户、以及一个没有规则覆盖的指标。

规则引擎不负责什么

规则引擎只负责一件事:把事件解析成金额。它不负责折扣审批,不负责税费计算,也不负责收款。把太多职责塞进来,会让价格表变成一张什么都管的配置表,最后没人敢改。

折扣审批属于商务流程,规则引擎只接收审批后的结果,把它表达成一条客户级规则。税费属于账单与合规流程,8.1 会讲账单明细如何呈现。收款属于支付系统,7.3 会讲支付失败后的兜底。规则引擎的边界清楚,价格表才能保持可读。

这条边界还有一个实际好处:当计费结果和客户预期不一致时,可以先判断问题出在哪一层。是规则没匹配上,是金额舍入错了,是折扣没生效,还是账单展示漏了一行。四类问题的排查路径完全不同,混在一起只会让每一次争议都从零开始。

小结

  • 计费引擎的核心是带版本与生效窗口的价格表,扣款只是解析之后的一步。
  • 一条规则至少要有 ID、版本、计量单位、单价、生效窗口、适用范围、优先级七个字段。
  • 规则解析按具体度、优先级、生效时间排序;仍然并列时报冲突,不用不稳定排序蒙混。
  • 计价使用事件发生时间,不用账单生成时间,否则补录与跨月调价会改变历史金额。
  • 金额用 micro-USD 累加,账单行生成时只舍入一次;逐次舍入会让 620 次调用多算 33.3%。
  • 账单行要冻结规则 ID、版本、单价与计价时间,价格表只追加不原地更新。
  • 规则冲突与未定价都必须显式失败,分别进入冲突处理与延迟计费队列。

阅读导航:上一节:6.3 用量数据的审计轨迹 · 下一节:7.2 额度扣减与超额计算 。

常见错误与边界

  • 把价格写成代码常量,调价必须发版,历史账单随新版本一起被重算。
  • 规则匹配用「第一条命中」或「后写入覆盖」,同一事件在不同时间得到不同金额。
  • 计价使用账单生成时间,跨月调价与迟到事件补录后金额发生变化。
  • 每次调用都舍入到美分,单价带半分位时产生单向的、随用量放大的偏差。
  • 没有匹配规则时默认收零元,把未定价事件静默写成免费账单。
  • 价格表原地更新、不留版本,三个月后无法向客户解释当时的收费依据。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图