SuperAPI AI 工具集

dinero-best-practices

编程与开发

查看项目

更新于 10-15 21:10

技能介绍

用途:为使用 Dinero.js(JavaScript/TypeScript 货币库)创建、计算和格式化金额时提供核心规则,适用于处理用户输入、API 响应或数据库数值生成 Dinero 对象,以及对金额做加、拆分、乘法等运算,并涉及价格、成本、税费等财务计算的场景。

主要能力:按影响优先级分为四类规则。对象创建(CRITICAL):金额始终以最小货币单位的整数传入;用辅助函数把浮点输入转为最小单位;指数为 0 的货币(如 JPY)直接使用主单位。算术(CRITICAL):所有操作返回新对象,须接收返回值;拆分金额使用 allocate 而非手动除法;不要与原始小数相乘,应使用缩放后的金额;百分比用 allocate 或缩放乘法计算。精度(HIGH):金额超过 Number.MAX_SAFE_INTEGER 时使用 dinero.js/bigint;加密货币因高指数需要 bigint;链式运算后用 trimScale 去除末尾零。导入(MEDIUM):只导入用到的内容,独立函数支持 tree-shaking;计算器类型要匹配,使用 dinero.js/bigint 时配合 dinero.js/bigint/currencies。

使用方式:文档按规则提供独立文件(如 rules/creation-minor-units.md、rules/arithmetic-allocate-not-divide.md),每条含原因说明、错误示例与正确示例及补充上下文;在编写、审查或重构 Dinero.js 代码时按上述优先级对照采用。

限制:本资料仅列出规则名称与分类,未提供具体代码示例、安装命令、收费或平台支持信息,这些内容暂未提供。