GarminHealthLab

ericwyuan/GarminHealthLab

Fork 0

Commit Graph

Author	SHA1	Message	Date
ericwyuan	bb774c332b	[阶段5.2] 两步验证改到网页端完成，手机上即可绑定 Garmin 背景：命令行方案要求用户在电脑前开交互式终端，实际不可行。改为在网页里完成 MFA，手机也能操作。难点：garth 索取验证码走的是阻塞回调，0.4.46 没有 "发起登录 -> 返回句柄 -> 稍后续接" 的接口，登录必须一直挂着。而 gunicorn 跑多个 worker，验证码请求不一定落到挂着登录的那个 worker。方案：登录跑在后台线程里，停在 prompt_mfa 内轮询数据库；浏览器用另一个请求把验证码写进同一行。汇合点是数据库而非进程内存，所以哪个 worker 收到验证码都能送达。 - 新增 garmin_mfa_sessions 表（不存密码，密码只活在等待线程的内存里） - services/garmin_auth.py：start_login / submit_code / cancel 状态机 starting -> awaiting_code -> finishing -> done\|failed - 超时 5 分钟自动放弃，会话 1 小时后清理 - 会话按 user_id 校验，他人拿到 session id 也读不到、提交不了接口: - POST /api/garmin/login 发起登录，202 返回 session - GET /api/garmin/login-status 轮询状态 - POST /api/garmin/mfa 提交验证码 - DELETE /api/garmin/login 取消前端 DataSync 改为三步： - 未绑定 -> 输密码「绑定 Garmin 账号」 - 需要验证码 -> 弹出 6 位验证码输入框（inputMode=numeric、 autoComplete=one-time-code，手机可直接从短信自动填充） - 已绑定 -> 只剩「立即同步」，不再要密码 tests/test_garmin_mfa.py (20 通过): - stub 的 prompt_mfa 按 garth 的真实方式同步阻塞调用 - 关键用例：验证码直接写进数据库行也能被挂起的线程取到（模拟验证码落到另一个 worker） - 无 MFA 的账号不经验证码直接完成 - 验证码错误 / 密码错误 / 等待超时各自失败并给出原因 - 取消后挂起线程立即释放，不空转到超时 - 密码不出现在会话行里 - 跨用户读取和提交均被拒全量: 271 passed Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>	2026-08-23 20:11:45 +08:00
ericwyuan	af0604bce4	fix(garmin): 两步验证账号同步报 EOFError，改用令牌登录现象：网页触发同步报 "EOF when reading a line"。原因：garth 的默认 MFA 提示是 input()，向 stdin 索取验证码。 gunicorn worker 没有 stdin，于是抛出 EOFError——错误信息本身完全没提到 MFA，看不出该做什么。方案：把"输验证码"和"日常同步"拆开。 - 新增 garmin_tokens 表存 garth 令牌（Client.dumps/loads 序列化） - garmin_login.py：在终端里跑一次，可正常输入验证码，成功后令牌存库 - _connect() 优先加载令牌并 refresh_oauth2()，命中则完全跳过登录，既不需要密码也不需要验证码（令牌有效期约一年） - 无令牌且密码登录撞上 MFA 时，抛 MFARequired 并给出具体该执行哪条命令，而不是把 EOFError 原样抛给用户接口: - GET /api/garmin/auth-status 返回是否已有令牌 - /api/garmin/sync 在已有令牌时不再强制要求密码前端: - 有令牌时隐藏密码输入框，提示无需密码 - 同步返回 mfaRequired 时，展示需要在 NAS 上执行的具体命令 - 同步请求超时放宽到 180s（一周的天数 + 运动是多次上游调用） - 成功消息补上运动记录条数 tests (test_garmin_sync.py 新增 12 条，共 35): - 令牌存取、覆盖不累积、按用户隔离 - 有令牌时绝不调用 login() - MFA 的 EOFError 转成带操作指引的 MFARequired - 普通 401 不会被误标成 mfaRequired - 无令牌且无密码时给出明确拒绝 NAS 真机: 252 passed Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>	2026-08-23 19:57:40 +08:00

Author

SHA1

