S-Bike Training Hub

S-Bike Training Hub

有条理地训练。让你的 AI 助手了解训练情况。你只管训练。

一个免费的骑行、游泳、跑步和力量训练中心，可在你自己的电脑（macOS、Windows 或 Linux）上运行。它会记录训练情况：你的计划、实际训练、训练强度、身体感受，以及错过训练的情况和原因。它会将这些信息提供给你的 AI 助手，让你们双方根据身体的实际反应来规划每周训练。无需订阅或账号，无论有没有智能自行车都能使用。

当前版本：app 1.12.2，MCP 1.12.2 · 更新内容 · Strava 社区

功能介绍

• **通过 AI 助手完成初始设置：**逐项了解你的基本情况、快速健康检查、当前训练情况和训练目标。
• **分两步规划：**先规划一个赛季的占位训练，以实现你的目标；再根据上周训练的情况，制定接下来一周的实际训练。保存前，你可以预览每项更改。
• **规划实现目标的训练计划：**测试周、基础期、发展期、赛事准备期、减量期和比赛周。保存前，你可以预览每项更改。
• 训练日历展示完整训练计划，每次显示三个月，并列出每天计划和记录的训练。
• 每日和每周回顾采用标准运动科学问卷：Hooper（疲劳、睡眠、压力、酸痛）、按身体部位记录疼痛、使用 CR-10 量表评估训练强度，以及 OSTRC 过度使用问卷。
• **适用于各种运动的训练：**以纯文本编写并实时预览，包括骑行功率训练、跑走训练和间歇跑、含出发间隔的游泳训练组，以及力量训练。也可以导入书面训练的照片或 PDF。
• **你的运动手表数据：**导入 COROS、Garmin 等设备的 .fit 和 .tcx 文件，或让你的助手获取数据。同一次骑行的自行车和手表记录只计一次。
• **不只关注训练量，也关注进步：**对比每次训练的配速或功率与心率，并匹配最接近的早期训练；开启此功能后，还会显示当天气温。
• **体能仪表板：**查看记录的能量消耗和训练量、训练对身体各部位的作用、按泳姿整理的游泳历史、举重记录和力量估算。
• **你的训练规则，**用简单句子写明：“我做不了引体向上”、“不做杠铃硬拉”。每次训练和每个助手都会遵守这些规则。
• 智能自行车桥接功能（已在 Merach S29 上测试）：ERG 训练、虚拟变速、将坡度转换为阻力、3D 路线和骑行游戏，还能让自行车与运动手表和 Kinomap 等应用共享。
• **自行车骑行模式（游戏）：**该中心通过内置游戏引擎运行游戏包。游戏会读取你的实时功率、踏频和速度，设置坡度，并根据你的 FTP 进行校准，让游戏体验也成为训练的一部分。冲刺或倾身等闪避动作可由你的踩踏、倾斜的平板电脑或摄像头触发（仅识别头部和肩膀，且在你的设备上处理）。该中心只运行由发布者签名且签名后未被更改的游戏包。
• **连接 AI 助手（MCP）：**Claude Desktop、Claude Code 或任何 MCP 应用都能读取你的训练记录并与你一起制定计划，使用的操作与应用中的按钮相同。

用户指南介绍了每个页面。

设置

1. 安装

一行命令安装（适用于 macOS、Windows 或 Linux；需要安装 uv）。这会安装整个中心，并将其连接到你的助手：

claude mcp add --scope user s-bike-hub -- uvx s-bike-training-hub@latest

对于 Claude Desktop，将以下内容添加到其配置文件中（Settings → Developer → Edit Config），然后重启 Claude：

{ "mcpServers": { "s-bike-hub": { "command": "uvx", "args": ["s-bike-training-hub@latest"] } } }

如果 Claude Desktop 找不到 uvx，请在 "command" 中填写它的完整路径（运行 which uvx 即可查看）。@latest 会让它在每次启动时检查是否有新版本。

然后向你的助手提问：“帮我设置 S-Bike Training Hub。” 它会为你启动中心（地址为 http://127.0.0.1:8729）并引导你完成设置。更新会自动获取：uvx 每次都会运行最新版本。

• 自行启动应用： uvx --from s-bike-training-hub s-bike-hub
• 地图和路线规划（可选，体积较大）： uvx --from s-bike-training-hub s-bike-hub-maps
• 你的数据保存在你自己的数据文件夹中，不会保存在应用里：macOS ~/Library/Application Support/S-Bike Hub，Windows %APPDATA%\S-Bike Hub，Linux ~/.local/share/s-bike-hub。
• 在 macOS 上连接智能自行车： 在终端中启动一次应用（uvx --from s-bike-training-hub s-bike-hub），这样 macOS 就能请求蓝牙权限。除实时自行车控制外，其他功能无需此权限也能使用。

从 GitHub 安装（获取完整源代码，以及设置脚本和桌面启动器）。需要 Python 3.11+。

