核心功能
whoo-cli 是由第三方开发者 Luis Got 维护的 WHOOP API 命令行客户端，专为需要从 WHOOP 穿戴设备提取深度健康数据的用户设计。该工具通过 OAuth 2.0 与 WHOOP 官方开发者平台对接，支持获取恢复分数、心率变异性（HRV）、睡眠质量评分、训练负荷（Strain）、血氧饱和度（SpO2）及身体测量数据。
显著优点
- 官方 API 对接：基于 WHOOP 官方开发者 API，数据来源可靠，字段定义规范
- 安全认证设计：OAuth 流程采用本地回调（127.0.0.1:8123），凭证交互式输入（masked），Token 自动刷新并存储于系统配置目录
- 灵活输出格式：默认返回格式化文本，支持
--json输出结构化数据，便于脚本集成和二次分析 - 完善的错误处理：内置
score_state状态检查机制，区分 SCORED/PENDING_MANUAL/UNSCORABLE 三种数据状态，避免误读未就绪指标 - 无头环境支持：
--manual模式解决 SSH/远程服务器等无法本地浏览器回调的场景
潜在局限与风险
- 第三方非官方工具：由独立开发者维护，非 WHOOP 官方出品，更新频率和长期维护存在不确定性
- 依赖 Bun/Node 生态：需 Bun 1.3+ 或 npm 环境，对非 JavaScript 技术栈用户不够友好
- 手动开发者账户配置：用户需自行在 WHOOP 开发者平台创建应用并管理 client_id/client_secret，门槛较高
- 敏感数据处理责任：涉及 HRV、睡眠、血氧等高度个人健康信息，虽工具本身设计为本地处理，但用户需自行确保运行环境安全
- 速率限制与 API 稳定性：受 WHOOP API 配额限制，高频调用可能触发限流
适合人群
- 量化自我（Quantified Self）爱好者与生物黑客
- 需要批量导出 WHOOP 数据进行科研分析的研究人员
- 希望将 WHOOP 指标集成到个人健康仪表盘的开发者
- 运动表现分析师与职业/半职业运动员
常规风险提示
- 凭证安全：client_secret 应妥善保管，切勿提交至版本控制或共享环境
- 数据隐私：
--json输出包含敏感健康信息，传输或存储时需加密处理 - 健康决策边界：工具仅提供数据提取，不构成医疗建议，关键健康决策应咨询专业医师
- Token 生命周期：自动刷新机制依赖本地存储，系统重装或配置丢失需重新登录