核心用法
Garmin Tracker 是一个面向跑步及运动训练者的数据同步技能，专注于从 Garmin Connect 平台抓取用户活动历史与训练计划，并维护一份本地结构化的 garmin_tracking.json 文件。
主要功能
1. 数据同步：通过 Playwright 浏览器自动化，从 Garmin 活动列表与训练计划页面抓取数据
2. Schema 维护：强制固定数据结构，包含 history（历史活动）、upcoming（ upcoming训练）、summary（统计摘要）等核心字段
3. 验证与修复：内置 Python 调和脚本 reconcile_tracking.py，用于校验 JSON 合法性、重新计算统计数据
4. 灵活认证：优先复用浏览器会话，支持手动登录引导，必要时启用凭据模式（严格安全管控）
显著优点
- 结构化输出：强制标准化的活动数据格式（距离、时长、配速、心率、卡路里等），便于后续分析
- 增量更新：基于固定起始日期（2026-02-01）智能增量同步，避免全量重抓
- 安全设计：凭据模式遵循最小权限原则，禁止持久化存储敏感信息
- 错误恢复：内置浏览器操作失败时的恢复序列（tabs → focus → snapshot）
潜在局限
- 范围受限：明确排除 GPS 轨迹、分段数据、功率/踏频原始序列等深度遥测抓取
- 日期锁定：控制起始日期固定为 2026-02-01，不支持历史数据回溯调整
- 外部依赖：依赖
playwright-core与 Node.js/Python 运行时环境 - 单平台绑定：仅支持 Garmin Connect，无多平台适配能力
适合人群
- 使用 Garmin 设备的跑步/铁三/健身训练者
- 需要将训练数据结构化导出至本地 JSON 进行自定义分析的用户
- 遵循特定训练计划并希望追踪执行进度的运动员
常规风险
- 会话过期：Garmin 登录状态可能失效，需用户重新认证
- 反爬限制：频繁自动化访问可能触发平台风控
- 数据一致性：网络中断或页面结构变更可能导致抓取不完整
- 凭据泄露：若用户强制使用凭据模式，存在临时内存中敏感信息暴露风险（已通过"使用后立即丢弃"策略缓解）