找回密码
立即注册
搜索
发回帖 发新帖

6488

积分

0

好友

824

主题
发表于 前天 10:28 | 查看: 8| 回复: 0

不知道你有没有这种经历:收藏了一堆健身教程,真正想找某个动作时,还是得重新搜。名字记不住,器械对不上,点开视频还要拖进度条。如果想做一个自己的健身小程序,麻烦更多——动作名称、图片、文字说明,全得一点点整理。

最近在 云栈社区 看到不少人聊到这个痛点,正好 GitHub 上有个项目把这事解决了大半。这个叫 exercises-dataset 的 开源 项目,把 1,324 个健身动作 整理成了一份资料库,动作演示、肌肉分类、器械信息和多语言说明,都放在了一起。

exercises-dataset GitHub 仓库页面

项目简介

exercises-dataset 是一套结构化健身动作数据,也是训练记录应用 LogPress 使用的动作数据层。

说得通俗一点,它像一本能被程序直接读取的“健身动作字典”。每个动作都有固定编号、名称、训练部位、目标肌肉、所需器械,还有缩略图和 GIF 动图。

杠铃卧推动作动画演示

杠铃卧推 · 动作资料库中的演示素材 © Gym visual — https://gymvisual.com/

普通用户可以用它查动作,开发者可以拿它搭动作库、训练记录页面或健身应用原型。不过它本身提供的是动作资料,训练计划和推荐逻辑还需要另外设计。

动作能动起来,比只看名字直观

看到“哑铃弯举”这几个字,你可能有印象;换成一个不熟悉的动作,单靠名称就很难理解。

这个项目给每个动作配了 180×180 的缩略图和动画 GIF。列表里先看小图,点进详情再看运动过程,文字和演示能对得上。

哑铃弯举动作动画演示

哑铃弯举 · GIF 保留动作过程 © Gym visual — https://gymvisual.com/

它的图片尺寸不大,更适合动作卡片、资料索引和应用列表。想拿来做高清海报、全屏教学视频,就不太合适了。

按器械和肌肉筛选,少翻很多页

如果手里只有一副哑铃,面对上千个动作挨个找,肯定不现实。项目自带的浏览页面支持按类别、器械和目标肌肉筛选,也能搜索动作。先选器械,再缩小到想了解的部位,查资料的路径就清楚多了。

器械分类 动作数量
自重 325
哑铃 294
绳索器械 157
杠铃 154
弹力带 54

这里有个小细节值得注意:“自重”不代表完全不需要器械。 比如引体向上属于自重动作,但仍然要用到单杠。筛选完,还是得看具体动作。

引体向上动作动画演示

引体向上 · 自重分类下的动作示例 © Gym visual — https://gymvisual.com/

中文说明也有,不用对着英文硬猜

当前数据文件包含中文、英文、西班牙文等 10 种语言 的动作说明。打开动作详情,可以切换语言阅读。

除了整段文字,数据里还提供拆好的步骤数组。开发者做手机页面时,就能把说明一条条展示出来,阅读起来比挤成一大段舒服。

同一个动作的不同语言说明放在同一条记录里。切换语言时,不用重新找另一份文件,也不用自己把十份资料重新配对,这对做多语言版本的应用很方便。

需要分清的是,多语言主要体现在动作说明上,不能理解成所有动作名称和界面都已经完整汉化。正式做中文产品时,名称、术语和译文仍然值得校对一遍。

做健身应用,省掉从零整理资料的功夫

对开发者来说,真正省事的是这些信息已经按统一字段整理好了。主数据放在 data/exercises.json,程序读取后就能筛选、分组、展示。仓库还提供字段规范,方便检查数据格式,后续添加动作也有章可循。

配套的 setup.html 更像一个接入向导:可以查看数据库建表方案、生成导入 SQL,还有多种语言的接口调用示例。

比如先做一张动作卡片:标题放名称,下方显示器械和目标肌肉,详情页再放动图与中文步骤。把资料展示跑通后,再添加收藏、训练记录等功能,整个开发思路就有了落点。

它也准备了让 AI 辅助生成后端的提示词模板。不过这些是开发辅助材料,实际 API 仍然需要自己搭建、测试和部署。

快速下载、使用

不写代码也能先看起来。在项目页面点击 Code → Download ZIP,下载后完整解压,双击根目录的 index.html,就能用浏览器查看动作库。

记得保留 images 和 videos 文件夹与页面的相对位置,单独拷走 HTML 会影响图片和动图显示。

会用 Git 的朋友,也可以直接下载整个仓库:

git clone https://github.com/hasaneyldrm/exercises-dataset.git

有一点要提前说清:代码和非媒体数据采用 MIT 许可,动作图片与 GIF 的版权属于 Gym visual,另有授权条款。把素材放进自己的产品前,需要确认适用许可,保留版权标识,不能把仓库开源等同于图片随便商用。

最后聊两句

exercises-dataset 的价值,在于把散落的动作资料整理成了能查、能筛选、能接进程序的格式。

它不会替你判断该练什么、练多重,也不能代替动作指导。但如果你想搭一个自己的动作资料库,或者正准备做健身工具,这份现成的数据能省下不少整理时间。

先打开浏览页面,找几个熟悉的动作看看。能不能用得上,很快就有答案。

项目地址: https://github.com/hasaneyldrm/exercises-dataset




上一篇:开源AI剪辑工具Concat:离线字幕与抠图,免费替代剪映
下一篇:论文研究假设怎么写:主效应H1与机制H2、H3该分列还是合并
您需要登录后才可以回帖 登录 | 立即注册

手机版|小黑屋|网站地图|云栈社区 ( 苏ICP备2022046150号-2 )

GMT+8, 2026-10-25 04:11 , Processed in 0.077758 second(s), 42 queries , Gzip On.

Powered by Discuz! X3.5

© 2025-2026 云栈社区.

快速回复 返回顶部 返回列表