更新中断不丢数据,也不从头乱来
现在
在用
截至 10 月 11 日

个人健康证据与安全决策 · 功能说明

日常更新不用反复下载多年的完整记录:首次建立历史,此后仍覆盖全部 22 类字段,只补上次未完整的中国日及之后。中途失败沿同一清单继续,原件可回读,不误选另一批文件。

当前情况:真实采集已经在跑:已保存 16 份采集清单,其中 13 份完成,分布在 6 个更新日,最近一次 10 月 7 日;完整日期范围 8 月 5 日—10 月 6 日,共 63 天(范围长度不代表每天都有记录)。另外 3 份停在“进行中”的是留存的旧状态,不代表还有 3 个进程在跑。以上是 10 月 11 日只读清点的数,本次没有联网导入。

具体测试保留各自日期,页面不实时探测运行状态。

项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

更新中断不丢数据,也不从头乱来
现在
在用
截至 10 月 11 日

个人健康证据与安全决策 · 功能说明

日常更新不用反复下载多年的完整记录:首次建立历史,此后仍覆盖全部 22 类字段,只补上次未完整的中国日及之后。中途失败沿同一清单继续,原件可回读,不误选另一批文件。

当前情况:真实采集已经在跑:已保存 16 份采集清单,其中 13 份完成,分布在 6 个更新日,最近一次 10 月 7 日;完整日期范围 8 月 5 日—10 月 6 日,共 63 天(范围长度不代表每天都有记录)。另外 3 份停在“进行中”的是留存的旧状态,不代表还有 3 个进程在跑。以上是 10 月 11 日只读清点的数,本次没有联网导入。

具体测试保留各自日期,页面不实时探测运行状态。

项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

数字截至 2026 年 10 月 31 日

这项功能怎样使用

用途与实际影响

为什么需要它

有一批文件躺在目录里,不代表那一天所有记录都拿齐了。只按最近文件夹续跑,容易漏页、重复统计或误把残缺数据说成完整。

举个实际例子

几百页设备记录下载到一半断了。下次继续时,系统先核对已经完成的日期和页面是否仍属于同一次导出;对得上就从下一页接着来,对不上就停下说明冲突,不从头重下,也不把半成品冒充完整数据。

最后我会得到什么

已有完整历史与这次新增的原始记录都保留下来,能知道哪些日期和页面真的取齐。中断时从同一批的缺口继续;未完成当天由新记录补齐,不覆盖旧原件。

这项功能怎样使用

用途与实际影响

为什么需要它

有一批文件躺在目录里,不代表那一天所有记录都拿齐了。只按最近文件夹续跑,容易漏页、重复统计或误把残缺数据说成完整。

举个实际例子

几百页设备记录下载到一半断了。下次继续时,系统先核对已经完成的日期和页面是否仍属于同一次导出;对得上就从下一页接着来,对不上就停下说明冲突,不从头重下,也不把半成品冒充完整数据。

最后我会得到什么

已有完整历史与这次新增的原始记录都保留下来,能知道哪些日期和页面真的取齐。中断时从同一批的缺口继续;未完成当天由新记录补齐,不覆盖旧原件。

结果怎么看
可用于当前判断

日期、页面与原始文件都能一一对上时,才把这次导出记为完整;旧完整日期与新日期衔接。

需要复核

中途断开但已保存部分仍可核对时,保留它们并从同一批未完成处继续。

本轮不可用

文件、顺序或内容身份对不上时,在再访问设备账号前停下,不换目录凑成成功。

结果怎么看
可用于当前判断

日期、页面与原始文件都能一一对上时,才把这次导出记为完整;旧完整日期与新日期衔接。

需要复核

中途断开但已保存部分仍可核对时,保留它们并从同一批未完成处继续。

本轮不可用

文件、顺序或内容身份对不上时,在再访问设备账号前停下,不换目录凑成成功。

从哪里开始

有设备更新清单中断时,要求沿这同一批继续。

需要准备什么
  • 继续上次未完成设备更新的请求
  • 有多批时指出要继续哪一批
从开始到拿到结果
1系统核对并处理
先保存取回的原始页和运动附件,增量覆盖上次未完整的中国日起;已完整历史不反复下载。
2交付与接续
逐页核对后交回完整与缺失范围;中断继续同一清单,不另猜一个文件夹或吞掉旧原件。
从哪里开始

有设备更新清单中断时,要求沿这同一批继续。

需要准备什么
  • 继续上次未完成设备更新的请求
  • 有多批时指出要继续哪一批
