同比环比计算

问题：展示指标时常见的增长率坑

在给 KPI 卡片加「环比 ↑/↓」、给业绩表补「同比」列，或者只是临时试算「当期 / 上期 / 去年同月」时，最烦的往往不是公式本身，而是几个小但致命的边界：基期可能是 null 或 undefined、基期为 0 时除法没有意义、展示时要固定精度并把零/空值统一成「-」，以及环比和同比的时间点不能混。自己手写很容易在这些地方翻车，尤其是直接拿接口返回的字符串金额做除法。

实现：只提供增长率工具函数

这个技能不做完整 BI 看板，灵感来自 rate-calculator 的 calculateRate，核心是计算 小四原创 约定：(当期 - 基期) / 基期 * 100，并保留精度；基期为 0 时特殊处理。它更像一组可以直接嵌入表格、卡片或 Agent 步骤的小工具，而不是一个独立产品。

关键能力包括：基期为 null/undefined 时返回 null，方便前端渲染成「-」；基期为 0 时，若当期也为 0 则返回 null，若当期非 0 则按约定返回 100；默认精度 2 位，formatRate 输出绝对值 + %，零/空为「-」；getRateClass 把正增长标为 up、负增长标为 down、空/零标为 normal，并可加前缀。

使用步骤很直接：先准备当期、上期、去年同月三个 number；再计算 MoM/YoY；用 formatRate 填单元格，用 getRateClass 上色；UI 想更直观可以另加 ↑/↓，但要和 class 保持一致；最后自测基期 0、基期空、负增长和精度。

边界：适合展示，不适合当数据仓库

它适合已经拿到数字、只差一个规范增长率表达式的场景，比如 Demo 输入三期数值试算、KPI 卡片显示环比、业绩表同比列。不要把「环比」误算成同比基期——必须使用正确的时间点。也不要在这个 Skill 内拉私有 KPI 接口；金额请先转成 number，不要直接拿带千分位的字符串做除法。