
个人健康证据与安全决策 · 功能说明
设备数据有两条更新路:我当场说“更新一次”,或者每 7 天一次的定时任务。两条路走的是同一套采集和核对流程,跑完就停,不做持续同步;长期凭据不会散落在命令参数、日志或普通文件里,采集程序每次只拿到最长 1 小时有效的只读临时票。
当前情况:定时任务在用,最近一次 10 月 7 日跑完、正常退出,下一次排在 10 月 14 日,没有漏跑(10 月 11 日查看)。本次没有联网重刷,也不代表账号授权现在一定有效。采到的数据要经健康项目的 AI 审阅后才可能用进当前认知,定时脚本自己不改。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


个人健康证据与安全决策 · 功能说明
设备数据有两条更新路:我当场说“更新一次”,或者每 7 天一次的定时任务。两条路走的是同一套采集和核对流程,跑完就停,不做持续同步;长期凭据不会散落在命令参数、日志或普通文件里,采集程序每次只拿到最长 1 小时有效的只读临时票。
当前情况:定时任务在用,最近一次 10 月 7 日跑完、正常退出,下一次排在 10 月 14 日,没有漏跑(10 月 11 日查看)。本次没有联网重刷,也不代表账号授权现在一定有效。采到的数据要经健康项目的 AI 审阅后才可能用进当前认知,定时脚本自己不改。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


用途与实际影响
设备接口需要长期凭据。如果每次更新都重新授权、把令牌写进文件,或让脚本在后台无休止重试,既打扰人,也扩大凭据和误操作风险。可完全靠手动又容易忘,所以现在是“我随时可以要一次,平时每 7 天自动跑一次”,两条路都跑完即停。
我说“现在更新一次 Fitbit Air”。系统先把上次已经取回、还没整理的结果在本机整理完;确需联网时才由固定凭据入口发一张 1 小时只读临时票给采集程序。如果只是这一段的请求数或临时票时间用完、同一份清单确实有进展,就接着跑下一段;账号需要重新绑定、权限或验证失败、没有进展或超时,就停下来说明,不换账号、不转后台重试。我不开口时,每 7 天的定时任务做同样的事。
得到一次更新结果:取回了什么、哪些日期还缺、离线核对有没有通过。账号或权限出了问题就说明并停止。结果交给健康项目的 AI 审阅;它标着“需要审阅”只是固定规矩,不代表这份结果现在还没处理,也不会给我新增每周手工审阅的事。

用途与实际影响
设备接口需要长期凭据。如果每次更新都重新授权、把令牌写进文件,或让脚本在后台无休止重试,既打扰人,也扩大凭据和误操作风险。可完全靠手动又容易忘,所以现在是“我随时可以要一次,平时每 7 天自动跑一次”,两条路都跑完即停。
我说“现在更新一次 Fitbit Air”。系统先把上次已经取回、还没整理的结果在本机整理完;确需联网时才由固定凭据入口发一张 1 小时只读临时票给采集程序。如果只是这一段的请求数或临时票时间用完、同一份清单确实有进展,就接着跑下一段;账号需要重新绑定、权限或验证失败、没有进展或超时,就停下来说明,不换账号、不转后台重试。我不开口时,每 7 天的定时任务做同样的事。
得到一次更新结果:取回了什么、哪些日期还缺、离线核对有没有通过。账号或权限出了问题就说明并停止。结果交给健康项目的 AI 审阅;它标着“需要审阅”只是固定规矩,不代表这份结果现在还没处理,也不会给我新增每周手工审阅的事。

本次设备记录取回并核对完整后,再转入本机离线验真;一次请求返回不等于全部完成。
若上一批已经成功取回但尚未整理,先在本机完成它,不重复访问账号。
账号需重新绑定、回执异常或本次运行超时就停止,保留已有材料并说明接续条件。

本次设备记录取回并核对完整后,再转入本机离线验真;一次请求返回不等于全部完成。
若上一批已经成功取回但尚未整理,先在本机完成它,不重复访问账号。
账号需重新绑定、回执异常或本次运行超时就停止,保留已有材料并说明接续条件。

我想马上更新时直接说“更新这次 Fitbit Air 记录”;不说也会每 7 天自动跑一次。
- 想马上更新时,一句明确的更新请求(定时任务不需要我做什么)
- 想看的日期范围(如不同于默认)


我想马上更新时直接说“更新这次 Fitbit Air 记录”;不说也会每 7 天自动跑一次。
- 想马上更新时,一句明确的更新请求(定时任务不需要我做什么)
- 想看的日期范围(如不同于默认)



- google_health_enroll.py 验证桌面回环客户端、授权地址、回调和只读权限;授权用 state 与 S256 PKCE,回调只监听 127.0.0.1 随机端口。
- 首次登记的凭据只通过标准输入交给凭据中介,并要求事务、恢复副本和回读全部闭合才算存好。
- google_health_refresh.py 是按需和定时共用的入口;每次调用凭据中介,合并输出上限 64KiB,由项目自己的看门狗限时;超时或中断用 taskkill /T /F 终止整棵进程树。


- google_health_enroll.py 验证桌面回环客户端、授权地址、回调和只读权限;授权用 state 与 S256 PKCE,回调只监听 127.0.0.1 随机端口。
- 首次登记的凭据只通过标准输入交给凭据中介,并要求事务、恢复副本和回读全部闭合才算存好。
- google_health_refresh.py 是按需和定时共用的入口;每次调用凭据中介,合并输出上限 64KiB,由项目自己的看门狗限时;超时或中断用 taskkill /T /F 终止整棵进程树。
数字截至 2026 年 10 月 31 日

