
个人健康证据与安全决策 · 功能说明
日常更新不用反复下载多年的完整记录:首次建立历史,此后仍覆盖全部 22 类字段,只补上次未完整的中国日及之后。中途失败沿同一清单继续,原件可回读,不误选另一批文件。
当前情况:真实采集已经在跑:已保存 16 份采集清单,其中 13 份完成,分布在 6 个更新日,最近一次 10 月 7 日;完整日期范围 8 月 5 日—10 月 6 日,共 63 天(范围长度不代表每天都有记录)。另外 3 份停在“进行中”的是留存的旧状态,不代表还有 3 个进程在跑。以上是 10 月 11 日只读清点的数,本次没有联网导入。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


个人健康证据与安全决策 · 功能说明
日常更新不用反复下载多年的完整记录:首次建立历史,此后仍覆盖全部 22 类字段,只补上次未完整的中国日及之后。中途失败沿同一清单继续,原件可回读,不误选另一批文件。
当前情况:真实采集已经在跑:已保存 16 份采集清单,其中 13 份完成,分布在 6 个更新日,最近一次 10 月 7 日;完整日期范围 8 月 5 日—10 月 6 日,共 63 天(范围长度不代表每天都有记录)。另外 3 份停在“进行中”的是留存的旧状态,不代表还有 3 个进程在跑。以上是 10 月 11 日只读清点的数,本次没有联网导入。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

数字截至 2026 年 10 月 31 日

用途与实际影响
有一批文件躺在目录里,不代表那一天所有记录都拿齐了。只按最近文件夹续跑,容易漏页、重复统计或误把残缺数据说成完整。
几百页设备记录下载到一半断了。下次继续时,系统先核对已经完成的日期和页面是否仍属于同一次导出;对得上就从下一页接着来,对不上就停下说明冲突,不从头重下,也不把半成品冒充完整数据。
已有完整历史与这次新增的原始记录都保留下来,能知道哪些日期和页面真的取齐。中断时从同一批的缺口继续;未完成当天由新记录补齐,不覆盖旧原件。

用途与实际影响
有一批文件躺在目录里,不代表那一天所有记录都拿齐了。只按最近文件夹续跑,容易漏页、重复统计或误把残缺数据说成完整。
几百页设备记录下载到一半断了。下次继续时,系统先核对已经完成的日期和页面是否仍属于同一次导出;对得上就从下一页接着来,对不上就停下说明冲突,不从头重下,也不把半成品冒充完整数据。
已有完整历史与这次新增的原始记录都保留下来,能知道哪些日期和页面真的取齐。中断时从同一批的缺口继续;未完成当天由新记录补齐,不覆盖旧原件。

日期、页面与原始文件都能一一对上时,才把这次导出记为完整;旧完整日期与新日期衔接。
中途断开但已保存部分仍可核对时,保留它们并从同一批未完成处继续。
文件、顺序或内容身份对不上时,在再访问设备账号前停下,不换目录凑成成功。

日期、页面与原始文件都能一一对上时,才把这次导出记为完整;旧完整日期与新日期衔接。
中途断开但已保存部分仍可核对时,保留它们并从同一批未完成处继续。
文件、顺序或内容身份对不上时,在再访问设备账号前停下,不换目录凑成成功。

有设备更新清单中断时,要求沿这同一批继续。
- 继续上次未完成设备更新的请求
- 有多批时指出要继续哪一批


有设备更新清单中断时,要求沿这同一批继续。
- 继续上次未完成设备更新的请求
- 有多批时指出要继续哪一批



- 字段 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。


- 字段 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 都还在。离线简报合并有效历史,查询只读对应字段与日期。

- 系统锁区分活进程与已退出进程;预算在换票和改清单前验证。
- 失败交接是固定小文件,只带稳定错误和续跑清单路径,不含原始正文。


- 系统锁区分活进程与已退出进程;预算在换票和改清单前验证。
- 失败交接是固定小文件,只带稳定错误和续跑清单路径,不含原始正文。





| 名词 | 意思 |
|---|---|
| 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。