从开始到拿到结果
1系统核对并处理
先保存取回的原始页和运动附件,增量覆盖上次未完整的中国日起;已完整历史不反复下载。
2交付与接续
逐页核对后交回完整与缺失范围;中断继续同一清单,不另猜一个文件夹或吞掉旧原件。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
10 月 11 日核对
全字段增量、扁平历史、gzip、分页闭环与精确续跑仍在源码;新增按“采集开始那天”定完整日期上界、只读列出可能不完整日期的命令、以及门牌路径下保持同一次采集。已有真实采集 13 份完成;本次只读清单的状态和日期,没有打开健康内容、没有联网、没有跑测试。9 月 14 日全套 140 项离线合成测试通过是当时的历史记录。
实际耗时样本(保留原日期,不是上限)
9 月 12 日首次全量 284 次请求、约 32 分钟;9 月 19 日周增量 73 次请求、约 17 分钟;9 月 26 日周增量 77 次请求、约 69 秒,当日补采 23 次请求、约 39 秒、传输约 0.1 MB(解压后约 4.5 MB)。之后没有重新测速。
关键规则与设计选择
1
空响应表示未观察到记录,不自动变成数值零。
2
每个原始页面先写文件,再更新 manifest(清单)checkpoint(续作检查点)。
3
完整页面可采用,额外或被篡改的 orphan(孤儿文件)会被拒绝。
4
失败只通过有界交接指向同一份续跑清单。
5
在线入口不接受临时字段子集或任意起始日期,离线查询才允许窄查。
6
“完整中国日”的上界按这次采集开始那天算:续跑拖过午夜,也不会把开始那天升级成完整日。
当前怎样实现
  • 字段 registry(登记清单)登记 39 类 API 类型;默认 Fitbit Air 采集从中选择 google-wearables 来源家族的 22 类兼容设备字段,用 9 个只读权限,另取 profile 以确定历史起点,有可用运动标识时保全 TCX。
  • 日常活动接口:steps、distance、active-minutes、active-zone-minutes、sedentary-period、total-calories;运动与体能接口:exercise、swim-lengths-data、vo2-max、daily-vo2-max、run-vo2-max。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
10 月 11 日核对
全字段增量、扁平历史、gzip、分页闭环与精确续跑仍在源码;新增按“采集开始那天”定完整日期上界、只读列出可能不完整日期的命令、以及门牌路径下保持同一次采集。已有真实采集 13 份完成;本次只读清单的状态和日期,没有打开健康内容、没有联网、没有跑测试。9 月 14 日全套 140 项离线合成测试通过是当时的历史记录。
实际耗时样本(保留原日期,不是上限)
9 月 12 日首次全量 284 次请求、约 32 分钟;9 月 19 日周增量 73 次请求、约 17 分钟;9 月 26 日周增量 77 次请求、约 69 秒,当日补采 23 次请求、约 39 秒、传输约 0.1 MB(解压后约 4.5 MB)。之后没有重新测速。
关键规则与设计选择
1
空响应表示未观察到记录,不自动变成数值零。
2
每个原始页面先写文件,再更新 manifest(清单)checkpoint(续作检查点)。
3
完整页面可采用,额外或被篡改的 orphan(孤儿文件)会被拒绝。
4
失败只通过有界交接指向同一份续跑清单。
5
在线入口不接受临时字段子集或任意起始日期,离线查询才允许窄查。
6
“完整中国日”的上界按这次采集开始那天算:续跑拖过午夜,也不会把开始那天升级成完整日。
当前怎样实现
  • 字段 registry(登记清单)登记 39 类 API 类型;默认 Fitbit Air 采集从中选择 google-wearables 来源家族的 22 类兼容设备字段,用 9 个只读权限,另取 profile 以确定历史起点,有可用运动标识时保全 TCX。
  • 日常活动接口:steps、distance、active-minutes、active-zone-minutes、sedentary-period、total-calories;运动与体能接口:exercise、swim-lengths-data、vo2-max、daily-vo2-max、run-vo2-max。

数字截至 2026 年 10 月 31 日