macOS（包含所有功能，包括自行车桥接、菜单栏图标、路线规划器和 3D 地图）：

git clone https://github.com/JHarp199345/S-Bike-Training-Hub.git
cd S-Bike-Training-Hub
./setup.sh              # everything, with a smart bike and maps
./setup.sh --no-maps    # the bike bridge without route maps
./setup.sh --no-bike    # no smart bike: the coach, training records, lifting and the dashboard

Windows 10/11（下载 ZIP 格式的仓库，或克隆仓库，然后在该文件夹中打开 PowerShell）：

powershell -ExecutionPolicy Bypass -File setup.ps1           # the hub and the bike bridge
powershell -ExecutionPolicy Bypass -File setup.ps1 -NoBike   # no smart bike

Linux：

./setup-linux.sh             # the hub, the bike bridge and map tools (needs BlueZ: sudo apt install bluez)
./setup-linux.sh --no-maps   # skip the route planner and 3D maps
./setup-linux.sh --no-bike   # no smart bike

设置过程会创建 Python 环境、安装所需内容并创建启动器：macOS 和 Windows 桌面上的 S-Bike Hub，以及 Linux 上的 ./s-bike-hub.sh。浏览器会打开位于 http://127.0.0.1:8729 的中心，并显示欢迎页面。GitHub 安装会像以往一样，将你的数据保存在专属文件夹中。

• **地图：**在 Linux 上，路线规划还需要 Java；下载地图前会先询问你的地区。在 Windows 上，地图尚未设置。
• **测试：**每次变更后，都会在这三种系统上测试安装流程和模拟自行车。真实自行车和手表仅在 macOS 上经过测试。

2. 告诉它你的情况

最简单的方法：请已连接的助手为你进行设置（欢迎页面上有可复制的提示词）。它会询问你的基本信息，进行简短的健康检查，了解你的运动项目、目前的情况和目标，然后与你一起制定训练计划。每一步都需要你批准。

没有助手？在欢迎页面中打开没有助手？手动设置：填写你的运动项目和经验、体重、性别和心率、跑步情况，以及你的规则（用普通句子来指导每次训练；请参阅规则）。然后点击制定我的训练计划：中心会起草一份入门训练计划，你可以先预览和编辑，再应用。

3. 连接你的 AI 助手（可选，推荐）

中心负责保存记录；你的助手会与你一起规划。它适用于任何支持 MCP 服务的应用。

• 上方的一行安装命令已完成连接。
• **Claude Desktop（扩展包）：**从 发布页面下载 .mcpb 扩展包（MCP 1.12.2），然后选择 Settings → Extensions → Advanced settings → Install extension。中心地址保留为 http://127.0.0.1:8729。
• Claude Code：claude mcp add --scope user s-bike-hub -- "$PWD/.venv/bin/python" "$PWD/mcp_server.py"（Windows 上使用：.venv\Scripts\python.exe）。
• **其他 MCP 应用：**将它们指向使用 .venv Python 运行的 mcp_server.py。

助手必须与中心运行在同一台电脑上。ChatGPT 等仅限网页的助手目前还无法访问它。

然后与它对话："我这周状态怎么样？"、"我周二没练，因为生病了"、"围绕出差安排下周的计划"。内置了三个提示词：

• **daily-check-in：**完成每日签到，然后一起调整计划；
• **predict-my-race：**根据你的数据预测比赛成绩，并随着训练计划推进保存和完善预测；
• **get-my-bike-working：**设置中心无法识别的自行车。

4. 连接你的自行车（可选）

在欢迎页面的 Your bike 下：打开自行车电源，踩踏以唤醒它，将它与任何手机或手表应用断开连接，然后按 Scan for my bike。接着点击列表中的自行车。

• ✅ 已识别（例如 Merach S29）或 ✅ 标准智能自行车（大多数约 2020 年以来生产的自行车）：点击 Use this bike。完成。
• **❔ 尚未识别：**点击 This is my bike，并允许中心向你的助手寻求帮助。然后打开助手并输入 get my bike working。它会与你确认自行车，要求你以几种速度踩踏，生成自行车配置文件（仅包含设置，不含代码），并在你踩踏时运行简短的引导检查。

中心会自行执行安全规则：不重置、不将阻力设为 0，并且只在自行车的阻力范围内进行小幅调整。如果无法确定阻力指令，自行车仍可用于测量功率和踏频。详情：自行车设置。

5. 导入手表数据

在 Today 页面使用 Import watch workout 导入 .fit 或 .tcx 文件。选择对应的计划训练，或选择 ＋ New workout，并在保存前预览。使用手表连接器（例如 COROS）后，你的助手也可以代劳："把我最近的训练导入中心"。

每天

1. 在 Today 页面或与助手一起签到：回答每日问题、说明任何疼痛情况，并按需写一句训练日志。
2. **一起查看“需要关注”列表。**每次签到都会返回一份下周的简短清单，按紧急程度排序：某项训练会违反规则、某项训练超过限制、有一项测试等待答复，或某项训练被漏掉且没有说明原因。助手会提出影响最小的调整，向你展示变更，并在你同意后应用。
3. 按照 Today 页面显示的内容训练，然后反馈训练情况。
4. **每周签到：**花几分钟回顾本周情况。

