跳过主要内容
跳到正文
Jesn Design

金融界面原则

让金额准确、假设清楚、操作状态符合实际。

本页内容

保留计算精度

Token 数量使用十进制字符串,金额使用整数最小单位或 BigInt。交付包中的金融模块支持精确计算。先计算,再按明确的舍入规则和币种单位格式化展示。

  • 拒绝不支持的精度、负金额和指数表示法。
  • 列表筛选不改变基于完整相关余额计算的总值。
  • 说明费用是从金额中扣除,还是额外收取。

说明估算假设

收益展示需要期限与计算口径。简单年化估算、APY 和复利是不同模型。费用、期限、报价来源和未包含成本应放在结果附近。

明确操作状态

区分报价、估算、草稿、已保存方案和已执行操作。不能将本机保存成功写成「已付款」「已投资」或「已成交」。接入真实服务前,应定义认证、权限、数据时效与失败处理。

按验收条件检查

每款 Skill 都包含 references/acceptance.md。定制后按其中条目检查金融边界与交互,并根据产品范围覆盖极小金额、费用超本金、数据缺失和损坏的本机记录。