用途:处理浏览器端金额与数量的精度与舍入契约问题。核心规则是用整数最小单位或十进制类型计算与存储,只做一次舍入并显式指定模式,只在展示边缘用 Intl.NumberFormat 格式化。
主要能力:识别浮点漂移、toFixed/Math.round(x*100)/100 误用、舍入模式不一致(Math.round 偏向 +∞,Intl 默认 halfExpand,会计常用 halfEven)、逐行舍入与总计舍入的先后导致的分币偏差、拆分余额需分摊、整数最小单位溢出(2^53-1 约 90 万亿美元)、非两位小数的货币(JPY/KRW 为 0 位,BHD/KWD 为 3 位),以及本地化金额解析(Intl 只格式化不解析,Number("1.234,56") 为 NaN)。
使用方式:按契约、证据、风险、修复、验证的紧凑结构输出发现;修复建议包括改用最小单位/十进制库、设置 roundingMode、只舍入一次或用 formatToParts 解析。可用 ripgrep 探测 toFixed、Math.round、parseFloat、price/amount 等模式。
适用场景:购物车合计、税费、折扣、账单拆分、分期等浏览器端金额与数量计算。
限制:不负责展示 locale 格式(属 i18n-copy-and-layout)、日期时间时区问题(datetime-correctness)或数值输入框校验(js-form-validation-contracts)。未提供具体价格与收费信息。