数值并不是完整的事实
同一个“已使用 2.6 GB”，可以来自一分钟前，也可以来自上周。只看数值，无法判断它还能否用来做当前决定。数据展示至少有四部分：值、单位、来源和时间。缺少任何一个，读者都容易补上错误的假设。
本站的数据展示使用真实采样时间。浏览器读取时间另行显示，不把一次页面刷新当成一次数据同步。这样即使采样任务失败，读者仍能看到上次有效结果，同时知道它已经不够新。
成功、失败和过期是不同状态
成功同步意味着有新的有效结果。同步失败意味着最新尝试没有产生可用结果。过期则意味着距离上次成功已经超过约定窗口。一个旧结果仍然可能数值正确，但不足以证明当前状态。
const ageSeconds = (now - lastSuccess) / 1000;
const stale = ageSeconds > allowedAgeSeconds;
const label = readFailed ? "读取失败" : stale ? "数据已过期" : "已同步";这段示例把读取错误和有效期分开。尤其要注意：定时检查新鲜度时，不能把刚刚发生的读取错误覆盖成绿色“正常”。成功恢复需要新的有效读取证据，而不是时间经过了几十秒。
累计值需要理解周期
计费流量往往是当前周期的累计量。相邻两次采样之差，可以估计这段区间的增量；但只有在同一周期、时间连续、数值没有下降时，这个差值才有意义。跨周期直接相减，会出现负用量或把另一个周期拼进当前趋势。
周期 A：10 → 12，观测增量 2
周期 B： 1 → 3，观测增量 2
A 的 12 与 B 的 1 之间：不计算增量这是说明计算逻辑的示例序列，不是本站真实历史。周期标识、数值下降或较长缺测，都应触发曲线断开。一个重置后的低值不是丢失流量，而可能是新的周期开始。
有四个点，不等于有七天历史
图表选择“近七天”，只是查询窗口，不是数据覆盖承诺。如果只采集了几个小时，应显示实际最早和最晚时间，以及有效点数。把四个点均匀铺满七天坐标，会暗示并不存在的连续记录。
每日用量同样如此。只覆盖半小时的数据不能叫完整日用量；跨日差值也不能直接归入其中一天。将它称为“实际观测区间”，并列出覆盖时长，诚实得多。
单位也会改变判断
GB 和 GiB 不是同一个单位。前者以 1000 为基础，后者以 1024 为基础。可以同时显示人类易读数值和原始字节，但不能把原始额度乘错再藏在一个漂亮百分比里。字节与单位笔记 给出了可复算例子。
记录时间并不是装饰。它把“看见一个数”变成“理解一条信息”。在 新鲜度笔记 中，这个思想延伸到成功、未知与恢复状态。