openGym动作库使用指南：1324个带动画演示的动作如何搜索与筛选

openGym动作库使用指南：1324个带动画演示的动作如何搜索与筛选

【免费下载链接】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 是一款自托管的健身与体重追踪应用，内置1324 个带动画演示的健身动作库，支持模糊搜索、按身体部位/器械筛选，还能在肌肉图上直观查找动作。本文带你快速上手这个动作库的搜索与筛选功能，从新手到熟练只需 5 分钟。

🏷️ openGym 动作库：1324 个动作，全部带动画演示

打开动作库（Exercises）页面，你会看到顶部标注着"1324 exercises with animations"—— 每一个动作都配有 GIF 动画演示，让你在实际训练前看清标准姿势。

动作库的核心数据来自 api/coach/core/library-data.js，前端展示逻辑在 frontend/src/views/Library.jsx。按身体部位统计，覆盖非常全面：

身体部位	动作数量	身体部位	动作数量
上臂（肩/肱二/肱三）	292	上腿（股四头/腘绳肌）	227
背部	203	腰腹	169
胸部	163	肩部	143
小腿	59	下臂（前臂）	37
有氧	29	颈部	2

🔍 动作搜索技巧：打错字也能找到

顶部的搜索框是整个动作库最强大的功能，其搜索逻辑实现在 frontend/src/lib/exercises.js，有 4 个实用特性：

• 多词顺序不限：输入press bench同样能命中 "Bench Press"，词序随便写；
• 容错拼写：长单词允许一个字母的错别字（如dumbell能找到 dumbbell），短词则保持精确匹配避免误报；
• 忽略重音：elevação和elevacao视为同一关键词，多语言用户友好；
• 多语言命中：搜索时同时匹配英文名、当前语言的翻译名、目标肌肉、器械、身体部位甚至描述。

搜索时右侧会实时显示剩余匹配数量，不用滚动到底再确认。

🎯 按身体部位筛选：9 个部位一键切换

搜索框下方是一排身体部位（Body Part）筛选标签，点击 "All" 查看全部，点击 "Chest"、"Back"、"Waist" 等立即过滤。切换部位时，之前选中的器械筛选会被保留，不会让你白选。

🏋️ 按器械筛选：只显示你家里/健身房有的动作

如果你在家训练，可以只显示自身体重和哑铃动作：

1. 在设置中创建"器械配置"（Equipment Profile），勾选你拥有的器械（如哑铃、弹力带、壶铃）；
2. 回到动作库，页面会自动显示"Showing what you have in ... "，只列出你练得了的动作；
3. 随时点 "Show all equipment" 切回全量视图。

配置逻辑在 frontend/src/lib/equipment.js。按器械统计，动作库前几位是：自身体重 325 个、哑铃 294 个、绳索 157 个、杠铃 154 个、固定器械 81 个、弹力带 54 个、史密斯机 48 个、壶铃 41 个……

🧠 肌肉地图：想知道练哪块肌肉，看图就懂

不想猜动作名称？点动作库右上角的"By muscle"按钮，进入肌肉探索页（frontend/src/views/Muscles.jsx）：人体图上点击任意一块肌肉，直接列出所有训练它的动作，并标注主要/次要肌群。这是新手安排训练计划最高效的入口。

📋 动作详情页：动画演示、最佳成绩与 1RM 估算

点击任意动作会打开详情卡片（frontend/src/sheets.jsx），内容包括：

• GIF 动画演示：标准动作全程可视化；
• 部位与肌群标签：身体部位、目标肌群、次要肌群一目了然；
• 你的最佳成绩：练过的动作会显示个人最佳（PR）重量和上次训练记录；
• 1RM 估算器：输入一组重量和次数，用 Epley 公式估算最大力量；
• How to 分步说明：动作要领分步骤列出，支持中文、德文、法文等 12 种语言（指令源文件在 frontend/src/instr/）。

点"Add to my plan"即可把动作加入训练计划。

⭐ 收藏常用动作 + 创建自己的动作

• 详情页点星星图标收藏动作，收藏会永远浮现在列表最顶部；
• 列表顶部的"Create your own exercise"让你自建动作，还能上传自己的照片、GIF 或短视频作为演示（位置信息会在设备上自动剥离）；
• 自定义动作与内置动作共享同一套搜索和筛选。

💾 你的数据，你的服务器

所有训练记录、收藏、自定义动作都存储在你自己的服务器上，手机与笔记本通过增量同步保持一致，冲突时自动合并（docs/diagrams/sync.png）：

一条docker compose up即可部署（参考 docs/SELF_HOSTING.md），无需账号、无订阅、无遥测。

✅ 总结：5 步快速上手

1. 打开动作库，用搜索框输入关键词（顺序、拼写都不必精确）；
2. 用身体部位标签粗筛，用器械配置细筛；
3. 不会找动作名就去 "By muscle" 肌肉地图上点；
4. 进详情页看动画演示和分步说明，点 "Add to my plan" 入库；
5. 星标收藏高频动作，下次一秒找到。

【免费下载链接】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