xby-running-formulas: 跑步計算服務

開發智能體時，集成垂直領域工具是常見需求。對於跑步場景，計算 VDOT、訓練配速或預測比賽時間通常依賴外部工具或手動公式。xby-running-formulas 是一個 MCP 服務器，它爲 DeepSeek Harness 提供了這些計算能力。

插件介紹¶

這是一個由 xby-skill 維護的聯網工具。它是一個提供全面的跑步計算工具的 MCP 服務器，包括 VDOT 計算、訓練配速、比賽時間預測、速度標記、心率區間和配速轉換等功能。

核心功能¶

該插件主要基於 Jack Daniels 和 McMillan 兩種跑步公式體系提供計算服務：

• Jack Daniels 公式

  • daniels_calculate_vdot: 根據 Jack Daniels 算法計算 VDOT。
  • daniels_calculate_training_paces: 根據給定 VDOT 獲取推薦訓練配速（輕鬆跑、馬拉松配速、閾值跑、間歇跑、重複跑）。
  • daniels_predict_race_time: 基於已知比賽表現預測目標距離的比賽時間。

• Riegel 公式

  • riegel_predict_race_time: 基於已知比賽表現，使用 Riegel 公式預測目標距離的比賽時間。

• McMillan 公式

  • mcmillan_calculate_velocity_markers: 從比賽表現計算速度標記（vLT, CV, vVO2）。
  • mcmillan_predict_race_times: 基於單場比賽表現預測標準距離的比賽時間。
  • mcmillan_calculate_training_paces: 基於比賽表現計算所有區域的訓練配速。
  • mcmillan_heart_rate_zones: 基於年齡、靜息心率和最大心率（可選）計算心率訓練區間。

• 通用工具

  • set_xby_apikey: 在聊天中設置 API 密鑰（自動持久化，重啓有效）。
  • convert_pace: 在不同配速和速度單位之間進行轉換。

安裝與啓用¶

通過以下命令從 GitHub 安裝插件：

dsh plugin --profile web add github:xby_skill/xby-running-formulas

典型用法¶

在 DSH 交互中，可以直接調用上述功能。以下是幾種典型的調用方式：

1. 計算 VDOT
   輸入距離（米）和時間（秒），獲取 VDOT 值：

    daniels_calculate_vdot(distance, time)

2. 配速單位轉換
   在 min_km、min_mile、kmh、mph 之間轉換數值：

    convert_pace(value, from_unit, to_unit)

3. 計算心率區間
   輸入年齡、靜息心率和最大心率，獲取訓練區間：

    mcmillan_heart_rate_zones(age, resting_heart_rate, max_heart_rate)

注意事項¶

• API 密鑰: 使用前需要註冊小笨羊官網獲取 API 密鑰。
• 錯誤處理: convert_pace 函數在單位無效或轉換不支持時會拋出 ValueError，調用時需注意參數校驗。

總結¶

該插件爲 DeepSeek Harness 提供了標準化的跑步數據計算能力，開發者可以通過簡單的函數調用實現複雜的運動科學計算。更多詳情可查看插件目錄或源碼倉庫。