Number

Number 元数据存储数字值，用于金额、数量、比例、评分、计数、时长和可按数字排序的字段。

当字段值需要计算、比较、排序、汇总，或需要以数字传给外部接口时，使用 number 处理。

值形态

type NumberMetadataValue = number | null;

写入记录前，先显式转换外部入参：

const amount = Number(payload.input.amount);
if (!Number.isFinite(amount)) {
  throw new Error('ORDER_AMOUNT_INVALID');
}