技术实现与依据(二)
  • 睡眠接口 sleep 映射为 sleep.session;心率接口包括 heart-rate、daily-resting-heart-rate、heart-rate-variability、daily-heart-rate-variability。
  • 其余默认接口为 oxygen-saturation、daily-oxygen-saturation、daily-respiratory-rate、respiratory-rate-sleep-summary、daily-sleep-temperature-derivations,对应血氧、呼吸与睡眠皮温变化。
  • 日期窗口连续且右开;每个原始页记录字段、操作、窗口、页码、翻页标记、字节数、条数与 SHA-256。
  • _atomic_write 先写同目录临时文件再原子替换。
  • 清单持续检查字段、元数据和 TCX 回执、分页链和历史起点;history.sources 用扁平日期分段引用已完成历史,当天新采集替换原未完整当天,防止重复计算。
  • google_health_history.py 只核验固定指针与必要清单元数据;完整日期上界取原始采集开始时间所在的中国日。新增 --audit-partial-days <清单>,离线列出可能不完整的日期:不联网、不改文件,也不自动补采,旧日期要不要补由我另定。
  • 运行清单、交接和回执的路径统一经“门牌”(登记过的目录联接)解析:门牌合法时保留同一次运行身份,不会因为解析出的真实路径不同而误选新目录;门牌异常仍停止。
  • 响应支持 gzip,解压后的原 JSON 字节继续原样保存并核验;连接复用和 gzip 都还在。离线简报合并有效历史,查询只读对应字段与日期。
技术实现与依据(二)
  • 睡眠接口 sleep 映射为 sleep.session;心率接口包括 heart-rate、daily-resting-heart-rate、heart-rate-variability、daily-heart-rate-variability。
  • 其余默认接口为 oxygen-saturation、daily-oxygen-saturation、daily-respiratory-rate、respiratory-rate-sleep-summary、daily-sleep-temperature-derivations,对应血氧、呼吸与睡眠皮温变化。
  • 日期窗口连续且右开;每个原始页记录字段、操作、窗口、页码、翻页标记、字节数、条数与 SHA-256。
  • _atomic_write 先写同目录临时文件再原子替换。
  • 清单持续检查字段、元数据和 TCX 回执、分页链和历史起点;history.sources 用扁平日期分段引用已完成历史,当天新采集替换原未完整当天,防止重复计算。
  • google_health_history.py 只核验固定指针与必要清单元数据;完整日期上界取原始采集开始时间所在的中国日。新增 --audit-partial-days <清单>,离线列出可能不完整的日期:不联网、不改文件,也不自动补采,旧日期要不要补由我另定。
  • 运行清单、交接和回执的路径统一经“门牌”(登记过的目录联接)解析:门牌合法时保留同一次运行身份,不会因为解析出的真实路径不同而误选新目录;门牌异常仍停止。
  • 响应支持 gzip,解压后的原 JSON 字节继续原样保存并核验;连接复用和 gzip 都还在。离线简报合并有效历史,查询只读对应字段与日期。
技术实现与依据(三)
1
首次闭合 profile 历史起点;后续由固定的最近采集指针核验上一完成采集,并从其尚未完整中国日起建立全字段增量计划。
2
逐字段、逐连续窗口请求新日期页面;已完成历史通过扁平分段引用,不重新联网读取。
  • 系统锁区分活进程与已退出进程;预算在换票和改清单前验证。
  • 失败交接是固定小文件,只带稳定错误和续跑清单路径,不含原始正文。
执行流程
技术实现与依据(三)
1
首次闭合 profile 历史起点;后续由固定的最近采集指针核验上一完成采集,并从其尚未完整中国日起建立全字段增量计划。
2
逐字段、逐连续窗口请求新日期页面;已完成历史通过扁平分段引用,不重新联网读取。
  • 系统锁区分活进程与已退出进程;预算在换票和改清单前验证。
  • 失败交接是固定小文件,只带稳定错误和续跑清单路径,不含原始正文。
执行流程
技术实现与依据(四)
3
普通响应或 gzip 解压后的原 JSON 按字节保存,再写页面回执;压缩损坏、不支持的编码或解压前后任一体积超限都会失败。
4
更新有界的续作检查点。
5
中断时写失败回执和续跑边界。
6
续跑前核对锁、计划、预算、哈希、孤儿文件和门牌路径。
7
全部字段与附件闭合后写 complete 与成功交接。
技术实现与依据(四)
3
普通响应或 gzip 解压后的原 JSON 按字节保存,再写页面回执;压缩损坏、不支持的编码或解压前后任一体积超限都会失败。
4
更新有界的续作检查点。
5
中断时写失败回执和续跑边界。
6
续跑前核对锁、计划、预算、哈希、孤儿文件和门牌路径。
7
全部字段与附件闭合后写 complete 与成功交接。
名词和入口
本模块用到的名词
名词意思
Raw evidence(原始证据)普通响应或gzip解压后的原JSON字节;保存前不重新序列化,压缩传输字节与保存JSON字节分别计数。原件先保全,解析结果不覆盖它。
Manifest(运行清单)一次运行唯一的计划、页面、资产、哈希、预算、状态和恢复身份。
Resume frontier(续跑边界)下一步允许继续的位置,由已完成页面和固定计划共同证明。
Orphan adoption(孤儿采用)中断后已经写入但还没进入 manifest(清单) 的连续页面,在哈希和位置完全匹配时被安全接纳。
专业定义