数字的含义

Hub 会记录事实，并将估算值标明为估算值。

• 记录的训练： 能量数据取自可用的最可靠来源（骑行功率优先；跑步和步行则依次使用距离与坡度，然后是手表）。每份报告都会固定保存时的负荷数据，因此之后更改公式也不会改写你的历史记录。
• **恢复和准备状态取决于你的报告，**而非固定模型。跑步训练会参考你近期的报告和记录的运动暴露量。根据你自身历史数据学习的个性化恢复曲线正在开发中；在完成审核前，默认处于关闭状态。
• 这里的内容都不是伤病预测或医疗许可。 公式、数据来源和假设请参见工作原理和训练指导审查。

你的数据保留在自己的电脑上。 除非你选择与助手分享，或自行发布到 Strava，否则不会上传任何内容。

文档

• 用户指南：介绍每个页面和功能。
• 工作原理：模型、公式和假设。
• 训练指导审查：如何检查计划变更。
• 容量规划、力量训练容量、入门模型。
• 自行车设置、个人音乐和视频。
• 为期 12 周、逐日安排的计划：模拟运动员的赛季（使用较早版本记录）。
• 更新日志。

开发

python tests/run_all.py     # every test; macOS-only tests are skipped elsewhere

每次推送时，GitHub Actions 都会在 Linux、macOS 和 Windows 上运行测试，并使用各系统的设置脚本进行安装。

隐私

你的记录保留在自己的电脑上。Hub 唯一可能发出的外部请求，是查询户外训练时的气温；此功能为可选，默认关闭，只有你主动开启后才会使用：它会将精确到约 10 公里的地点和日期发送给 Open-Meteo，并在本地缓存结果。骑行模式下的摄像头倾斜检测默认关闭，只有你主动开启后才会使用：摄像头只会检测你的头部和肩部位置，视频会留在浏览器中，不会显示、录制或发送任何内容。云端 AI 助手会接收你选择与之分享的内容；本地模型则会将整个对话保留在你的电脑上。

⚠️ 安全

训练数据是估算值，不是医疗建议，也不能预测伤病。开始训练计划前请咨询医生；如果感到疼痛，请停止训练。呼吸急促或心率异常时，应减少所有训练并就医检查。自行车连接会改变真实设备的阻力，请确保你能安全地停止踩踏。

社区

加入 Strava 上的 S-Bike Training Hub 俱乐部：与其他 Hub 用户一起骑行、游泳和跑步，并提出你希望新增的功能。在应用中，Coach 页面顶行的 Community ↗ 会在浏览器中打开俱乐部。问题和 Bug 请提交到 GitHub issues。

致谢和许可证

由 JHarp199345 与 Claude、ChatGPT 共同构建。Hub 的基础包括 OpenStreetMap、Protomaps、MapLibre、BRouter、Mapzen terrain、Three.js、body-highlighter、Kenney、Quaternius 以及许多开源 Python 软件包。完整清单及许可证请见：CREDITS.md。

MIT 许可证。

可选 Ride World 模块

即使没有安装任何游戏，Hub 也能正常运行。Ride 菜单中仍提供免费场景。下载官方签名的模块 ZIP，然后选择 Ride → Add a module。安装前请查看模块请求读取的数据和控制权限。游戏文件单独分发，不包含在此代码仓库中。请参见安全：模块。

Hub 包含非线程版 Godot 4.7.1 浏览器运行时，采用 MIT 许可证。播放模块不需要安装 Godot 编辑器。

Ride World 游戏

Hub 免费使用，无需安装游戏模块。Monster Chase 目前是一款免费的单人扩展包，可选择捐赠：https://jharp199345.itch.io/monster-chase

在 Ride 菜单中，将游戏 ZIP 文件拖到 Add a module，查看其访问权限，然后安装。Monster Chase 的捐赠版无需许可证密钥或付款。该游戏不是独立应用。请将 Hub 更新到 1.12.1 或更高版本，以使用其模块安装程序和运行时。

模块运行前会检查签名和文件指纹。客户记录、密钥和私人设计笔记绝不会包含在 Hub 发布版本中。

支持开发

如果 Hub 或游戏对你有所帮助，可以请我喝杯咖啡，支持我在 Ko-fi 上的创作。支持完全自愿。Hub 上不显眼的帮助徽章会在你使用新模块完成三次骑行后，于骑行结束时显示一次邀请；你可以关闭邀请，或选择 Don’t ask again。计数保存在你的浏览器中。你仍可通过徽章获取帮助和提交反馈；在打开公开 GitHub issue 前，系统会明确显示预览。

• itch.io 上的 Monster Chase
• 我们的 Strava 俱乐部
• Ko-fi