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 系列

  1. 我想留下怎样的生活记录
  1. 从足迹地图到个人数据看板
  1. GPS 轨迹背后的日期、里程与质量
  1. Watch 和手机都在记步,该怎样处理
  1. 让个人数据可以更新,也可以回退
  1. “睡了多久”该怎样从记录里算出来
  1. 从数字到近期状态
  1. 让自己愿意打开它——界面、交互与双主题
  1. 我和 AI 怎样推进这个个人项目
作者:KuAcha
声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。

Previous

MyPad 开发记录(七):从数字到近期状态

Next

MyPad 开发记录(五):让个人数据可以更新,也可以回退