首次完整取得历史;以后只补上次未完整的中国日及之后全部字段。中断沿同一清单续跑,旧原件和完整历史保持不变,对不上就停止。

名词和入口
本模块用到的名词
名词意思
Raw evidence(原始证据)
意思:
普通响应或gzip解压后的原JSON字节;保存前不重新序列化,压缩传输字节与保存JSON字节分别计数。原件先保全,解析结果不覆盖它。
Manifest(运行清单)
意思:
一次运行唯一的计划、页面、资产、哈希、预算、状态和恢复身份。
Resume frontier(续跑边界)
意思:
下一步允许继续的位置,由已完成页面和固定计划共同证明。
Orphan adoption(孤儿采用)
意思:
中断后已经写入但还没进入 manifest(清单) 的连续页面,在哈希和位置完全匹配时被安全接纳。
专业定义

首次完整取得历史;以后只补上次未完整的中国日及之后全部字段。中断沿同一清单续跑,旧原件和完整历史保持不变,对不上就停止。

出问题时(一)
解决什么
解决半次导入被当完整数据、断线后全量重下、分页死循环、目录扫描误选运行、跨午夜续跑虚报完整日,以及原始字节被解析结果覆盖。
边界
  • 原始健康载荷只留在私有健康原件目录,不进入 Git 或网页;网页只写清单数量、状态和日期范围。
  • 页面数、字节数、记录数、请求数和用时均有边界。
  • 已完成历史不自动联网回查,因此不承诺主动发现提供方后来补写或修订到旧日期的记录;只读的“列出可能不完整日期”命令只报告,不补采。
  • google-wearables 只证明来自 Google/Fitbit 追踪设备家族,不逐条证明唯一设备型号,也不证明当前配对或在线。
  • connected GPS(手机协同定位)不是 Air 内置 GPS;运动 TCX 可随原件保全,但默认摘要不分析路线。
  • 通用登记表另有 18 类未纳入默认 Air 采集:心率区间时长与热量、楼层、海拔、活动消耗、活动等级、每日心率区间、血糖、体脂、核心体温、身高、体重、心电图、心律不齐通知、食物目录、食物单位目录、饮水日志、饮食日志。接口有定义不代表正在采集,也不代表设备本身一概不支持。
失败与恢复
  • 固定指针损坏、历史哈希不符、分段断裂或时钟回退: 返回 incremental_pointer_*、incremental_history_* 或 incremental_clock_rollback,保留旧原件并停止本次增量,不扫描另一份历史凑成功。
  • 重复翻页标记或分页链不连续: 在下一次请求前失败,保留原始页和终止回执。
出问题时(一)
解决什么
解决半次导入被当完整数据、断线后全量重下、分页死循环、目录扫描误选运行、跨午夜续跑虚报完整日,以及原始字节被解析结果覆盖。
边界
  • 原始健康载荷只留在私有健康原件目录,不进入 Git 或网页;网页只写清单数量、状态和日期范围。
  • 页面数、字节数、记录数、请求数和用时均有边界。
  • 已完成历史不自动联网回查,因此不承诺主动发现提供方后来补写或修订到旧日期的记录;只读的“列出可能不完整日期”命令只报告,不补采。
  • google-wearables 只证明来自 Google/Fitbit 追踪设备家族,不逐条证明唯一设备型号,也不证明当前配对或在线。
  • connected GPS(手机协同定位)不是 Air 内置 GPS;运动 TCX 可随原件保全,但默认摘要不分析路线。
  • 通用登记表另有 18 类未纳入默认 Air 采集:心率区间时长与热量、楼层、海拔、活动消耗、活动等级、每日心率区间、血糖、体脂、核心体温、身高、体重、心电图、心律不齐通知、食物目录、食物单位目录、饮水日志、饮食日志。接口有定义不代表正在采集,也不代表设备本身一概不支持。
