查卡页面逐项使用说明

本页专门说明网页“查卡/会话统计”页面的控件和图表。它补充查卡与会话统计的字段解释，重点放在使用者实际看到的选择器、标签、自动刷新和空状态。

页面进入与机台选择

打开页面后，网页先读取当前机台账号可见的机台列表。页面可能显示机台名称、本地别名、目标标识和选择框。

单选

选择一台机台后，页面可以显示完整会话摘要，包括会话时长、窗口统计、当前在线和近期记录。

多选

可以选择多个已授权机台。多选页面会合并部分在线、时间段、趋势和近期记录；由于不同机台的时间窗口、上报延迟和会话边界可能不同，页面会隐藏或不显示完整会话摘要。

多选不是把多个响应简单相加：

• 在线人数可能是多个快照之和；
• 同一用户在不同机台可能被重复计数；
• 峰值小时可能来自不同机台；
• 最近记录必须保留来源机台；
• 不同机台时区或上报时间不一致时，趋势只能做观察。

需要精确追溯时切回单机台。

清空选择

页面提供清空/取消选择入口。清空后应同时清空当前统计和图表，避免把上一台机台的数据误看成空选择的结果。

刷新与自动刷新

手动刷新

点击刷新后页面进入加载状态，读取当前选择的所有机台。加载期间不要反复点击，也不要切换账号。

自动刷新

页面可能显示“自动刷新（每 10 秒）”开关。开启后：

• 页面按固定间隔重新读取当前选择；
• 图表和数字可能跳变；
• 当前选择通常保留；
• 请求失败会显示错误，但不会自动修复网络或权限；
• 离开页面或切换账号后应关闭轮询。

比较两个时间点时记录刷新时间，不要把两次快照直接累加。

顶部统计卡片

单机台页面通常显示：

卡片	解释
30 分钟活动	最近窗口内的活动人数/数量
1 小时活动	最近 1 小时聚合值
24 小时活动	最近 24 小时聚合值
总活动/总会话	当前统计范围内的总量
日均活动	统计窗口内的平均值
人均活动	按用户聚合的平均值
7 天活动	最近 7 天的会话/活动数量

顶部卡片是时间点快照。在线状态刚变化时，需要下一次刷新才可能反映。

在线状态与当前用户

页面可能显示：

• 工坊在线/离线徽章；
• 当前在线人数；
• 当前在线用户名称；
• 登录时间；
• 已使用时长；
• 格式化时长。

“在线”表示最近一次采样可达，不代表机台此刻一定能接受每个操作。用户刚退出、网络刚恢复或上报延迟时，名称和人数可能暂时滞后。

统计标签页

页面可能把图表分成以下标签：

时段统计

展示时间段、活动总时长、用户数和去重用户数。它适合比较繁忙时段，不适合作为精确计费依据。

日趋势

按小时展示活动人数或峰值。空点可能表示当前窗口没有数据，不要用 0 填补后再计算平均值。

食用时长

展示平均、最长、最短时长和时长分组。分组比例只针对当前统计窗口。

食用趋势

按小时显示会话数量，通常同时显示峰值小时和峰值数量。会话数量不等同于独立用户数量。

会话摘要

单机台模式可能显示：

• 最近 30 分钟会话数；
• 最近 1/2/3/6/12/24 小时会话数；
• 最近 7 天会话数；
• 日均会话数；
• 人均会话数；
• 总会话数；
• 平均、中位、最长、最短会话时长。

多机台模式下页面可能显示“暂无统计数据”并说明多选模式不提供摘要。这是为了避免把不同机台的会话边界错误合并，不是接口失败。

频率、活跃和回访

频率分析可能包含：

• 频率分组；
• 最活跃用户；
• 每人会话数；
• 总时长和平均时长；
• 首次登录和最近登录；
• 回访用户数；
• 回访率。

这些字段可能包含个人名称。只有在机台所有者允许的范围内展示，导出前应脱敏。

最近记录列表

最近游玩记录可能显示用户、登录时间、退出时间、时长和来源机台；最近会话记录还可能显示会话编号。

页面记录不是永久日志。需要追溯时同时保存：机台选择、页面刷新时间、生成时间、当前账号和错误/网络状态。

空状态与错误

现象	判断方式
未找到机台列表	检查机台账号是否完成绑定
所有机台请求失败	检查 Token、网络和权限
部分机台失败	保留成功机台，但明确标记失败来源
图表空白	检查时间窗口是否没有数据
多选隐藏摘要	属于页面设计限制
数字刷新跳变	记录生成时间后再比较

页面验收清单

1. 机台选择器能读取目标列表；
2. 单机台刷新能返回在线卡片；
3. 多机台选择能明确标记来源；
4. 自动刷新每次更新生成时间；
5. 空数据和失败数据区分显示；
6. 会话摘要在单机台/多机台下符合页面提示；
7. 离开页面后不再产生无意义刷新；
8. 分享截图前遮挡用户名称和机台标识。