whoop-morning

💪 WHOOP每日健康晨间助手

基于 WHOOP API 的晨间健康检查工具,通过 OAuth2 安全获取睡眠、恢复与压力数据,生成个性化每日建议,助力优化训练与恢复安排。

收藏
2.2k
安装
599
版本
v0.1.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

whoop-morning 是一款专为 WHOOP 可穿戴设备用户设计的晨间健康数据检查工具。该技能通过标准的 OAuth2 认证流程连接 WHOOP API,每日自动获取用户的恢复指数(Recovery)、睡眠质量(Sleep)和循环压力(Cycle/Strain)等核心生理指标,并基于这些数据生成简洁的每日行动建议,帮助用户科学规划训练强度与休息安排。

核心用法上,用户需首先配置 WHOOP_CLIENT_ID 和 WHOOP_CLIENT_SECRET 环境变量,通过内置的 whoop-auth 脚本完成一次性授权获取 refresh token。随后,whoop-morning 脚本即可定期运行,自动刷新 token 并拉取最新健康数据。推荐通过 Gateway cron 设置每日早晨定时执行,实现自动化健康报告推送。

该技能的显著优点在于其出色的代码安全性与架构简洁性。代码仅依赖 Node.js 内置模块(fs, path),无任何外部 npm 依赖,极大降低了供应链攻击风险。Token 管理严格遵循 OAuth2 标准流程,敏感凭证仅存储在用户本地目录(~/.cache/whoop-morning/),无静默上传或远程收集行为。此外,功能描述透明清晰,安全相关行为均有明确告知。

然而,该技能也存在一定局限性。首先,来源为 GitHub 个人开发者(T3 级别),虽代码质量良好但非官方 WHOOP 或知名开源组织维护。其次,代码中 JSON.parse 缺乏前置输入验证,尽管有 try-catch 错误处理,仍存在潜在的解析异常风险。此外,技能完全依赖 WHOOP API 的稳定性,若 WHOOP 调整接口或认证策略,可能导致功能中断。用户还需注意 WHOOP 会轮换 refresh token,应避免多实例并行刷新导致认证失效。

适合使用该技能的目标群体包括:WHOOP 可穿戴设备活跃用户、量化自我(Quantified Self)爱好者、需要基于生理数据调整训练计划的健身人群,以及希望实现晨间健康数据自动化的效率工具用户。

使用风险方面,除前述的 API 依赖与 Token 轮换机制外,该技能主要执行本地文件操作,无系统破坏性风险。但用户需妥善保管 OAuth 凭证,避免 refresh token 泄露导致账号安全风险。建议在受信任的本地或私有环境中运行,定期检查 WHOOP API 的变更日志以确保兼容性。

安全解读

核心用法

whoop-morning 是一个个人健康数据自动化工具,每天早晨自动获取WHOOP穿戴设备的恢复指数、睡眠质量和日间压力数据,并生成简短的日常建议。用户需完成一次性OAuth2授权,配置WHOOP_CLIENT_IDWHOOP_CLIENT_SECRETWHOOP_REFRESH_TOKEN三个环境变量后,即可通过cron定时任务实现每日自动报告。

显著优点

  • 官方API直连:直接对接WHOOP官方OAuth2接口,数据传输采用TLS 1.2+加密
  • 最小权限设计:仅申请必要的只读权限(read:recovery, read:sleep, read:cycles, read:profile)
  • 本地令牌管理:访问令牌和刷新令牌存储在用户主目录本地缓存,符合安全最佳实践
  • 纯文档型工具:无可执行危险代码,静态结构清晰
  • 自动化友好:天然支持cron定时调度,输出格式适合消息推送

潜在缺点与局限性

  • 来源可信度待验证:维护组织clawdbot创建于2026年2月(约3个月历史),无公开仓库,未通过GitHub验证
  • 健康数据敏感性:涉及个人敏感健康信息(恢复、睡眠、压力),用户需自行管理数据隐私风险
  • API依赖风险:WHOOP API字段和认证流程可能变更,需关注官方更新
  • 令牌刷新限制:WHOOP会轮换刷新令牌,需避免并行刷新导致授权失效
  • 无撤销指引:文档缺少OAuth授权撤销操作说明

适合人群

  • WHOOP穿戴设备现有用户
  • 注重晨间恢复状态管理的健身爱好者
  • 需要自动化健康数据汇总的工作流用户
  • 能接受手动配置OAuth凭证的技术用户

常规风险

  • 来源风险:新组织维护,长期可持续性存疑
  • 隐私风险:健康数据本地存储,需确保~/.cache/whoop-morning/目录权限安全
  • 授权风险:若出现401/400错误需重新运行授权流程
  • 供应链风险:当前无可审计的公开源码,建议本地克隆审查后使用

whoop-morning 内容

lib文件夹
手动下载zip · 1.7 kB
tokens.jstext/javascript
请选择文件