Message

Date

ericwyuan

bb774c332b

[阶段5.2] 两步验证改到网页端完成，手机上即可绑定 Garmin

背景：命令行方案要求用户在电脑前开交互式终端，实际不可行。
改为在网页里完成 MFA，手机也能操作。

难点：garth 索取验证码走的是 *阻塞回调*，0.4.46 没有
"发起登录 -> 返回句柄 -> 稍后续接" 的接口，登录必须一直挂着。
而 gunicorn 跑多个 worker，验证码请求不一定落到挂着登录的那个 worker。

方案：登录跑在后台线程里，停在 prompt_mfa 内轮询数据库；
浏览器用另一个请求把验证码写进同一行。**汇合点是数据库而非进程内存**，
所以哪个 worker 收到验证码都能送达。

- 新增 garmin_mfa_sessions 表（不存密码，密码只活在等待线程的内存里）
- services/garmin_auth.py：start_login / submit_code / cancel
  状态机 starting -> awaiting_code -> finishing -> done|failed
- 超时 5 分钟自动放弃，会话 1 小时后清理
- 会话按 user_id 校验，他人拿到 session id 也读不到、提交不了

接口:
- POST   /api/garmin/login        发起登录，202 返回 session
- GET    /api/garmin/login-status 轮询状态
- POST   /api/garmin/mfa          提交验证码
- DELETE /api/garmin/login        取消

前端 DataSync 改为三步：
- 未绑定 -> 输密码「绑定 Garmin 账号」
- 需要验证码 -> 弹出 6 位验证码输入框（inputMode=numeric、
  autoComplete=one-time-code，手机可直接从短信自动填充）
- 已绑定 -> 只剩「立即同步」，不再要密码

tests/test_garmin_mfa.py (20 通过):
- stub 的 prompt_mfa 按 garth 的真实方式同步阻塞调用
- 关键用例：验证码直接写进数据库行也能被挂起的线程取到
  （模拟验证码落到另一个 worker）
- 无 MFA 的账号不经验证码直接完成
- 验证码错误 / 密码错误 / 等待超时 各自失败并给出原因
- 取消后挂起线程立即释放，不空转到超时
- 密码不出现在会话行里
- 跨用户读取和提交均被拒

全量: 271 passed

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

2026-08-23 20:11:45 +08:00

ericwyuan

af0604bce4

fix(garmin): 两步验证账号同步报 EOFError，改用令牌登录

现象：网页触发同步报 "EOF when reading a line"。

原因：garth 的默认 MFA 提示是 input()，向 stdin 索取验证码。
gunicorn worker 没有 stdin，于是抛出 EOFError——错误信息本身
完全没提到 MFA，看不出该做什么。

方案：把"输验证码"和"日常同步"拆开。
- 新增 garmin_tokens 表存 garth 令牌（Client.dumps/loads 序列化）
- garmin_login.py：在终端里跑一次，可正常输入验证码，
  成功后令牌存库
- _connect() 优先加载令牌并 refresh_oauth2()，命中则完全跳过登录，
  既不需要密码也不需要验证码（令牌有效期约一年）
- 无令牌且密码登录撞上 MFA 时，抛 MFARequired 并给出具体该执行
  哪条命令，而不是把 EOFError 原样抛给用户

接口:
- GET /api/garmin/auth-status 返回是否已有令牌
- /api/garmin/sync 在已有令牌时不再强制要求密码

前端:
- 有令牌时隐藏密码输入框，提示无需密码
- 同步返回 mfaRequired 时，展示需要在 NAS 上执行的具体命令
- 同步请求超时放宽到 180s（一周的天数 + 运动是多次上游调用）
- 成功消息补上运动记录条数

tests (test_garmin_sync.py 新增 12 条，共 35):
- 令牌存取、覆盖不累积、按用户隔离
- 有令牌时绝不调用 login()
- MFA 的 EOFError 转成带操作指引的 MFARequired
- 普通 401 不会被误标成 mfaRequired
- 无令牌且无密码时给出明确拒绝

NAS 真机: 252 passed

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

2026-08-23 19:57:40 +08:00

2 Commits