我开口时更新一次,另外每 7 天自动更新一次设备数据
现在
在用
截至 10 月 11 日

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

设备数据有两条更新路:我当场说“更新一次”,或者每 7 天一次的定时任务。两条路走的是同一套采集和核对流程,跑完就停,不做持续同步;长期凭据不会散落在命令参数、日志或普通文件里,采集程序每次只拿到最长 1 小时有效的只读临时票。

当前情况:定时任务在用,最近一次 10 月 7 日跑完、正常退出,下一次排在 10 月 14 日,没有漏跑(10 月 11 日查看)。本次没有联网重刷,也不代表账号授权现在一定有效。采到的数据要经健康项目的 AI 审阅后才可能用进当前认知,定时脚本自己不改。

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

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

我开口时更新一次,另外每 7 天自动更新一次设备数据
现在
在用
截至 10 月 11 日

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

设备数据有两条更新路:我当场说“更新一次”,或者每 7 天一次的定时任务。两条路走的是同一套采集和核对流程,跑完就停,不做持续同步;长期凭据不会散落在命令参数、日志或普通文件里,采集程序每次只拿到最长 1 小时有效的只读临时票。

当前情况:定时任务在用,最近一次 10 月 7 日跑完、正常退出,下一次排在 10 月 14 日,没有漏跑(10 月 11 日查看)。本次没有联网重刷,也不代表账号授权现在一定有效。采到的数据要经健康项目的 AI 审阅后才可能用进当前认知,定时脚本自己不改。

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

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

这项功能怎样使用

用途与实际影响

为什么需要它

设备接口需要长期凭据。如果每次更新都重新授权、把令牌写进文件,或让脚本在后台无休止重试,既打扰人,也扩大凭据和误操作风险。可完全靠手动又容易忘,所以现在是“我随时可以要一次,平时每 7 天自动跑一次”,两条路都跑完即停。

举个实际例子

我说“现在更新一次 Fitbit Air”。系统先把上次已经取回、还没整理的结果在本机整理完;确需联网时才由固定凭据入口发一张 1 小时只读临时票给采集程序。如果只是这一段的请求数或临时票时间用完、同一份清单确实有进展,就接着跑下一段;账号需要重新绑定、权限或验证失败、没有进展或超时,就停下来说明,不换账号、不转后台重试。我不开口时,每 7 天的定时任务做同样的事。

最后我会得到什么

得到一次更新结果:取回了什么、哪些日期还缺、离线核对有没有通过。账号或权限出了问题就说明并停止。结果交给健康项目的 AI 审阅;它标着“需要审阅”只是固定规矩,不代表这份结果现在还没处理,也不会给我新增每周手工审阅的事。

这项功能怎样使用

用途与实际影响

为什么需要它

设备接口需要长期凭据。如果每次更新都重新授权、把令牌写进文件,或让脚本在后台无休止重试,既打扰人,也扩大凭据和误操作风险。可完全靠手动又容易忘,所以现在是“我随时可以要一次,平时每 7 天自动跑一次”,两条路都跑完即停。

举个实际例子

我说“现在更新一次 Fitbit Air”。系统先把上次已经取回、还没整理的结果在本机整理完;确需联网时才由固定凭据入口发一张 1 小时只读临时票给采集程序。如果只是这一段的请求数或临时票时间用完、同一份清单确实有进展,就接着跑下一段;账号需要重新绑定、权限或验证失败、没有进展或超时,就停下来说明,不换账号、不转后台重试。我不开口时,每 7 天的定时任务做同样的事。

最后我会得到什么

得到一次更新结果:取回了什么、哪些日期还缺、离线核对有没有通过。账号或权限出了问题就说明并停止。结果交给健康项目的 AI 审阅;它标着“需要审阅”只是固定规矩,不代表这份结果现在还没处理,也不会给我新增每周手工审阅的事。

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

本次设备记录取回并核对完整后,再转入本机离线验真;一次请求返回不等于全部完成。

需要复核

若上一批已经成功取回但尚未整理,先在本机完成它,不重复访问账号。

本轮不可用

账号需重新绑定、回执异常或本次运行超时就停止,保留已有材料并说明接续条件。

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

本次设备记录取回并核对完整后,再转入本机离线验真;一次请求返回不等于全部完成。

需要复核

若上一批已经成功取回但尚未整理,先在本机完成它,不重复访问账号。

本轮不可用

账号需重新绑定、回执异常或本次运行超时就停止,保留已有材料并说明接续条件。

从哪里开始

我想马上更新时直接说“更新这次 Fitbit Air 记录”;不说也会每 7 天自动跑一次。

需要准备什么
  • 想马上更新时,一句明确的更新请求(定时任务不需要我做什么)
  • 想看的日期范围(如不同于默认)
从开始到拿到结果
1系统核对并处理
按需入口和每 7 天的定时任务调用同一个刷新程序:先收尾已取回的结果,确需联网才由受保护凭据入口发 1 小时只读临时票,凭据不落在普通文件或命令行。
2交付与接续
交回本次取回、缺页和离线核对状态;连接或授权失败就停。定时任务跑完即停,最长 5 小时,不做持续同步,也不自己改当前健康认知。
从哪里开始

我想马上更新时直接说“更新这次 Fitbit Air 记录”;不说也会每 7 天自动跑一次。

需要准备什么
  • 想马上更新时,一句明确的更新请求(定时任务不需要我做什么)
  • 想看的日期范围(如不同于默认)
