Whoop

核心功能

Whoop技能提供WHOOP智能手环的深度数据访问能力，涵盖睡眠分析、恢复评分、训练负荷（Strain）、心率变异性（HRV）等关键健康指标。通过官方开发者API获取数据，并生成基于Chart.js的交互式可视化图表，包含深色主题、统计卡片和悬停提示。

显著优点

1. 数据完整性：支持睡眠阶段、恢复评分、训练记录、生理参数等全维度数据
2. 可视化专业：自动生成dashboard级图表，含颜色编码（绿/黄/红）的恢复状态指示
3. 分析框架：内置health_analysis.md参考指南，提供科学背书的指标解读、趋势分析和可操作建议
4. 认证安全：采用OAuth 2.0标准流程，token自动刷新并本地加密存储

潜在局限

• 依赖第三方硬件（WHOOP手环），无设备则无法使用
• API速率限制可能影响大规模历史数据拉取
• 健康分析虽基于科学文献，但仍属消费级建议，非医疗诊断
• 需用户自行完成开发者账户注册和权限配置，上手门槛较高

适合人群

• 耐力运动员、CrossFit训练者、职业运动表现追求者的量化自我分析
• 睡眠障碍关注者、高压职场人士的健康监测
• 数据驱动的健身爱好者，需要趋势追踪而非单次测量

风险提醒

所有健康洞察需明确标注"非医疗建议"，HRV异常、持续低恢复评分等红旗指标应建议专业医疗咨询。

核心用法

Whoop技能通过官方API获取用户可穿戴设备数据，支持睡眠、恢复、心率变异性(HRV)、训练负荷(Strain)及运动记录的多维度分析。

数据获取：使用whoop_data.py脚本查询各类健康指标，支持自定义时间范围（默认7-30天），输出结构化JSON数据。涵盖睡眠阶段、恢复评分、日度负荷、运动详情及用户档案。

可视化生成：whoop_chart.py可生成基于Chart.js的交互式HTML图表，包含睡眠分析、恢复评分彩色条形图、负荷趋势、HRV与静息心率曲线，以及综合仪表盘。图表采用深色主题，支持悬停提示与统计卡片。

健康洞察：结合health_analysis.md参考文档，提供科学背书的数据解读框架——包括年龄适配的正常范围、过训练信号识别、睡眠负债分析及行动建议。

显著优点

• 零第三方依赖：纯Python标准库实现，杜绝供应链攻击面
• 官方API直连：仅连接Whoop官方服务端点，数据来源可信
• OAuth 2.0规范：标准授权流程，Token本地安全存储（权限600）
• 端到端隐私：敏感健康数据不落第三方，仅在用户本地处理
• 自动化Token刷新：过期前5分钟自动续期，体验无缝

潜在局限

• Token明文存储：OAuth凭证以JSON格式存于~/.clawdbot/whoop-tokens.json，虽设文件权限600，但未使用系统密钥管理服务
• CDN依赖：图表渲染依赖jsDelivr CDN加载ApexCharts，存在单点故障与潜在供应链风险
• 无离线模式：需网络连接获取数据，不支持纯离线历史查看
• 设备绑定：仅支持Whoop生态，无法整合Apple Watch、Garmin等其他穿戴数据

适合人群

• Whoop 3.0/4.0/5.0设备用户
• 运动员及健身爱好者追踪训练负荷与恢复平衡
• 生物黑客与量化自我实践者分析长期健康趋势
• 需可视化健康报告的个人用户

常规风险

• 医疗免责声明：所有分析仅为健身参考，非医疗诊断，异常指标需咨询专业医师
• 数据完整性：API偶有延迟或缺失，历史数据补录可能不完整
• 授权撤销：用户可随时在Whoop开发者后台撤销应用授权
• 本地文件安全：多用户系统需注意~/.clawdbot目录的访问权限隔离