intervals.icu CLI 是一个专为与 Intervals.icu 平台交互而设计的命令行工具，适用于需要通过本地终端直接管理训练数据、活动记录和计划安排的开发者或高级用户。该工具通过标准化的 API 调用，允许用户在无需图形界面的情况下，高效地查询历史活动、创建锻炼事件、上传训练日志以及管理 wellness 数据。使用前需确保已安装 `intervals` 二进制文件并通过环境变量（如 `INTERVALS_API_KEY` 或 `INTERVALS_ACCESS_TOKEN`）完成身份验证。CLI 遵循简洁的设计原则：优先使用 JSON 格式输出结果，支持绝对日期输入，并将标准输出作为数据载体，标准错误流用于诊断信息。整个操作流程强调安全性和可逆性——除非用户明确要求修改操作，否则不会执行写入或删除命令；临时文件在任务完成后自动清理，避免资源残留。
核心功能特点
- 支持通过命令行查询 Intervals.icu 中的活动记录，包括按文本、标签或语义条件筛选
- 可创建和管理锻炼事件（events），适用于为特定日期安排训练计划
- 提供 workouts 功能，用于保存可重复使用的训练模板供后续调用
- 支持 wellness 数据的批量或单点写入，便于整合睡眠、压力等健康指标
- 默认以 JSON 格式返回结果，便于脚本自动化处理与系统集成
- 严格遵循只读优先原则，所有修改操作均需显式用户授权
适用场景
intervals.icu CLI 特别适合那些希望将训练数据管理与开发流程深度集成的技术型健身爱好者或教练。例如，当用户需要快速检索过去一周内所有高强度间歇训练（HIIT）记录时，可通过 `activities search` 命令结合标签过滤实现精准定位，并以结构化 JSON 格式导出供进一步分析。对于周期性训练计划的制定，用户可利用 `events upsert` 为未来某一天自动插入一个预定义的骑行路线挑战，而无需每次手动操作网页端界面。若某次户外跑步表现出色，想将其保存为可随时调用的训练模板，则应使用 `workouts create` 命令生成 reusable workout 对象。此外，在整合可穿戴设备数据时，`wellness bulk-put` 能高效导入多日的睡眠质量与心率变异性指标，帮助构建更全面的训练负荷模型。由于 CLI 完全依赖环境变量进行认证且输出可控，它也常被用于 CI/CD 流水线中自动同步训练成果或生成周报摘要。