跑步计算服务

解决什么问题

跑者在规划训练时经常需要在三件事之间来回切换：把一次比赛成绩换算成可持续训练的能力指标、把能力指标反推成各强度区间的配速、再把配速在不同单位之间换算。这些计算背后是 Jack Daniels、Riegel、McMillan 等多套公式，手工做容易出错，散落在表格和笔记里又难以复用。这个技能把这些计算收敛到一个可调用的服务里：模型负责理解意图和传参，代码负责调 API 拿结果。

核心能力

• VDOT 计算：输入距离（米）和用时（秒），按 Jack Daniels 方法输出有氧能力值，作为后续配速与预测的基准。
• 训练配速：给定 VDOT，输出轻松跑区间、马拉松配速、阈值配速、间歇配速和重复跑配速。
• 比赛预测：从一次已知成绩预测目标距离的成绩，支持 Daniels 等效表现与 Riegel 公式两套方法，可交叉对比。
• McMillan 系列：从一次比赛成绩计算速度标记（vLT、CV、vVO2）、标准距离成绩预测，以及按耐力、体能、速度、冲刺分区的训练配速。
• 心率区间：输入年龄、静息心率和可选的最大心率，输出最大心率估计值与 HRMAX、HRRESERVE 两套方法下的训练区间。
• 配速换算：在 min_km、min_mile、kmh、mph 之间转换数值与可读格式。

工作流程

1. 检查 API 密钥：首次使用时若未配置 XBY_APIKEY，会通过 AskUserQuestion 询问用户，拿到后调用 scripts.config.set_api_key 保存。
2. 选择工具：根据用户意图匹配对应的工具函数。
3. 提取参数：从对话中提取所需参数，缺失时同样用 AskUserQuestion 追问。
4. 调用工具：以关键字参数调用 scripts.tools 中的函数，例如 daniels_calculate_vdot(distance=..., time=...)。
5. 返回结果：工具返回的 raw 数据整理后直接展示。

注意点

• API 密钥是硬性前置条件，缺少密钥时不会降级为离线估算或编造数据，只会阻塞流程直到用户提供。
• 各工具链的输入约定不一致：Daniels 配速工具吃的是 VDOT，McMillan 系列吃的是一次比赛的距离和用时，调用前需确认参数来源。
• 心率区间的预测质量取决于静息心率测量的准确性；未提供最大心率时结果基于公式估算，与实测值可能有偏差。
• 比赛预测依赖公式假设，坡道、天气、训练疲劳等现实因素不在计算范围内，适合作为训练目标参考而非精确预言。