SkillRouter

## 核心用法 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 限流；完善的错误提示引导用户重新认证。 ## 潜在缺点与局限性 1. 只读限制：无法创建、修改或删除训练计划，仅适合数据分析和监控场景，不适用于主动训练管理。 2. Cookie 获取门槛：非技术用户可能不熟悉浏览器 DevTools 操作，首次配置存在一定学习成本。 3. 查询范围受限：单次锻炼查询最大 90 天，长期历史数据需分批次获取。 4. 平台绑定：完全依赖 TrainingPeaks 平台，若官方 API 变更或 Cookie 机制调整，可能导致功能失效。 5. 无图形界面：纯 CLI 工具，对偏好可视化操作的用户不够友好。 ## 适合的目标群体 - 耐力运动教练：批量获取学员训练数据，进行周期化训练分析 - 严肃业余运动员：深度追踪 CTL/ATL/TSB 趋势，优化训练负荷管理 - 数据分析师/运动科研人员：提取结构化 JSON 数据用于统计建模和研究 - 自动化爱好者：结合 CI/CD 或定时任务，实现训练数据自动同步与报告生成 ## 使用风险 - 凭证泄露风险：Cookie 相当于长期有效的登录凭证，若设备被入侵，攻击者可获取训练数据；建议配合全盘加密使用 - Token 过期中断：虽然支持自动刷新，但极端情况下（如长期离线后首次使用）可能遇到认证失败，需手动重新获取 Cookie - API 变更风险：TrainingPeaks 未公开承诺内部 API 稳定性，未来版本可能不兼容 - 数据隐私边界：工具本身不上传数据至第三方，但用户需自行确保 JSON 输出文件的安全存储