MyPad 开发记录(六):“睡了多久”该怎样从记录里算出来
本文回顾 2026 年 11 月 5—6 日的睡眠准备与健康指标接入,按 METRICS 验收日期归档,集中整理于 2026 年 11 月 16 日。示例时间和数值为合成数据;没有在写作时重读私人 XML 或重新计算健康数据。
MyPad 的健康页面早期已经能够画睡眠图。等到要把“近期睡眠”作为状态指标时,原来的日汇总需要重新检查。
一晚睡眠并不是原始文件里的一行数值。Apple Health 导出会留下多条区间记录,其中有在床、睡着、清醒与不同睡眠分期;它们可能跨午夜,也可能彼此重叠。
所以这一轮先退回记录层,明确每类区间的含义,再决定怎样得到一个可以比较的日值。
先区分几种容易混在一起的时长
项目把睡眠相关内容映射为在床、清醒、未细分睡眠,以及 Core、Deep、REM 等类别。它们不能直接全部相加。
量 | 项目中的含义 |
span | 一次 session 从最早开始到最晚结束的跨度 |
asleep | 被睡眠记录覆盖的区间并集时长 |
awake | session 内清醒区间的并集时长 |
unobserved | session 跨度内没有被睡眠或清醒状态覆盖的部分 |
inBed | 单独保留的在床资料,不替代睡眠时长 |
假设有两段合成睡眠:00:00—01:00、02:00—03:00,中间 01:00—02:00 记录为清醒。它们可以被组织为一次 session,但睡眠合计仍然是 120 分钟,跨度是 180 分钟。
如果中间没有清醒记录,只是缺了一小时,那一小时也不能自动补成睡眠。
session 的分组间隔,不参与补时
本轮采用的 session 分组参数为 90 分钟,用于决定相邻睡眠片段是否合成一组。它是一项算法参数,不是“间隔小于 90 分钟就算睡着”。
实际睡眠使用区间并集。同一时间被两条记录覆盖,也只贡献一次时长。
下面是简化的并集示例,以午夜后的分钟数表示合成区间,省略了日期、来源、分期和质量检查:
这个函数没有把两段之间的空白补进去,也没有因为第一段出现两次而多计一小时。项目的完整实现还需要另外计算清醒、分期、重叠和来源冲突。
先把一段睡眠组织完整,再决定属于哪天
另一处修正与顺序有关。
如果先按每条记录的结束日期分桶,一次跨午夜的睡眠可能被拆成两天。当前方法先在 UTC 时间线上形成 session,再按最后结束记录自身的偏移,计算醒来日。
例如合成记录 1 月 1 日 23:00—23:30、1 月 2 日 00:00—01:00,在满足分组规则时应组成一次 session。睡眠并集是 90 分钟,归到 1 月 2 日,跨过的半小时空白不算睡眠。
健康记录使用自己的时间依据,不借 GPS 位置替它推断时区。真实导出里观察到的偏移都是
+08:00,这只能说明文件里的时间表达,不能证明旅行期间实际所在地的时区已经被正确保留。跨偏移的情况主要由合成测试覆盖,不能写成真实旅行记录已经全面验证。主睡眠也是一个需要标注的选择
同一个醒来日可能对应多次 session。项目按实际睡眠并集时长选最长的一次作为主睡眠候选,其他单独放入
other_sleep。它没有用固定夜间时段判断,也没有把其他睡眠一概当成午睡。当两次候选很接近、跨度异常或未观察间隔过长时,保留待核标记。
睡眠分期也需要独立核对。同类别先求并集;不同分期互相重叠时,不能把它们继续相加成一份精确总量。没有分期记录时使用空值,而不是把未测量的 Deep 或 REM 写成零。
同理,只有在床记录的日期,主睡眠应该保持缺失,不能因为“没有找到 asleep”就宣布当天睡眠为零。
第一版的错误,值得保留在过程里
这一轮不是一次就得到最终候选。记录中保留了早期失败与后续修正。
合成反例 | 早期问题 | 后续处理 |
两段睡眠中间有清醒 | 把整段跨度当成睡眠 | 分开计算睡眠并集、跨度与清醒 |
睡眠跨午夜 | 先分日,拆成两份主睡眠 | 先形成 session,再归醒来日 |
两来源覆盖相同分期 | 睡眠已去重,分期仍重复累计 | 分期也求并集,并标记冲突 |
还有一版在处理没有主睡眠的情况时失败。失败产物被保留,没有覆盖成后来的成功结果。
DSH 进行候选实现与整改,Work 做复核。反例比“结果看着像一晚正常睡眠”更有用:它能说明某条规则为什么错,修正后又具体改变了什么。
从独立派生接到指标层
睡眠候选先复用已经生成、并核对来源身份的缓存。后续健康包把睡眠、HRV、静息心率和运动作为首版状态指标的健康输入,保留单位、来源和质量信息。
HRV 与静息心率按日形成记录统计,再参与窗口比较。运动使用记录时长,处理单位、重复、重叠与跨日边界;没有运动记录也不直接填成真实零运动日。
这些新指标通过只读文件包接入,没有把旧健康表全部覆盖。旧页面中的历史导入统计与新指标可能不同,界面需要说明它们各自的口径,不能拿其中一份悄悄替代另一份。
11 月 6 日的收口记录表明,METRICS 已正式部署并完成所有者验收。但数据源日期仍然较旧,近期窗口会不足;主睡眠仍是有质量标记的算法候选,不能据此生成医学诊断或证明记录完整。
这次处理让我把原来写在图上的“睡眠时长”拆开看了一遍:原始区间、session、归日、主睡眠选择和窗口统计,各自有自己的假设。之后再谈“最近睡得怎样”,至少可以先说明那个数字是怎么来的。
资料
类别含义参考官方资料;session 分组、主睡眠候选和质量策略是 MyPad 的项目规则,并非 Apple 的官方睡眠计算算法。
MyPad 系列
作者:KuAcha
声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。
Previous
MyPad 开发记录(七):从数字到近期状态
Next
MyPad 开发记录(五):让个人数据可以更新,也可以回退