TrainingPeaks

核心功能

TrainingPeaks Skill 是一款面向耐力运动爱好者的命令行工具，通过浏览器Cookie认证方式对接TrainingPeaks内部API，无需官方API密钥即可获取个人训练数据。核心功能包括：实时拉取训练计划与课表、查询CTL（慢性训练负荷）、ATL（急性训练负荷）、TSB（训练状态平衡）等经典体能指标、检索骑行/跑步/游泳等多项目个人纪录（PR），以及查看教练备注和课表详情。

显著优点

零门槛接入：采用Cookie替代API Key的认证方案，解决了TrainingPeaks官方API申请繁琐、门槛高的问题，普通用户即可快速上手。纯Python标准库实现：无额外依赖，部署轻便，适合各类环境包括CI/CD流水线。数据维度丰富：覆盖训练管理全流程——从宏观体能曲线（PMC模型）到微观单次训练数据，再到历史最佳成绩追踪。安全存储机制：凭证文件采用0600权限存储，配合环境变量支持，兼顾安全性与自动化需求。

潜在局限与风险

认证稳定性依赖Cookie有效期：Production_tpAuthCookie有效期为数周，过期需重新从浏览器提取，不适合完全无人值守的长期自动化场景。非官方接口：基于内部API逆向实现，存在TrainingPeaks官方调整接口导致工具失效的风险，且无服务保障。速率限制保守：150ms最小请求间隔限制了大批量数据拉取效率。数据范围限制：单次查询最多90天训练记录，历史数据需分批次获取。

适合人群

主要面向认真训练的业余耐力运动员（铁三、公路车、马拉松等）及其教练，特别是：已在使用TrainingPeaks平台管理训练、需要自动化数据导出用于自定义分析（如配合Python/R数据科学工作流）、或希望将训练数据整合至个人Dashboard的技术型用户。

常规风险提示

Cookie凭证具有较高权限，等同于账号登录状态，需妥善保管避免泄露。建议仅在受信任的个人设备上使用，避免在公共CI日志中明文输出TP_AUTH_COOKIE环境变量。

TrainingPeaks Skill 综合评估

TrainingPeaks Skill 是一款面向耐力运动爱好者的专业数据同步工具，通过官方 API 安全访问个人训练数据。该 Skill 采用纯 Python 标准库实现，无任何第三方依赖，从根本上杜绝了供应链攻击风险。

核心功能

• 训练数据同步：查询 90 天内训练计划、已完成/待完成课程
• 体能指标追踪：实时获取 CTL（慢性训练负荷）、ATL（急性训练负荷）、TSB（训练压力平衡）
• 个人纪录管理：支持自行车功率（5秒-90分钟）和跑步配速（400米-50公里）PR 查询
• 智能认证管理：OAuth Bearer Token 自动刷新，60 分钟有效期+自动续期机制

显著优点

1. 零依赖架构：仅使用 Python 内置库（urllib、json、pathlib），无 pip 安装风险
2. 企业级安全：凭证存储采用 0600 文件权限，HTTPS 通信+150ms 请求频率限制
3. 官方 API 对接：直接调用 TrainingPeaks 内部 API，数据来源权威可靠
4. 多场景适配：支持环境变量注入（CI/CD 友好）和交互式命令行两种模式

潜在局限

• 认证依赖浏览器 Cookie（Production_tpAuth），需手动获取
• 单次查询限制 90 天历史数据，长期分析需多次调用
• 纯 CLI 界面，无图形化展示功能
• Cookie 有效期约数周，需定期重新认证

适合人群

• 铁三/公路车/马拉松等耐力运动严肃训练者
• 需要自动化训练数据归档的量化运动爱好者
• 教练与运动员间的训练计划同步场景
• 希望自建训练分析管道的技术型用户

常规风险提示

• 凭证文件（~/.trainingpeaks/）需妥善保管，建议配合系统全盘加密
• 避免在共享服务器或多用户环境中明文存储 Cookie
• 定期轮换认证 Cookie 可降低泄露风险
• 虽然代码安全，但仍建议从可信渠道获取更新