whoop

WHOOP Tracker 是一款基于官方 API 的健身数据获取工具，旨在帮助用户安全、高效地同步和分析 WHOOP 可穿戴设备记录的生理指标。

核心用法方面，用户需先在 WHOOP 开发者平台注册应用获取 OAuth 凭证，完成授权流程后，即可通过命令行工具获取各类健身数据。该技能提供了四个主要脚本：get_recovery.py 用于获取恢复分数、HRV、静息心率等指标；get_sleep.py 可分析睡眠表现、各阶段时长及睡眠债；get_workouts.py 支持查询运动记录、心率区间和能量消耗；get_profile.py 则用于查看用户基本信息和身体测量数据。所有脚本均支持日期范围筛选和原始 JSON 输出，便于与其他分析工具集成。

显著优点体现在多个维度。首先，它直接对接 WHOOP 官方 REST API，数据来源权威可靠，涵盖恢复、睡眠、运动等 20 余项生理指标。其次，安全设计完善，OAuth Token 和凭证文件均存储在用户主目录且设置 600 权限，避免未授权访问。代码层面无任何危险函数，采用标准 requests 库进行 HTTP 通信，并实现了自动 Token 刷新、速率限制重试和分页迭代器，大幅提升开发体验。此外，详尽的文档和完善的错误处理机制降低了使用门槛。

然而，该技能也存在一定局限性。作为 T3 来源（个人开发者维护），缺乏企业级背书和长期维护保障。配置过程相对复杂，需要用户自行注册开发者账号并处理 OAuth 授权流程。功能上仅支持数据读取，无法写入或修改记录。此外，Token 存储在用户本地目录，不适合多用户共享环境，且 Refresh Token 过期后需重新授权。

适合的目标群体包括：WHOOP 可穿戴设备用户、健身数据分析师、运动科学研究者，以及热衷于"量化自我"的健康管理爱好者。对于需要将 WHOOP 数据导入个人健康数据库或进行深度统计分析的用户尤为适用。

使用风险主要包括：需妥善保管本地凭证文件，避免提交到版本控制；API 存在速率限制，频繁调用可能触发 429 错误；非官方维护意味着 API 变更时可能存在适配延迟；OAuth Token 有有效期限制，需定期重新授权。