GitHub项目说明 · 非用户反馈2026-08-24

可编程健身插图库：302个动作、三帧素材与框架无关 npm 包

该开源项目将 302 个练习动作整理为每个三帧的透明 SVG 插图，配结构化元数据和类型化 npm 包；开发者可在健身应用代码中通过 API 按名称或部位、器械获取素材。仓库还包含可搜索图库与集成指南，素材沿用 Everkinetic 原图并以 CC BY-SA 4.0 授权。

查看原始信号github:bryllim/workout-guide

目标用户

需要在自研健身、力量训练或体态类应用中展示动作示范图，并希望通过代码管理插图与元数据的开发者（个人开发者或小团队）。

潜在需求

一套可直接安装、通过类型化 API 调用和过滤的动作插图资源，具备结构化元数据且框架无关，便于嵌入不同前端项目。

发生场景

开发者在构建健身应用时，需要在代码里按动作名称（如 push-up）取图、按部位（如 chest）和器械类型（如 bodyweight）筛选练习，并让素材在 React Native、Astro 等框架中都能使用；项目提供了 getExercise、searchExercises、getAssetUrl 等 API 与集成示例。

来源证据

项目提供 npm 包 @bryllim/workout-guide，开发者可通过 getExercise、searchExercises('chest', { equipment: 'bodyweight' }) 和 getAssetUrl 等类型化 API 在代码中获取动作、按部位/器械筛选并取用图片资源。

documentation gallery. [Browse the gallery](https://bryllim.github.io/workout-guide/) · [Read the guide](https://bryllim.github.io/workout-guide/guide/) · [Open the package on npm](https://www.npmjs.com/package/@bryllim/workout-guide) ## Install ```sh npm install @bryllim/workout-guide ``` ```ts import { getExercise, searchExercises, getAssetUrl } from '@bryllim/workout-guide'; const pushUp = getExercise('push-up'); const bodyweightChest = searchExercises('chest', { equipment: 'bodyweight' });

https://github.com/bryllim/workout-guide

为什么值得留意

它把 Everkinetic 的原创素材扩展为带三帧动画、结构化元数据和代码 API 的资源包，是一种可被其他应用直接引用的解决方案；对素材标准化和授权处理有需求的健身应用开发者可能受益。项目刚发布，采用与缺口需进一步验证。

已有方案

Everkinetic 提供的练习动作原图数据（CC BY-SA 4.0）

可能延伸 · 模型推测

将同一套素材与元数据打包成面向内容网站的嵌入组件
扩展多语言动作要点与组间休息文案，服务训练计划生成类产品

目前未知

该信号仅为项目 README，不能证明独立用户采用、需求普遍或缺口存在。
README 中未提及项目当前的下载量、使用案例或用户反馈，作者可能是唯一使用者。
Everkinetic 素材与扩展插图的许可边界（CC BY-SA 4.0）对商业应用的影响未在材料中说明。

继续核实

健身应用开发者当前如何获取动作插图：自绘、购买素材或使用开源数据？
workout-guide 的 API 与素材是否已在实际应用中被采用，采用者遇到了什么限制？
开发者是否还缺少其他语言、动作类型或训练阶段的素材与元数据？
该项目仓库的 issues/discussions 是否出现了具体功能请求或使用障碍？

主题词

exercise illustrationsworkout appsexercise metadatacode integration