数据来源标签也是一种承诺

图表旁边写着“Cloudflare”，访客会自然地认为这些数字来自真实连接，并且代表某种明确的统计口径。一个来源标签看起来只是注释，却会形成关于数据真实性、时效性和范围的承诺。

因此，显示来源名称并不等于显示来源状态。系统可能已经配置了令牌，却无法完成查询；请求也可能成功，但数据仍有上报延迟或范围限制。来源、连接状态和具体指标之间，需要分别说清楚。

来源名称不等于数据可用

可以把数据面板拆成几条独立信息：当前使用什么来源、最近一次成功读取是什么时候、正在显示真实数据还是演示样例，以及读取失败时发生了什么。这样，源名称不会在空白图表旁边制造“连接正常”的错觉。

失败时也不应填入零值来维持图表完整。零是一次成功查询后得到的结果；读取失败代表当前还不能确认结果。把二者分开，既让访客知道该相信什么，也方便维护者定位问题。

指标名称也有边界

同样一个“访问量”，可能是请求数、页面浏览、访问会话或去重访客。它们不是可以互换的词。统计来源会影响数据的计算方式，页面路由切换也未必会被服务器端的页面浏览指标记录。

因此，图例、单位和说明应当对应实际使用的指标。若一个区域榜按 visits 排序，就应解释它不是独立人数；如果年度筛选中的地区数据只覆盖最近 30 天，也应把范围放在榜单附近，而不是埋在页面底部。

让新鲜度可见

一次成功的读取也不一定意味着“此刻”。数据可能按小时或按天聚合，服务商可能延迟提供结果，应用自身也可能缓存响应。展示更新时间和时间范围，可以让访客把当前视图放在正确的时间尺度上理解。

对维护者来说，生产与本地预览也要分开验证。本地开发环境能加载图表，不代表生产密钥、服务权限和外部连接都正常；反过来，本地代理不能连接外部服务，也不一定说明生产环境故障。

数据界面的可信度，来自标签兑现的细节：来源可查、指标有定义、时间有范围、失败会承认。只有在这些信息都成立时，一张漂亮的图表才真正是在展示事实。