从开始到拿到结果
1系统核对并处理
按需入口和每 7 天的定时任务调用同一个刷新程序:先收尾已取回的结果,确需联网才由受保护凭据入口发 1 小时只读临时票,凭据不落在普通文件或命令行。
2交付与接续
交回本次取回、缺页和离线核对状态;连接或授权失败就停。定时任务跑完即停,最长 5 小时,不做持续同步,也不自己改当前健康认知。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
10 月 11 日查看
定时任务 PersonalHealth Weekly Refresh:已启用、就绪,每 7 天一次,需登录状态下运行,整任务上限 5 小时;最近一次 10 月 7 日 18:23 开始、约 1 分钟跑完、退出码 0,下一次 10 月 14 日,漏跑 0。凭据入口现装模式是“发 1 小时只读访问票”,现装中介脚本和源码逐字节一致。本次没有调用凭据中介、没有授权、没有联网采集,也没有跑测试。
关键规则与设计选择
1
首次桌面授权(OAuth)用本机回环回调和 PKCE,长期刷新凭据存进密码中心并回读确认;网页不办理授权。
2
采集程序拿不到长期凭据,只拿最长 1 小时的只读访问票,共 9 个只读权限;把整包凭据交给进程的旧方式代码仍兼容,但不是当前在用方式。
3
三种时间限制分开:每张票 1 小时,凭据入口单次 4 小时,项目自己的看门狗 5 小时。
4
按需和每 7 天两条路共用同一个刷新程序,跑完即停,不建立持续同步或后台监视。
5
只有“请求数用完”或“临时票时间用完”、同一份清单、累计请求数确实增加三者同时成立才自动续跑;重新绑定、权限、验证失败、没有进展都停止,不换路。
当前怎样实现
  • google_health_enroll.py 验证桌面回环客户端、授权地址、回调和只读权限;授权用 state 与 S256 PKCE,回调只监听 127.0.0.1 随机端口。
  • 首次登记的凭据只通过标准输入交给凭据中介,并要求事务、恢复副本和回读全部闭合才算存好。
  • google_health_refresh.py 是按需和定时共用的入口;每次调用凭据中介,合并输出上限 64KiB,由项目自己的看门狗限时;超时或中断用 taskkill /T /F 终止整棵进程树。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
10 月 11 日查看
定时任务 PersonalHealth Weekly Refresh:已启用、就绪,每 7 天一次,需登录状态下运行,整任务上限 5 小时;最近一次 10 月 7 日 18:23 开始、约 1 分钟跑完、退出码 0,下一次 10 月 14 日,漏跑 0。凭据入口现装模式是“发 1 小时只读访问票”,现装中介脚本和源码逐字节一致。本次没有调用凭据中介、没有授权、没有联网采集,也没有跑测试。
关键规则与设计选择
1
首次桌面授权(OAuth)用本机回环回调和 PKCE,长期刷新凭据存进密码中心并回读确认;网页不办理授权。
2
采集程序拿不到长期凭据,只拿最长 1 小时的只读访问票,共 9 个只读权限;把整包凭据交给进程的旧方式代码仍兼容,但不是当前在用方式。
3
三种时间限制分开:每张票 1 小时,凭据入口单次 4 小时,项目自己的看门狗 5 小时。
4
按需和每 7 天两条路共用同一个刷新程序,跑完即停,不建立持续同步或后台监视。
5
只有“请求数用完”或“临时票时间用完”、同一份清单、累计请求数确实增加三者同时成立才自动续跑;重新绑定、权限、验证失败、没有进展都停止,不换路。
当前怎样实现
  • google_health_enroll.py 验证桌面回环客户端、授权地址、回调和只读权限;授权用 state 与 S256 PKCE,回调只监听 127.0.0.1 随机端口。
  • 首次登记的凭据只通过标准输入交给凭据中介,并要求事务、恢复副本和回读全部闭合才算存好。
  • google_health_refresh.py 是按需和定时共用的入口;每次调用凭据中介,合并输出上限 64KiB,由项目自己的看门狗限时;超时或中断用 taskkill /T /F 终止整棵进程树。

数字截至 2026 年 10 月 31 日

技术实现与依据(二)
1
首次明确授权时读取桌面客户端配置,在本机回环完成授权并存入凭据中心、回读确认。
2
之后由我当场或每 7 天的定时任务运行刷新。
3
有上次已取回、未整理的结果就先在本机收尾;没有才向凭据中介要一张 1 小时只读临时票。
4
同一清单因请求数或票时间用完而停、且累计请求数增加时,接着跑下一段。
5
拿到合法的成功回执后进入离线核对;其他结果按具体错误停止。
  • 每 7 天的定时任务由 PCConfig 登记(不是采集程序自己建的),跑完写一份独立回执。
执行流程
技术实现与依据(二)
1
首次明确授权时读取桌面客户端配置,在本机回环完成授权并存入凭据中心、回读确认。
2
之后由我当场或每 7 天的定时任务运行刷新。
3
有上次已取回、未整理的结果就先在本机收尾;没有才向凭据中介要一张 1 小时只读临时票。
4
同一清单因请求数或票时间用完而停、且累计请求数增加时,接着跑下一段。
5
拿到合法的成功回执后进入离线核对;其他结果按具体错误停止。
  • 每 7 天的定时任务由 PCConfig 登记(不是采集程序自己建的),跑完写一份独立回执。
执行流程
名词和入口
本模块用到的名词
名词意思
OAuth(账号授权协议)我明确允许应用以只读权限访问设备数据的标准流程。
PKCE(授权码防截获校验)用一次性校验值绑定授权码交换,降低授权码被截获后复用的风险。
Secret Broker(本机受保护凭据中介)保管长期凭据的唯一入口;现在只给采集程序发 1 小时只读临时票,网页不读取任何明文。
刷新(按需/每周)我当场发起的一次,或 PCConfig 登记的每 7 天定时任务;两者调用同一程序、跑完即停。
专业定义

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

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