Coach

Coach Watts

---

🚀 概述

Coach Watts 是一个全面的可自托管耐力训练平台，专为骑行者、跑步者和铁人三项运动员打造。它就像你的“数字孪生”，汇总来自你常用健身平台的数据，并利用 Google Gemini AI 提供专业级分析、个性化训练计划和每日建议。

与静态仪表盘不同，Coach Watts 能理解上下文——分析的不仅是你的功率数据，还包括恢复、睡眠、营养和生活压力，帮助你迈向巅峰表现。

✨ 主要功能

• 🔗 统一数据中心： 自动与多个健身平台同步，全面呈现运动员档案。
• 🤖 AI 教练：
  • 训练分析： 详细拆解每次训练，并提供执行评分。
  • 每日建议： 根据 HRV 和睡眠情况提供智能建议（“加大强度”或“休息”）。
  • 互动聊天： 由高性能 AI SDK v5 驱动的聊天功能，为你的训练问题提供基于数据的答案。
• 📈 高级分析： 通过直观的可视化图表追踪体能（CTL）、疲劳（ATL）、状态（TSB）和功率曲线。
• 🥗 营养追踪： 根据训练强度提供代谢供能方案（经济、稳定、表现）。
• 📅 智能规划： 生成适配日程和目标的自适应训练计划。
• 🌍 全球本地化： 平台完整支持 10 多种语言，并能智能处理时区。
• 📢 系统消息： 直接在仪表盘查看重要更新和教练提醒，及时掌握动态。

🖼️ 视觉导览

表现分析	训练日历

AI 训练分析	自适应规划

计划训练	AI 教练设置

🔌 集成

Coach Watts 可连接您喜爱的耐力运动和健康平台：

平台	同步功能
Intervals.icu	训练、日历、功率指标、健康状况/体重
Strava	活动数据、GPS 数据流、心率
Whoop	恢复、HRV、睡眠、运动负荷
Oura	准备度、睡眠、HRV、SpO2、压力、VO2 Max
Withings	身体成分（体重、脂肪百分比）、睡眠、健康状况
Garmin	活动数据、健康状况、健康指标
Wahoo	活动数据、训练
Polar	训练课程、健康状况、恢复
Yazio	营养日志、宏量营养素、补水
Hevy	力量训练、锻炼、组数和次数
Fitbit	步数、睡眠、活动、心率
Rouvy	室内骑行训练
Ultrahuman	CGM 数据、葡萄糖监测
Telegram	通过聊天进行 AI 辅导、通知

🌍 本地化

Coach Watts 为全球耐力运动社区打造。目前支持：

• English（en）、German（de）、Spanish（es）、French（fr）
• Hungarian（hu）、Italian（it）、Japanese（ja）、Dutch（nl）
• Russian（ru）、Chinese（zh）

我们使用 Tolgee 管理翻译。如果您愿意帮助将 Coach Watts 翻译成您的语言，请加入我们的 Discord！

⚡ 快速开始

前置条件

• Node.js 24（Active LTS — 请参阅 .nvmrc）
• Docker（用于 PostgreSQL）
• Google Cloud 账号（用于 Auth 和 Gemini API）

1. 克隆并安装

git clone [email protected]:hdkiller/coach.git
cd coach
cp .env.example .env
pnpm install

2. 启动数据库

docker-compose up -d
# Starts PostgreSQL on port 5439

MacOS 用户须知： 请确保 Docker Desktop 正在运行（例如，通过 Spotlight 打开 Docker.app）。

3. 配置环境

编辑 .env 文件，填入你自己的 API 密钥（见下文）：

vim .env # or on MacOS: open -a TextEdit .env

**注意：**你需要 Google（Auth 和 Gemini）的 API 密钥，也可以选择配置 Intervals.icu、Strava 等服务。请参阅获取凭据。

4. 运行迁移

pnpm prisma:generate
npx prisma migrate dev

5. 启动开发服务器

pnpm dev

访问 http://localhost:3099 并登录！

🛠️ 命令行工具

Coach Watts 提供了功能强大的命令行工具，用于执行管理任务：

# General help
pnpm cw:cli --help

# Monitor Trigger.dev status
pnpm cw:cli trigger list --prod

# Manage users and locations
pnpm cw:cli users location list-missing

📚 文档

我们在 docs/ 目录中提供了详尽的文档：

• 架构：系统设计和数据流。
• 数据库架构：详细的 Prisma 模型。
• 时区处理：我们如何管理全球运动员数据。
• 聊天开发：严格的 AI SDK 和 Gemini 调用顺序规则。
• 版本说明：各版本的详细变更日志。
• 功能指南：
  • AI 聊天系统
  • 营养逻辑
  • 评分系统
  • 集成指南

🤝 贡献

欢迎参与贡献！无论是修复 Bug、改进文档，还是提出新功能建议，都欢迎加入。

1. Fork 仓库。
2. 从 develop 创建分支（git checkout -b feature/amazing-feature develop）。
3. 提交更改。
4. 将更改推送到分支。
5. 创建一个目标分支为 develop 的 Pull Request。

**发布工作流说明：**所有 PR 都会合并到 develop。将 develop 合并到 master 后，才会发布版本并部署到生产环境。

📄 许可证

本项目根据 Apache License 2.0 发布。详情请参阅 LICENSE。第三方资源和贡献者的致谢信息请参阅 ACKNOWLEDGEMENTS.md。

Coach Watts 是开源项目吗？

是的。Coach Watts 根据 Apache 2.0 许可证开源。我们致力于开源软件，并与社区携手打造优秀的产品。

❤️ 社区与支持

• Discord：加入我们的服务器
• GitHub：在 GitHub 上为我们点星
• 问题反馈：报告 Bug

---

为耐力运动员倾心打造 ❤️