Strava 技能

使用 AI 与你的 Strava 数据进行对话。可查询训练活动、体能趋势、个人最佳成绩（PR）、训练负荷等信息。本功能由 Transition 提供支持，Transition 会与 Strava 同步，使 AI 智能体能够访问你的训练数据。

配置步骤

1. 下载 Transition 并连接你的 Strava 账户
2. 进入 设置 > API 密钥，点击 生成新密钥
3. 设置环境变量：

export TRANSITION_API_KEY="tr_live_xxxxxxxxxxxxxxxxxxxxx"

无需认证的接口

每日训练（Workout of the Day）

生成一个随机的结构化训练计划 —— 无需登录账户。

curl "https://api.transition.fun/api/v1/wod?sport=run&duration=45"

参数说明：

• sport — 可选值：run、bike、swim 或 strength（默认为 run）
• duration — 训练时长（单位：分钟），取值范围为 10–300（默认为 45）

需认证的接口

基础 URL： https://api.transition.fun
认证方式： 所有请求均需在请求头中携带 X-API-Key。

AI 教练对话

就你的 Strava 数据提出问题。AI 教练已完整掌握你的训练活动与表现数据上下文。

curl -X POST -H "X-API-Key: $TRANSITION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "我这周的长距离跑相比上周表现如何？"}' \
  "https://api.transition.fun/api/v1/coach/chat"

示例问题：

• “过去一个月我的周跑量趋势如何？”
• “我的自行车 FTP 水平近期进展如何？”
• “我这周的跑步量比平时多还是少？”
• “我最近一次最快的 5K 成绩是多少？”
• “根据我近期的活动情况，今天该休息还是训练？”

获取训练计划

按日期范围拉取已排期的训练计划。

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/workouts?start=2026-02-09&end=2026-02-15"

参数说明：

• start — 起始日期（格式：YYYY-MM-DD，必填）
• end — 结束日期（格式：YYYY-MM-DD，必填）
• start 与 end 之间的最大时间跨度为 90 天。

运动表现管理图（PMC）

获取基于 Strava 活动计算得出的 CTL（体能水平）、ATL（疲劳度）和 TSB（状态指数）。

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/performance/pmc"

运动表现统计

获取 FTP、阈值配速、心率区间以及其他从 Strava 数据推导出的关键指标。

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/performance/stats"

运动员档案

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/profile"

对话历史记录

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/coach/history"

调用频率限制

智能体开发建议

1. 优先使用教练对话接口（coach chat）作为主要交互方式。 该接口已完整集成用户 Strava 活动、训练负荷与表现数据上下文，只需以自然语言提问即可。

2. 推荐高强度训练前，务必检查疲劳程度。 调用 GET /api/v1/performance/pmc 接口并查看 TSB 值；若 TSB 低于 -20，则表明运动员处于疲劳状态。

3. 可直接调用免费的 WOD 接口快速生成训练建议。 无需身份认证，适合仅需临时训练方案的用户。

4. 所有涉及日期的参数均须使用 YYYY-MM-DD 格式。