名称： whoopskill
描述： WHOOP 命令行工具，提供健康洞察、趋势分析和数据获取（睡眠、恢复、HRV、运动负荷）。
主页： https://github.com/koala73/whoopskill
元数据： {"clawdis":{"emoji":"💪","requires":{"bins":["node"],"env":["WHOOP_CLIENT_ID","WHOOP_CLIENT_SECRET","WHOOP_REDIRECT_URI"]},"install":[{"id":"npm","kind":"npm","package":"whoopskill","bins":["whoopskill"],"label":"安装 whoopskill (npm)"}]}}

whoopskill

使用 whoopskill 获取 WHOOP 健康指标（睡眠、恢复、HRV、运动负荷、锻炼）。

安装：npm install -g whoopskill | GitHub

快速开始

• whoopskill summary — 单行摘要：恢复: 52% | HRV: 39ms | 睡眠: 40% | 负荷: 6.7
• whoopskill summary --color — 带颜色编码的摘要，包含 🟢🟡🔴 状态指示器
• whoopskill trends — 7 天趋势，包含平均值和方向箭头
• whoopskill trends --days 30 --pretty — 30 天趋势分析
• whoopskill insights --pretty — AI 风格的健康建议
• whoopskill --pretty — 人类可读的输出，带表情符号
• whoopskill recovery — 恢复分数、HRV、静息心率
• whoopskill sleep — 睡眠表现、阶段
• whoopskill workout — 锻炼记录及负荷
• whoopskill --date 2025-01-03 — 查询特定日期

分析命令

• summary — 快速健康概览（添加 --color 获取状态指示器）
• trends — 多日平均值及趋势箭头（↑↓→）
• insights — 基于个人数据的个性化建议

数据类型

• profile — 用户信息（姓名、邮箱）
• body — 身高、体重、最大心率
• sleep — 睡眠阶段、效率、呼吸频率
• recovery — 恢复百分比、HRV、静息心率、血氧、皮肤温度
• workout — 负荷、心率区间、卡路里
• cycle — 每日负荷、卡路里

组合查询

• whoopskill --sleep --recovery --body

认证

• whoopskill auth login — OAuth 流程（打开浏览器）
• whoopskill auth status — 检查令牌状态
• whoopskill auth logout — 清除令牌

说明

• 默认输出为 JSON 到标准输出（使用 --pretty 获取人类可读格式）
• 令牌存储在 ~/.whoop-cli/tokens.json（自动刷新）
• 使用 WHOOP API v2
• 日期遵循 WHOOP 日界（凌晨 4 点截止）
• 用户数少于 10 的 WHOOP 应用无需审核（可立即使用）

示例

whoopskill summary --color

📅 2026-01-25
🟢 恢复: 85% | HRV: 39ms | 静息心率: 63bpm
🟡 睡眠: 79% | 6.9h | 效率: 97%
🔴 负荷: 0.1 (理想值: ~14) | 579 卡路里

whoopskill trends

📊 7 天趋势

💚 恢复: 平均 62.1% (范围 34-86) →
💓 HRV: 平均 33.8ms (范围 26-42) →
❤️ 静息心率: 平均 63.8bpm (范围 60-68) →
😴 睡眠: 平均 75.4% (范围 69-79) →
🛏️ 时长: 平均 6.5h (范围 5.7-7.8) ↓
🔥 负荷: 平均 5.9 (范围 0.1-9.0) ↓

whoopskill insights

💡 洞察与建议

✅ 绿色恢复
   恢复分数 85% — 身体已准备好承受高负荷。
   → 今天是进行高强度训练或比赛的绝佳时机。

✅ HRV 高于基线
   今日 HRV (39ms) 比您 7 天平均值高 21%。
   → 恢复状况极佳。是发挥最佳表现的好日子。

⚠️ 轻度睡眠负债
   您有 2.0 小时的睡眠负债。
   → 考虑今晚早点睡觉。

✅ 尚有负荷承受空间
   当前负荷: 0.1。理想目标: ~14。
   → 今天还可承受 13.9 的负荷。

whoopskill --sleep --recovery (JSON)

{
  "date": "2026-01-05",
  "fetched_at": "2026-01-05T13:49:22.782Z",
  "body": {
    "height_meter": 1.83,
    "weight_kilogram": 82.5,
    "max_heart_rate": 182
  },
  "sleep": [
    {
      "id": "4c311bd4-370f-49ff-b58c-0578d543e9d2",
      "cycle_id": 1236731435,
      "user_id": 245199,
      "created_at": "2026-01-05T00:23:34.264Z",
      "updated_at": "2026-01-05T02:23:54.686Z",
      "start": "2026-01-04T19:51:57.280Z",
      "end": "2026-01-05T01:30:48.660Z",
      "timezone_offset": "+04:00",
      "nap": false,
      "score_state": "SCORED",
      "score": {
        "stage_summary": {
          "total_in_bed_time_milli": 20331380,
          "total_awake_time_milli": 4416000,
          "total_light_sleep_time_milli": 6968320,
          "total_slow_wave_sleep_time_milli": 4953060,
          "total_rem_sleep_time_milli": 3994000,
          "sleep_cycle_count": 4,
          "disturbance_count": 4
        },
        "sleep_needed": {
          "baseline_milli": 26783239,
          "need_from_sleep_debt_milli": 6637715,
          "need_from_recent_strain_milli": 148919
        },
        "respiratory_rate": 14.12,
        "sleep_performance_percentage": 40,
        "sleep_consistency_percentage": 60,
        "sleep_efficiency_percentage": 78.28
      }
    }
  ],
  "workout": [
    {
      "id": "4279883e-3d23-45cd-848c-3afa28dca3f8",
      "user_id": 245199,
      "start": "2026-01-05T03:14:13.417Z",
      "end": "2026-01-05T04:06:45.532Z",
      "sport_name": "hiit",
      "score_state": "SCORED",
      "score": {
        "strain": 6.19,
        "average_heart_rate": 108,
        "max_heart_rate": 144,
        "kilojoule": 819.38,
        "zone_durations": {
          "zone_zero_milli": 167000,
          "zone_one_milli": 1420000,
          "zone_two_milli": 1234980,
          "zone_three_milli": 330000,
          "zone_four_milli": 0,
          "zone_five_milli": 0
        }
      }
    }
  ],
  "profile": {
    "user_id": 245199,
    "email": "user@example.com",
    "first_name": "John",
    "last_name": "Doe"
  },
  "recovery": [
    {
      "cycle_id": 1236731435,
      "sleep_id": "4c311bd4-370f-49ff-b58c-0578d543e9d2",
      "user_id": 245199,
      "score_state": "SCORED",
      "score": {
        "recovery_score": 52,
        "resting_heart_rate": 60,
        "hrv_rmssd_milli": 38.87,
        "spo2_percentage": 96.4,
        "skin_temp_celsius": 33.19
      }
    }
  ],
  "cycle": [
    {
      "id": 1236731435,
      "user_id": 245199,
      "start": "2026-01-04T19:51:57.280Z",
      "end": null,
      "score_state": "SCORED",
      "score": {
        "strain": 6.66,
        "kilojoule": 6172.94,
        "average_heart_rate": 71,
        "max_heart_rate": 144
      }
    }
  ]
}