openGym年度训练热力图：可视化你的坚持程度
【免费下载链接】openGymSelf-hosted gym & body-weight tracker — plan routines, log workouts (supersets, warm-ups, cardio), see which muscles are trained, fatigued or detrained, import from FitNotes/Strong/Hevy, passkey login. Your data, your server.项目地址: https://gitcode.com/GitHub_Trending/op/openGym
openGym 是一个自托管的健身与体重追踪工具，其中最直观的「年度训练热力图」功能，能把过去 12 个月的每一次训练渲染成 GitHub 贡献图风格的绿色方块矩阵——训练时间、训练量一目了然，让你一眼看清自己的坚持程度。数据全部保存在你自己的服务器上，配合 passkey 登录和多设备同步，隐私与便利性兼得。
什么是训练热力图？为什么值得看
热力图（Heatmap）借鉴了程序员熟悉的「每日贡献图」：横轴是 52 周的列，纵轴是一周 7 天，每个小方格代表某一天，颜色越深代表训练投入越多。
在 openGym 的统计页里，这张图覆盖最近 12 个月，并且提供了两种着色维度：
| 指标 | 含义 | 适合回答的问题 |
|---|---|---|
| ⏱ 时间（Time） | 当天累计训练时长（分钟） | 「我每周到底花了多少时间在健身房？」 |
| 📊 体积（Volume） | 当天完成的总训练量（重量 × 次数 × 组数） | 「我的训练强度是否在稳步提升？」 |
颜色分 5 档（从几乎不可见到最亮的主题色），档位不是固定阈值，而是按你自己数据的四分位数动态计算的——对新人友好，不会出现「怎么永远是深色」的错觉。
快速上手：3 步找到你的热力图
- 部署 openGym：只需 Docker Compose 一条命令（
docker compose up），详见 docs/SELF_HOSTING.md。 - 录入训练：完成任意一次训练记录，热力图当天即会点亮。也可以从 FitNotes、Strong、Hevy 一键导入历史数据，一次性填满一整年的格子。
- 打开统计页：底部导航进入Stats（统计），第一张卡片就是「Activity — last 12 months」年度训练热力图。
切换指标只需点一下卡片顶部的Time / Volume分段按钮，选择会持久保存（状态字段heatmapMetric，见 frontend/src/store/useStore.js）。
热力图交互细节：点一下方块会发生什么
这张图不是静态装饰，每个点亮的方块都可以点击：
- 当天只练了一次→ 直接打开该次训练详情，逐组查看重量与次数；
- 当天练了多次→ 打开当日日历视图，列出全部训练记录。
悬停（或长按）方块还会显示当天摘要：日期、训练次数、总分钟数、总训练量。
实现上，热力图聚合逻辑非常直观：按训练日期把每次训练的时长与重量累加，再取 25% / 50% / 75% 分位数划分色阶，核心代码见 frontend/src/components/Heatmap.jsx；它被嵌入统计页的渲染位置在 frontend/src/views/Stats.jsx。移动端横滑查看 52 周、默认滚动到最新一周，细节样式定义在 frontend/src/index.css。
热力图之外：统计页的「坚持三件套」
单看坚持天数还不够，openGym 在同一页面补齐了另外两个视角：
- 🔥 连续周数（Week streak）：顶部磁贴直接显示你已连续训练多少周——断档一眼可见，是催更利器；
- 🏋 肌肉平衡图（Muscle balance）：同一套 5 档色阶被复用为人体肌肉地图，按「练了多少 / 还在恢复 / 已退训」三种模式着色，回答「练得勤 ≠ 练得全」；
- 📈 体重曲线：30 天、3 个月、1 年全历史可切换，配合目标线观察体脂期与增肌期。
这些视图共享同一套状态存储与历史计算模块（如 frontend/src/lib/history.js 的streakWeeks），所以数据永远互相一致。
数据归属：为什么热力图在你自己的服务器上
市面上很多健身 App 把训练数据锁在云端；openGym 的架构图显示，API 层（Node + WebAuthn）直接把数据写进你服务器上的./dataJSON 文件，热力图、连续周数、肌肉疲劳度全部由前端从这份数据本地计算——没有遥测、没有订阅，换设备时用 passkey 登录 + 一次性配对码即可无缝迁移。整体架构可参考 docs/diagrams/architecture.png，双端同步的合并策略见 docs/diagrams/sync.png。
小结：用一张图对抗训练倦怠
年度训练热力图的价值不在于「好看」，而在于把模糊的坚持变成可数、可比、可回看的方块：
- 空档一目了然——哪几周掉链子了，比翻记录快得多；
- 时间 / 体积双维度——坚持的「量」与「强度」分开看，避免只打卡不进步；
- 点击穿透到单次训练——从全年视角一键下钻到某一天的每一组。
如果你也厌倦了把健身数据交给别人的服务器，openGym 的自托管方案 + 年度训练热力图，是把「我这一年练得怎么样」这个问题回答得最完整的方式之一。
更多文档可以从 docs/README.md 开始阅读，功能演进记录见 CHANGELOG.md。
【免费下载链接】openGymSelf-hosted gym & body-weight tracker — plan routines, log workouts (supersets, warm-ups, cardio), see which muscles are trained, fatigued or detrained, import from FitNotes/Strong/Hevy, passkey login. Your data, your server.项目地址: https://gitcode.com/GitHub_Trending/op/openGym
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
