专业耐力运动数据管家

基于 TrainingPeaks 官方 API 的 CLI 工具，纯 Python 标准库实现，帮助耐力运动爱好者和教练高效获取训练计划、健身指标与个人记录。

基本信息

• 技能名称?trainingpeaks
• 中文名称?专业耐力运动数据管家
• 作者?rubengarciam
• 分类?专业技能
• 版本?v1.0.1
• 标签?healthcare-life-sciences, data-analytics, api, automation, productivity

使用方法

使用说明
核心用法
TrainingPeaks Skill 是一款面向耐力运动（骑行、跑步、游泳、铁人三项）的 CLI 数据访问工具，通过 Cookie 认证方式连接 TrainingPeaks 内部 API。用户只需从浏览器获取 Production_tpAuth Cookie 即可完成认证，无需申请 API Key。核心功能包括：运动员资料查询、训练计划与锻炼记录检索（支持 90 天范围筛选）、CTL/ATL/TSB 健身指标追踪，以及多维度个人记录（PR）查询。所有数据支持 --json 输出，便于与其他工具链集成。
显著优点

1. 零依赖部署 ：纯 Python 标准库实现，无需 pip 安装任何第三方包，极大降低环境冲突和供应链攻击风险。
2. 安全凭证管理 ：Cookie 和 Token 存储于 ~/.trainingpeaks// 目录，采用 0600 文件权限，支持环境变量覆盖，兼顾安全性与自动化场景。
3. 智能认证机制 ：Bearer Token 自动缓存与刷新，Cookie 有效期长达数周，减少重复认证负担。
4. 专业运动数据覆盖 ：完整支持 CTL（慢性训练负荷）、ATL（急性训练负荷）、TSB（训练压力平衡）等进阶健身指标，以及功率、心率、配速等多维度 PR 查询。
5. 限速与容错 ：内置 150ms 请求间隔限制，避免触发 API 限流；完善的错误提示引导用户重新认证。
   潜在缺点与局限性
6. 只读限制 ：无法创建、修改或删除训练计划，仅适合数据分析和监控场景，不适用于主动训练管理。
7. Cookie 获取门槛 ：非技术用户可能不熟悉浏览器 DevTools 操作，首次配置存在一定学习成本。
8. 查询范围受限 ：单次锻炼查询最大 90 天，长期历史数据需分批次获取。
9. 平台绑定 ：完全依赖 TrainingPeaks 平台，若官方 API 变更或 Cookie 机制调整，可能导致功能失效。
10. 无图形界面 ：纯 CLI 工具，对偏好可视化操作的用户不够友好。
    适合的目标群体
    耐力运动教练 ：批量获取学员训练数据，进行周期化训练分析
    严肃业余运动员 ：深度追踪 CTL/ATL/TSB 趋势，优化训练负荷管理
    数据分析师/运动科研人员 ：提取结构化 JSON 数据用于统计建模和研究
    自动化爱好者 ：结合 CI/CD 或定时任务，实现训练数据自动同步与报告生成
    使用风险
    凭证泄露风险 ：Cookie 相当于长期有效的登录凭证，若设备被入侵，攻击者可获取训练数据；建议配合全盘加密使用
    Token 过期中断 ：虽然支持自动刷新，但极端情况下（如长期离线后首次使用）可能遇到认证失败，需手动重新获取 Cookie
    API 变更风险 ：TrainingPeaks 未公开承诺内部 API 稳定性，未来版本可能不兼容
    数据隐私边界 ：工具本身不上传数据至第三方，但用户需自行确保 JSON 输出文件的安全存储