Garmin Ultimate Frisbee Analysis 是一款专为终极飞盘运动员设计的数据分析工具，旨在通过解析 Garmin 穿戴设备采集的健康与运动数据，生成直观、交互式的 HTML 仪表板，帮助运动员和教练深入理解比赛表现、训练负荷及恢复状态。该工具利用 Garmin Connect API 获取活动记录、睡眠、心率变异性（HRV）和 Body Battery 等关键指标，并结合 FIT 文件解析技术提取冲刺速度、高强度距离等专属飞盘运动的核心数据。所有分析结果均以可视化图表形式呈现，支持赛后复盘、多日赛事疲劳追踪以及整个赛季的长期趋势对比。 工具采用 Python 编写，依赖 garminconnect、fitparse 和 gpxpy 等库实现数据对接与处理。用户需配置邮箱和密码以完成首次身份验证，系统会在本地安全存储会话令牌，确保隐私安全。安装后可通过命令行调用多个脚本，例如 `frisbee_activity.py` 分析单次活动细节，`frisbee_tournament.py` 生成锦标赛期间的综合报告，而 `frisbee_compare.py` 则支持跨训练、比赛或全赛季的数据对比。输出结果为可保存至本地的 HTML 文件，便于离线查看或与团队共享。 该工具特别关注飞盘运动中特有的体能消耗模式，如高频冲刺、快速变向和间歇性高强度输出。它自动计算 Sprint Fatigue Index（冲刺疲劳指数），判断运动员在比赛末段是否出现速度衰减；同时通过 Heart Rate Recovery（HRR）曲线评估心血管恢复能力，结合 Body Battery 值预测赛前准备状态。这些科学指标使运动员能够更精准地调整训练强度、优化恢复策略，并避免过度疲劳导致的伤病风险。
核心功能特点
- 解析 Garmin 穿戴设备的 FIT/GPX 活动数据，提取冲刺次数、最高速度和高强度距离等飞盘专项指标
- 生成交互式 HTML 仪表板，包含活动摘要、速度时间线、心率区间分布和疲劳趋势图
- 支持单场赛后深度分析、多日赛事综合回顾和全赛季表现对比三种核心分析模式
- 自动计算 Sprint Fatigue Index 和 Heart Rate Recovery 曲线，量化比赛中的体能衰退与恢复效率
- 集成 Body Battery、HRV 和睡眠数据，提供赛前 readiness 评估和累积疲劳监控
- 环境变量加密登录，会话令牌本地安全存储，保障用户账号隐私与数据安全
适用场景
这款工具最适合用于赛后即时复盘，运动员可在比赛结束后立即查看自己的冲刺表现、心率负荷和疲劳程度。例如，通过运行 `frisbee_activity.py –latest` 命令，系统会生成一份包含冲刺次数、最高速度和冲刺疲劳指数的详细报告，帮助识别比赛中后期是否出现速度下降问题。对于参加多日锦标赛的选手，`frisbee_tournament.py` 脚本能整合数天的活动与恢复数据，绘制 Body Battery 疲劳曲线、各场比赛平均心率对比以及夜间睡眠时长与 HRV 变化，从而判断整体竞技状态是否稳定或存在过度消耗。 在训练规划方面，教练或运动员可利用 `frisbee_compare.py` 进行训练与比赛的强度对标分析。比如执行 `frisbee_compare.py –mode cross –days 60` 可比较过去两个月内训练与正式比赛的心率均值，验证训练是否达到比赛所需的刺激水平。若发现训练平均心率显著低于比赛水平，则可能需要增加高强度间歇训练的比例。此外，长期跟踪赛季表现时，该工具还能展示 top speed 随时间的提升趋势、HRV 改善情况以及活动总量变化，为制定下一阶段训练计划提供数据支撑。 无论是个人自我管理还是团队协同分析，生成的 HTML 仪表板均可导出为静态文件，方便在非联网环境下查阅或提交给体能教练审阅。所有图表均基于 Chart.js 构建，具备缩放、悬停提示等功能，极大提升了数据解读的便捷性与专业性。