失败与恢复
  • 固定指针损坏、历史哈希不符、分段断裂或时钟回退: 返回 incremental_pointer_*、incremental_history_* 或 incremental_clock_rollback,保留旧原件并停止本次增量,不扫描另一份历史凑成功。
  • 重复翻页标记或分页链不连续: 在下一次请求前失败,保留原始页和终止回执。
出问题时(二)
  • 请求数或临时票时间用完: 写有界失败回执与同一份续跑清单,不扩大预算或另建一次运行。
  • 原始文件哈希变化或额外孤儿文件超出续跑边界: 拒绝续跑,不换票。
  • 路径经门牌解析后不一致或门牌异常: 停止,不当成另一次运行。
  • 活进程仍持有运行锁: 拒绝并发写入;进程真实退出后才恢复。
出问题时(二)
  • 请求数或临时票时间用完: 写有界失败回执与同一份续跑清单,不扩大预算或另建一次运行。
  • 原始文件哈希变化或额外孤儿文件超出续跑边界: 拒绝续跑,不换票。
  • 路径经门牌解析后不一致或门牌异常: 停止,不当成另一次运行。
  • 活进程仍持有运行锁: 拒绝并发写入;进程真实退出后才恢复。
依据与来源(一)
真实入口
  • google_health_import.py 字段登记、gzip 传输、全字段增量、原始保全、清单、验证、查询与续跑
  • google_health_history.py 固定最近采集指针、扁平历史日期分段、完整日上界与“列出可能不完整日期”
  • tests/test_google_health_incremental.py 全字段增量、同清单续跑、gzip 和离线历史合成验证
  • tests/test_google_health_history.py 固定指针、历史分段、日期与完整性合成验证
  • tests/test_google_health_import.py import、分页、预算、锁、哈希、查询、交接与续跑回归(现有 64 个测试函数)
  • tests/test_folder_door_paths.py 门牌路径下保持同一次运行身份
  • AGENTS.md 按需与每周刷新共用、精确失败交接和不扫描目录的项目边界
  • 核实无屏健身手环及 Google Health 手机应用的产品关系;不证明个人当前设备在线
依据与来源(一)
真实入口
  • google_health_import.py 字段登记、gzip 传输、全字段增量、原始保全、清单、验证、查询与续跑
  • google_health_history.py 固定最近采集指针、扁平历史日期分段、完整日上界与“列出可能不完整日期”
  • tests/test_google_health_incremental.py 全字段增量、同清单续跑、gzip 和离线历史合成验证
  • tests/test_google_health_history.py 固定指针、历史分段、日期与完整性合成验证
  • tests/test_google_health_import.py import、分页、预算、锁、哈希、查询、交接与续跑回归(现有 64 个测试函数)
  • tests/test_folder_door_paths.py 门牌路径下保持同一次运行身份
  • AGENTS.md 按需与每周刷新共用、精确失败交接和不扫描目录的项目边界
  • 核实无屏健身手环及 Google Health 手机应用的产品关系;不证明个人当前设备在线

数字截至 2026 年 10 月 31 日

依据与来源(二)
  • 核实 API 数据类型与 google-wearables 来源家族;实际采集范围仍以本项目白名单为准
如何验证
  • import 测试覆盖 609 页样例的有界检查点与完整清单。
  • 中断、孤儿、篡改、重复翻页标记、请求预算和活锁都有失败即停的回归。
  • 全项目现有 209 个测试函数、参数展开 254 个用例(10 月 31 日静态计数,本次没有运行);9 月 14 日 140 项通过是历史记录。
  • 本次只读了采集清单的状态、起止日期和字段数,没有读取任何原始响应内容。
与其他模块的关系

它把一次网络采集变成可验证证据;离线简报只能消费这里的完成清单,按需和每周刷新也只接受这里的精确成功或失败交接。

依据与来源(二)
  • 核实 API 数据类型与 google-wearables 来源家族;实际采集范围仍以本项目白名单为准
如何验证
  • import 测试覆盖 609 页样例的有界检查点与完整清单。
  • 中断、孤儿、篡改、重复翻页标记、请求预算和活锁都有失败即停的回归。
  • 全项目现有 209 个测试函数、参数展开 254 个用例(10 月 31 日静态计数,本次没有运行);9 月 14 日 140 项通过是历史记录。
  • 本次只读了采集清单的状态、起止日期和字段数,没有读取任何原始响应内容。
与其他模块的关系

它把一次网络采集变成可验证证据;离线简报只能消费这里的完成清单,按需和每周刷新也只接受这里的精确成功或失败交接。

复制 AI 续作说明

项目:更新中断不丢数据,也不从头乱来;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。