历史记录与 CSV 导出
查看历史趋势和本地每日归档,选择 30 天、90 天、1 年或自定义范围并导出 CSV。
DeskPulse 在设备本地记录数据,App 连接后读取,并将每日汇总按设备身份归档到本机。电脑不必一直打开,但设备必须保持供电;准确的自然日统计还需要正常校时。长期保留每日汇总时,请在设备记录被覆盖前连接 App 并加载或刷新历史。
查看记录
- 连接设备,在切换器核对当前查看的设备,进入 App“历史数据”。可查看 CO₂、温度、湿度和光照四项指标。
- 默认显示最近“30 天”的每日汇总,可选择“90 天”“1 年”或“自定义”起止日期;查看近期细节时选择“1 小时”“24 小时”或“7 天”。
- 选择要查看的传感器指标,查看趋势、均值和高低点。
- 在支持的范围内查看在位/番茄阶段时间轴,或每日对比。
- 需要重新读取时点击“刷新”,等待加载完成。
历史数据按时间范围采用不同精度:
| 范围 | 传感器记录 | 行为记录 |
|---|---|---|
| 最近 1 小时 | 每 2 分钟一条,取窗口内最后有效值 | 使用已保留的活动事件 |
| 最近 24 小时 | 每 30 分钟一条有效分钟加权平均 | 使用已保留的活动事件 |
| 最近 7 天 | 每 2 小时一条有效分钟加权平均 | 最多保留 7 天、4096 条活动事件 |
| 30 天、90 天、1 年或自定义日期 | 已读取并归档的每日有效数据均值 | 本机已保存的每日汇总;设备仅保留 29 个完成日与当前日 |
大范围图表不会包含每秒的原始读数。近期活动很多时,事件数量上限可能使精确时间轴不足 7 天;已淘汰的事件无法通过多次刷新找回。
本地每日归档
App 0.1.8 起,每日汇总会保存到本机,重启 App 后和离线时仍可查看。不同设备分别归档,不会合并;页面显示本机日期范围、已保存天数和最后保存时间。
- 已归档日期可超过设备的 30 天保留窗口。30 天、90 天、1 年和自定义范围只展示实际已有的数据,未归档日期保持空白,不补零。
- 归档在历史加载或手动刷新时进行,没有后台定时归档。长时间未连接,设备已覆盖且未归档的数据无法补回。
- 当天或其他未定稿快照可能继续变化,后续正式日汇总会更新同一天,不会重复累计。
- 长期保存的是每日汇总,不是全部原始传感器点或逐条活动事件;近期细节仍受设备保留窗口和当前缓存限制。本机归档也不是云同步或整机备份。
等待加载
新版设备在后台资源可用时开始读取,不再等待每分钟的固定读取窗口;首页连接后也会立即请求历史。历史页按当前所选范围补齐记录与在位、番茄钟的起始状态,范围完整后即可结束刷新,不必每次读取全部保留事件。
手动刷新会更新最新部分并复用已确定的历史;切换更早范围时继续补齐。加载进度区分实际请求批次与复用事件数。大量记录或设备正在处理存储等任务时仍可能需要等待,请观察进度,不要反复刷新或同时发布主题、升级固件。
读取失败时 App 保留上一次成功结果;断线后停止继续补页;切换设备时分别展示对应设备的记录。离线可查看已保存的每日归档,近期细节只显示已有缓存,不会继续同步新记录。
当前历史使用 v5,App 与固件需配套升级。从旧雷达 / 旧历史格式首次切换必须恢复出厂,旧历史不迁移,重新配网和配对;已经使用新版格式的同代次更新不要求重复清除。见版本更新。
理解统计口径
- 在桌前时长来自设备在位记录;专注时长来自番茄钟实际专注阶段,两者不要求相等。
- 雷达确认离席后结束当前在位会话,返回从零开始。离开确认延迟期间仍按在位累计,默认 20 秒,可在雷达设置调整;确认后的离席区间不合并或补算为在位。未知、重启和数据中断保留未知区间。休息提醒的累计规则独立,见提醒说明。
- “未知”表示没有足够证据判断状态,不应理解为“离位”。
- 数据覆盖率针对当前所选传感器指标,反映记录完整程度。
- 日均统计按有数据的日期计算;“进行中”表示当天尚未结束。扩大日期范围不会让缺失日期变成零值。
时间与断电
历史活动时间轴以设备快照的采样截止时间为准,分页耗时或电脑时间继续前进不会把最后一个状态延伸到未读取的未来。“最后同步”应结合对应范围的截止点查看,不能当作每秒持续更新的保证。
趋势图在有可确定时间的记录时按实际时间间隔展示。关机、重启、缺失读数或无法证明连续采样的区间会断开,不把空白补成零或跨缺口连线;未校时记录仍保留原始顺序,不编造绝对时间。图表中的缺口不增加原始记录,也不写入 CSV。
首次开机后要等有效采样窗口完成才会生成历史点。未校时记录可以保留,但无法可靠确定日期的记录不会凭空补成某个时间。
界面可能显示“已校时”“推断时间”或“未校时”。设备默认使用 UTC+8 时间;修改天气城市不会修改设备系统时区。部分展示按电脑本机时区处理时,App 会显示提示。
记录是分批写入设备存储的。突然断电可能丢失最近约十分钟尚未写入的两分钟传感器记录,另加未完成的采样窗口;设备忙或写入失败时可能更久。当前日汇总也不保证每次断电都完整保留。重要记录请定期导出。
导出 CSV
- 在 macOS 或 Windows 桌面 App 选定时间范围,等待需要的数据加载完成。
- 点击“导出 CSV”,选择“传感器数据(全部指标)”“活动事件”或“每日汇总(完整自然日)”。
- 在文件保存窗口选择位置,确认 App 显示导出成功和记录条数。
导出包含所选范围内可用的数据;90 天、1 年或自定义范围的每日汇总可来自本机归档,不额外截断为最近 30 天。未校时记录仍会保留,但绝对时间可能为空;每日汇总保留完整自然日累计值,不会按图表中截取的小时范围拆分。没有记录的日期保持缺失,不生成零值数据。
恢复出厂设置或 USB 完整重装会删除设备历史。导出的 CSV 用于留存和分析,当前没有将 CSV 导回设备恢复历史的用户入口。