Section 11: Endurance Training Coach (Intervals.icu)

🚴 你的私人数据主权骑行教练

health-fitness榜 #13

开源自行车耐力训练AI教练协议,基于心率/功率数据分析生成个性化训练计划,需配合Intervals.icu数据源使用,支持自动化训练日历管理

收藏
8.8k
安装
2.6k
版本
1.0.11
CLS 安全性认证2026-05-21
点击查看完整报告 >

使用说明

核心功能

Section 11 是一套循证耐力骑行训练教练协议,专为需要数据驱动训练方案的耐力自行车运动员设计。其核心工作流围绕 JSON 训练数据的实时分析展开:每次训练咨询前必须抓取 latest.json(近7天快照+28天衍生指标)和 history.json(90天日度/180天周度/3年月度纵向数据),结合运动员档案(DOSSIER.md)和心跳配置(HEARTBEAT.md)生成个性化建议。

关键特性:

  • 循证决策:严格禁止对预计算指标(CTL、ATL、TSB、ACWR、RI等)进行虚拟估算,必须从抓取的数据中读取
  • 标准化报告:提供训练前准备度评估(Go/Modify/Skip 三档建议)和训练后复盘模板
  • 写回能力:在支持代码执行的平台(OpenClaw、Claude Code等)上,可通过 push.py 直接管理 Intervals.icu 日历——包括推送计划、调整阈值、添加批注
  • 自动化心跳:可选启用每日训练观察+天气检查、每周趋势分析的自动调度

优势

1. 数据主权设计:训练数据存储在用户自选的本地设备或私有仓库,项目本身不运行任何后端服务,彻底杜绝第三方数据托管风险
2. 供应链透明:所有协议文件、模板、同步脚本均开源在 GitHub 仓库,可被审计和分叉

3. 分层安全边界:协议获取、数据读取、写操作三者分离,写操作默认预览模式且需 --confirm 显式确认

4. 匿名化内置sync.py 自动将原始训练数据转换为聚合衍生指标,AI 教练不接触敏感原始轨迹

局限性与风险

| 维度 | 说明 |
|------|------|
| **使用门槛** | 需要用户自行配置 GitHub 私有仓库或本地 JSON 数据源,首次 setup 涉及多个模板填写(DOSSIER.md、HEARTBEAT.md),对非技术用户不够友好 |
| **平台限制** | 写回功能仅在支持代码执行的环境可用,网页版聊天用户只能获得建议无法自动同步日历 |
| **数据源依赖** | 核心功能强依赖 Intervals.icu 的导出数据,若该平台服务中断或 API 变更,协议将失效 |
| **协议更新风险** | 运行时从远程仓库抓取 `SECTION_11.md`,虽便利但引入供应链攻击面(用户可分叉自管) |
| **医学边界** | 明确声明不替代医疗建议,伤病恢复等场景需人工教练介入 |

适合人群

  • 数据驱动型业余/半职业耐力车手:已使用 Intervals.icu 或类似平台记录训练,希望获得比平台默认算法更个性化的AI分析
  • 自学型运动员:能独立完成技术配置(GitHub/本地文件管理),不需要"开箱即用"的托管服务
  • 隐私敏感用户:拒绝将训练数据上传至任何第三方云服务
  • 混合教练模式:真人教练用于周期规划和伤病管理,Section 11 用于日常数据监控和即时训练调整

常规风险提示

  • 配置错误风险:JSON 数据源 URL 配置错误可能导致抓取失败或读取到过期缓存数据,建议定期校验 latest.json 时间戳
  • 阈值更新纪律set-threshold 操作要求"经验证的测试结果",禁止从估算值更新,违规操作将扭曲后续训练负荷计算
  • 自动化谨慎:心跳机制的"Self-schedule next heartbeat"若配置不当可能导致非预期频繁调用,建议在理解随机化调度逻辑后再启用

安全解读

核心用法

Section 11 是一套循证耐力骑行AI教练协议,专为结构化训练分析和智能指导设计。主要功能包括:

  • 训练数据分析:自动获取运动员JSON数据(latest.json/history.json),计算CTL、ATL、TSB、ACWR等核心指标
  • 训练计划制定:基于运动员档案(DOSSIER.md)生成个性化训练建议
  • 日历管理:通过可选的push.py写入Intervals.icu训练日历(需显式确认)
  • 智能报告:预训练前/后标准化报告模板,包含Go/Modify/Skip决策建议
  • 自动化心跳:可选的定时检查机制,监控训练状态、天气条件和恢复指标

首次使用需完成三步配置:创建DOSSIER.md运动员档案、设置JSON数据源、配置HEARTBEAT.md环境参数。

---

显著优点

1. 数据主权完整:所有训练数据存储在用户控制的本地设备或私有仓库,无云端托管,无遥测收集
2. 多层安全边界:写入操作默认预览模式+显式--confirm确认+复用用户已有密钥,形成纵深防御

3. 开源透明:MIT许可证,完整代码和协议托管于GitHub,可审计可Fork

4. 循证决策:基于科学训练模型(CTL/ATL/TSB/ACWR),禁止虚拟计算预聚合指标

5. 灵活部署:支持纯本地模式(零网络)到GitHub Actions自动化全谱系

---

潜在缺点与局限性

| 方面 | 说明 |
|------|------|
| 动态协议加载 | 运行时从GitHub拉取SECTION_11.md,存在供应链风险(已标记为设计选择) |
| 手动配置门槛 | 需手动设置JSON同步、仓库密钥、多配置文件,技术门槛较高 |
| 仅限Intervals.icu | 写入功能深度绑定该平台,其他训练平台不支持 |
| 无原生移动App | 依赖AI对话界面,移动端体验受限于聊天工具 |
| 个人维护者 | T3级来源(CrankAddict个人账号),长期维护存在不确定性 |

---

适合人群

  • 数据驱动型业余/职业车手:熟悉功率训练概念(FTP、TSS、PMC),愿意配置技术环境
  • 教练-运动员远程协作:教练可通过标准化协议为多位运动员提供一致指导
  • 隐私敏感用户:拒绝Strava Training等云端方案,要求数据完全本地化
  • 开源技术爱好者:愿意Fork维护,自定义训练算法和报告模板

---

常规风险

| 风险项 | 等级 | 说明 |
|--------|------|------|
| 协议供应链攻击 | 中 | 上游仓库被入侵可注入恶意协议,建议Fork自用 |
| SSRF/恶意数据源 | 低 | 用户配置的JSON URL可能被利用,推荐本地文件 |
| 自动化误操作 | 低 | 心跳功能需显式启用,但配置错误可能导致错误训练建议 |
| 写入权限滥用 | 低 | 虽有多层保护,平台被入侵+用户确认的组合风险存在 |
| 数据恢复依赖 | 中 | 无内置备份机制,用户需自行管理JSON数据版本 |

关键建议:高安全需求用户应采用本地文件模式,完全禁用外部URL;常规用户至少应Fork仓库并指向自己的协议副本。

Section 11: Endurance Training Coach (Intervals.icu) 内容

手动下载zip · 5.6 kB
HEARTBEAT_TEMPLATE.mdtext/markdown
请选择文件