关键指标周活跃用户
本周 · 周一至周日7 天内活跃≥1 次，按用户 ID 去重
12,480人
+8.4%环比上升
较上周 11,512 人
界面与交互 · 内容与数据展示
统计数值Statistic
把一个可解释的关键指标连同单位、口径、时间范围、比较基准与趋势方向成组呈现的内容组件；加载、暂无与失败是三种不同状态，不伪装成数字。
活跃用户指标卡：周期、格式与状态都长在瓦片上
亲手切周期、切千分位，再选好拉取结果点「重新拉取数据」，观察瓦片物件上的数字、单位、口径、比较基准、趋势方向与状态怎样一起变化——这些判断不只靠底部说明。
第 0 步：这是一张「活跃用户」指标卡。切周期、格式，或选好拉取结果再点「重新拉取数据」——观察数字、单位、口径、比较基准、趋势方向与状态怎样一起长在瓦片物件上，而不是只看底部说明。
周期
格式
拉取结果
对照：周期=周、格式=千分位、状态=已就绪，瓦片物件上同时显示 12,480 人、单位、口径、较上周基准与 ↑ +8.4% 环比上升。原因：这六件事成组出现，数字才可复核；趋势用箭头+文字+方向，颜色走 ink 不靠红绿。下一步：切到「日」看趋势翻成 ↓ 环比下降（颜色不变），或选「拉取结果=失败」再点「重新拉取数据」看错误态。
面板教会的知识点
把刚才在瓦片上看到的现象命名为六条规则。
- 数字 + 单位 + 口径成组：数字旁始终有「人」单位和「按用户 ID 去重 / N 天内活跃≥1 次」的口径说明，否则数字不可复核。
- 比较基准要写明对象：写「较上周 11,512 人」，而不是孤零零一个 +8.4%；比较对象、周期长度都要清楚。
- 趋势用箭头 + 文字 + 方向：↑ / ↓ 形状 + 「环比上升 / 环比下降」文字 + 百分比共同表达，颜色只走 ink，不用红绿独撑含义。
- 千分位提升可读性：48,920 比 48920 更易扫读；切格式时数值本身不变，只是分组呈现。
- 加载 / 暂无 / 失败是三种状态：加载显示骨架并保留指标名（不渲染假 0）；暂无数据写明「本周期没有符合口径的记录」；失败写原因、保留上次成功时间、给重试。
- 口径决定数字含义：「7 天内活跃≥1 次」与「今日 00:00 至现在」算出的数字不可直接比较；换周期时口径文字也跟着变。
什么时候用统计数值
从「要不要把一个关键数单独放大」判断，而不是看数据多不多。
用户需要一眼锁定一个关键指标并快速判断涨跌——仪表盘首屏的活跃用户、营收、转化率、任务完成数。
要看分布或趋势曲线（→ 图表）、要横向比较多条记录（→ 表格）、或只是装饰一个大数字却没口径和基准。
怎么用：从口径到窄屏的最短路径
一次到位的检查顺序。
- 定口径：先写清这个数统计什么、如何去重、覆盖哪个时间段，再展示数字。
- 定单位与格式：单位（人 / 元 / %）紧跟数字；大数字加千分位，金额考虑 ¥ 前缀。
- 定比较基准：写明对比对象与周期长度（昨日 / 上周 / 上月 / 目标值）。
- 定趋势表达：箭头形状 + 方向文字 + 百分比三件套，颜色不独撑涨跌含义。
- 定状态占位：加载用骨架保留指标名；暂无数据写原因；失败写原因、时间并给重试。
正反例：同一个「本周活跃用户」需求
只改一个关键判断——是否让数字可复核、状态可区分。
「周活跃用户 12,480 人 · 7 天内活跃≥1 次按用户 ID 去重 · 较上周 11,512 人 · ↑ +8.4% 环比上升」。 单位、口径、基准、趋势方向齐全，加载用骨架，空与失败各自显示原因。
「12,480」下面什么都没有；加载时闪一个 0；接口失败仍显示上周旧值却不标注；趋势用绿涨红跌，色弱用户看不出方向。 数字不可复核，状态被掩盖。
快速自测
统计接口返回空数组（没有报错），指标卡最合适的显示是？
继续查证
术语的技术定义和行为以这些一手或权威资料为准。
下一步学
和本知识点经常一起出现的概念。