技能介绍

要解决的具体问题

在业务系统里实现增值税价税试算，看似简单实则容易踩坑：含税金额直接乘税率算税额的数学错误、不含税用 amount × (1-rate) 的口径偏差、混用舍入位数导致对账差 0.01、缺少非法输入校验让 NaN 或负数悄悄流入结果，甚至凭空臆造 16%/17% 的旧税率档位而不说明。这些问题不仅影响开票前的自检，还会让商务测算结果不可信。

核心能力与工作方式

增值税试算 是对仓库自研 calcVat 逻辑的工程化封装，核心是把双模式换算的公式语义、舍入规则与校验边界固化下来：

双分支公式：exclusive 模式（已知不含税金额）按「税额=不含税×税率，价税合计=不含税+税额」计算；inclusive 模式（已知价税合计）按「不含税=含税÷(1+税率)，税额=含税−不含税」计算，其中 inclusive 的税额必须用差式，避免 excl×rate 再舍入导致的 0.01 偏差。
舍入与恒等约束：所有金额统一用 toFixed(2) 常规四舍五入到分；保证 exclusive 下价税合计≈不含税+税额，inclusive 下税额≈价税合计−不含税；税率为 0 时两种模式的不含税/价税合计均等于输入金额。
输入校验与即时重算：拒绝 amount < 0、NaN、非有限数；ratePercent < 0 需显式提示；结果区展示 formula 方便业务核对；输入变更时通过 @change/watch 即时重算，与演示页行为一致。
工程落地建议：优先复用仓库已有的 @/utils/localCrmTools/taxCalc 实现，避免逻辑分叉；若加固校验，建议在包装函数中 throw/Toast，不破坏旧调用方默认行为。
递归加固的回归保障：经过三轮自我改造后，技能内置了 fixtures 参考样例，要求交付前用样例手算核对，确保公式语义与源码一致。

适用边界与注意点

这是本地试算工具，不涉及税务申报、进项抵扣，也不能做成销项/进项台账或申报表，仅供开票前自检与商务测算。
禁止反模式：含税金额×税率算税额、不含税用 amount × (1-rate)、混用舍入位数、抄财务软件闭源规则却声称与仓库同源。
税率档位仅支持 1/3/6/9/13，不要用旧的 16%/17% 档位；若实现中发现新边界，应追加到 reference.md 的 fixtures 中，而非悄悄修改公式。
交付前需通过检查项：双模式公式正确、税额舍入与源语义一致、非法输入有提示、结果含 formula、fixtures 通过。