- 每 7 天的定时任务由 PCConfig 登记(不是采集程序自己建的),跑完写一份独立回执。


- 每 7 天的定时任务由 PCConfig 登记(不是采集程序自己建的),跑完写一份独立回执。



| 名词 | 意思 |
|---|---|
| OAuth(账号授权协议) | 我明确允许应用以只读权限访问设备数据的标准流程。 |
| PKCE(授权码防截获校验) | 用一次性校验值绑定授权码交换,降低授权码被截获后复用的风险。 |
| Secret Broker(本机受保护凭据中介) | 保管长期凭据的唯一入口;现在只给采集程序发 1 小时只读临时票,网页不读取任何明文。 |
| 刷新(按需/每周) | 我当场发起的一次,或 PCConfig 登记的每 7 天定时任务;两者调用同一程序、跑完即停。 |

更新可以由我当场发起,也可以由每 7 天的定时任务发起;每次都在一轮里跑完,长期凭据留在受保护位置,采集程序只拿短期只读票,不建立持续同步或后台监测。



更新可以由我当场发起,也可以由每 7 天的定时任务发起;每次都在一轮里跑完,长期凭据留在受保护位置,采集程序只拿短期只读票,不建立持续同步或后台监测。

- 网页不运行授权、凭据中介、采集程序或真实设备接口。
- 任何授权文件、令牌、客户端密钥或凭据引用结果都不公开。
- 定时任务成功只说明那一轮采集、核对和简报做完,不说明结果已被采用,也不说明账号授权会一直有效。
- 刷新失败不切换浏览器、账号、数据提供方或备用凭据路线。
- 授权权限不完整或刷新凭据有明确期限: 拒绝登记,不把短期访问冒充长期能力。
- 凭据中介要求重新绑定: 返回 runtime_rebind_required,本轮停止,不重试。
- 凭据中介拒绝: 只在标准错误输出里的合法拒绝回执保留它自己的无秘密错误码,但那不算成功;输出超限、格式不对、标准输出和错误输出混着来,都按失败处理,不进入离线核对。
- 看门狗超时或中断: 终止整棵进程树,关闭管道,不留后台子进程。

- 网页不运行授权、凭据中介、采集程序或真实设备接口。
- 任何授权文件、令牌、客户端密钥或凭据引用结果都不公开。
- 定时任务成功只说明那一轮采集、核对和简报做完,不说明结果已被采用,也不说明账号授权会一直有效。
- 刷新失败不切换浏览器、账号、数据提供方或备用凭据路线。
- 授权权限不完整或刷新凭据有明确期限: 拒绝登记,不把短期访问冒充长期能力。
- 凭据中介要求重新绑定: 返回 runtime_rebind_required,本轮停止,不重试。
- 凭据中介拒绝: 只在标准错误输出里的合法拒绝回执保留它自己的无秘密错误码,但那不算成功;输出超限、格式不对、标准输出和错误输出混着来,都按失败处理,不进入离线核对。
- 看门狗超时或中断: 终止整棵进程树,关闭管道,不留后台子进程。

- google_health_enroll.py 桌面授权、PKCE、标准输入传凭据、恢复副本和回读
- google_health_refresh.py 按需和每周共用入口、有进展的续跑、输出与超时边界
- tests/test_google_health_enroll.py 授权、只读权限、凭据传输和存储回归(现有 14 个测试函数)
- tests/test_google_health_refresh.py 入口、续跑例外、离线优先、重新绑定、输出、超时和进程树回归(现有 22 个测试函数)
- 全项目现有 209 个测试函数,参数展开后 254 个测试用例(10 月 31 日静态计数,本次没有运行)。
- 9 月 14 日全套 140 项通过,是当时的历史记录,不代表今天又跑过。
- 已有真实采集的记录:定时任务 10 月 7 日那一轮正常完成;本次没有授权、取票或联网采集,所以现在账号能否连通仍不知道。
它是唯一的凭据和联网入口;成功后把那份清单交给原始保全和离线核对模块,自己不解释健康。结果能不能用进当前认知,由健康项目审阅决定。

- google_health_enroll.py 桌面授权、PKCE、标准输入传凭据、恢复副本和回读
- google_health_refresh.py 按需和每周共用入口、有进展的续跑、输出与超时边界
- tests/test_google_health_enroll.py 授权、只读权限、凭据传输和存储回归(现有 14 个测试函数)
- tests/test_google_health_refresh.py 入口、续跑例外、离线优先、重新绑定、输出、超时和进程树回归(现有 22 个测试函数)
- 全项目现有 209 个测试函数,参数展开后 254 个测试用例(10 月 31 日静态计数,本次没有运行)。
- 9 月 14 日全套 140 项通过,是当时的历史记录,不代表今天又跑过。
- 已有真实采集的记录:定时任务 10 月 7 日那一轮正常完成;本次没有授权、取票或联网采集,所以现在账号能否连通仍不知道。
它是唯一的凭据和联网入口;成功后把那份清单交给原始保全和离线核对模块,自己不解释健康。结果能不能用进当前认知,由健康项目审阅决定。
数字截至 2026 年 10 月 31 日
复制 AI 续作说明
项目:我开口时更新一次,另外每 7 天自动更新一次设备数据;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。







