Whoop 健康数据查询与可视化工具
核心用法
该技能通过 OAuth 2.0 连接 Whoop 官方开发者 API，支持查询睡眠、恢复评分、训练负荷（Strain）、HRV、静息心率、运动记录等多维度健康数据，并可将数据渲染为基于 Chart.js 的交互式 HTML 图表。
使用流程分为三步：首次配置需在 Whoop 开发者后台创建应用并获取 Client ID/Secret；通过 whoop_auth.py 完成授权登录；后续使用 whoop_data.py 拉取原始 JSON 数据，或用 whoop_chart.py 生成可视化报告（包括睡眠分析、恢复趋势、HRV 追踪、综合仪表盘等）。
显著优点
1. 数据维度全面：涵盖恢复评分（0-100%）、训练负荷（0-21）、睡眠效率、HRV、SpO2 等运动员级指标，优于普通消费级穿戴设备
2. 可视化专业：自动生成配色科学的交互式图表，支持趋势对比、数据钻取和本地保存
3. 分析框架科学：内置 health_analysis.md 参考指南，提供基于循证医学的数据解读、正常范围对照、过度训练预警等
4. 自动化程度高：Token 自动刷新，支持自定义日期范围和批量数据导出
潜在局限
- 硬件依赖：必须拥有 Whoop 4.0 或 Whoop 5.0 设备才能产生数据源
- 订阅成本：Whoop 本身为订阅制服务（月费/年费），该技能无法绕过
- 地域限制：Whoop 官方服务在某些地区（如中国大陆）可用性受限
- 医学边界：明确标注非医疗建议，不能替代专业诊断
适合人群
- 严肃训练的耐力运动员（铁三、马拉松、CrossFit）
- 关注恢复管理的健身爱好者
- 需要量化身体状态的团队运动选手
- 睡眠质量追踪与优化需求者
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据隐私 | 健康数据本地存储于 `~/.clawdbot/whoop-tokens.json` | 确保设备文件权限安全，勿共享 token 文件 |
| OAuth 凭证泄露 | Client Secret 明文出现在命令行历史 | 使用环境变量或配置文件注入 |
| 过度解读 | 单日数据波动引发焦虑 | 强调趋势分析，参考 `health_analysis.md` 的统计学视角 |
| 医学误判 | 将低恢复评分误认为疾病信号 | 始终附加「非医疗建议」免责声明 |
技术栈：Python 3、Whoop REST API v1、Chart.js、本地 HTML 渲染