Whoop 健康数据可视化 Skill 综合评估
核心用法
Whoop Skill 允许用户通过官方开发者 API 授权访问其 Whoop 智能手环的健康数据，涵盖睡眠、恢复评分、训练负荷（Strain）、心率变异性（HRV）、静息心率（RHR）及运动记录等核心指标。用户需先在 Whoop 开发者平台创建应用获取 Client ID 和 Client Secret，完成 OAuth 2.0 授权后，即可通过命令行工具查询数据或生成基于 Chart.js 的交互式 HTML 图表。
数据获取支持灵活的时间范围（默认 7-30 天，可自定义日期），输出标准 JSON 格式便于解析。图表功能提供睡眠分析、恢复评分柱状图（绿黄红三色编码）、HRV 与静息心率趋势、训练负荷与卡路里等多维度可视化，还支持一键生成综合仪表盘。
显著优点
1. 官方 API 授权：基于 Whoop 官方开发者平台，OAuth 2.0 标准认证流程，非破解或逆向工程方案
2. 数据全面性：覆盖睡眠分期、恢复评分、HRV、RHR、SpO2、训练负荷等专业运动员级指标
3. 交互式可视化：Chart.js 驱动的浏览器端图表，支持悬停提示、统计卡片、暗色主题
4. 科学分析框架：内置 health_analysis.md 参考指南，提供循证医学解释、正常值范围、过训练信号识别
5. 隐私本地化：令牌存储于本地 ~/.clawdbot/whoop-tokens.json，数据查询本地执行，不经过第三方服务器
潜在局限
- 门槛较高：需用户主动注册开发者账户、创建应用、管理 OAuth 凭证，对非技术用户不够友好
- 令牌管理：虽支持自动刷新，但本地令牌文件若被窃取存在授权滥用风险
- 仅限个人数据：无法访问其他用户数据，社交对比功能缺失
- 离线依赖：需联网获取 Whoop 云端数据，无法处理设备离线场景
- 平台绑定：深度依赖 Whoop 硬件生态，不支持其他品牌可穿戴设备
适合人群
- 已拥有 Whoop 4.0 或 Whoop 5.0 手环的健身爱好者、耐力运动员、CrossFit 训练者
- 需要量化恢复状态以优化训练周期的严肃跑者、铁三选手
- 对睡眠质量和 HRV 长期趋势有追踪需求的生物黑客、健康优化人群
- 具备基础命令行操作能力，愿意完成开发者注册流程的技术型用户
常规风险
- 授权范围较宽：默认请求全部 read 权限，包括个人资料和身体测量数据，用户应确认授权页面权限列表
- 本地文件安全：
~/.clawdbot/whoop-tokens.json包含刷新令牌，建议设置文件权限 600 并避免同步至云端 - 数据解读风险：虽提供分析框架，但 HRV、恢复评分等指标的个体差异大，过度依赖算法建议可能忽视主观感受
- 服务连续性：依赖 Whoop API 稳定性，官方可能调整开发者政策或速率限制
- 医疗免责声明明确：Skill 文档强调非医疗建议，出现红旗指标时需咨询专业医师