Wahoo Skill — 骑行数据分析

Wahoo Skill — 骑行数据分析

连接 Wahoo Fitness Cloud，下载骑行训练数据，解析 FIT 文件到本地 SQLite 进行深度分析。

clawhub install wahoo-skill

核心功能

• 训练数据获取：通过 Wahoo Cloud API 拉取历史骑行记录，包含时间、距离、时长、平均功率等摘要
• FIT 文件下载：自动下载每条训练的原始 FIT 文件，保留完整的逐秒数据
• 多维度解析：从 FIT 文件提取功率（Power）、心率（HR）、踏频（Cadence）、GPS 轨迹和海拔数据
• 本地 SQLite 存储：所有数据存入本地 SQLite 数据库，支持离线查询和自定义分析
• 圈数据分析：v0.1.5 新增圈（Lap）分析功能，提取每圈的功率、心率、踏频和训练区间分布

前置条件

1. 拥有 Wahoo Fitness 账号并同步过骑行数据
2. 获取 Wahoo Cloud API 访问凭据：

export WAHOO_EMAIL=your-email@example.com
export WAHOO_PASSWORD=your-password

3. 安装 Python 依赖：pip install garmin-fit-sdk

使用示例

获取最近训练列表

{
  "action": "list_workouts",
  "limit": 10,
  "startDate": "2026-04-01"
}

下载并解析特定训练

{
  "action": "analyze",
  "workoutId": "12345",
  "metrics": ["power", "hr", "cadence", "gps"],
  "includeLaps": true
}

圈数据分析输出

{
  "laps": [
    {"lap": 1, "avgPower": 245, "avgHR": 152, "avgCadence": 88, "duration": 300, "zone": "Threshold"},
    {"lap": 2, "avgPower": 198, "avgHR": 138, "avgCadence": 82, "duration": 420, "zone": "Endurance"}
  ],
  "summary": {
    "totalLaps": 2,
    "normalizedPower": 228,
    "intensityFactor": 0.85
  }
}

数据库结构

• workouts 表：训练摘要（日期、距离、时长、TSS 等）
• records 表：逐秒数据（时间戳、功率、心率、踏频、位置）
• laps 表：圈数据（每圈统计值和区间分布）

适用场景

• 骑行爱好者的训练数据分析
• 教练为运动员制定训练计划的数据支撑
• 功率训练区间和疲劳度评估
• 赛季训练负荷趋势追踪

提示：FIT 文件是 Garmin 定义的标准格式，Wahoo、Garmin、Polar 等主流运动设备均使用此格式。本 Skill 的解析逻辑可适配其他品牌的 FIT 文件。