Workout Guide 是一个专为开发者、健身应用构建者及内容创作者设计的免费资源库。它收录了 302 种运动项目,共计 906 张透明背景 SVG 动作图。每个动作均通过“三格连续姿势”清晰展示操作流程,涵盖重量训练、有氧运动、伸展及活动度训练等类型。

核心特色
- 标准化视觉风格:所有插图规格统一、线条简洁,适合嵌入各类 UI 设计。
- 三格分解动作:每个动作提供起始、中间、结束三个关键帧,直观表达动作轨迹。
- 精细分类与元数据:
- 器材:杠铃 (Barbell)、哑铃 (Dumbbell)、徒手 (Bodyweight) 等。
- 肌肉群:胸部 (Chest)、腿部 (Legs)、核心 (Core) 等。
- 动作类型:重复次数类 (Reps)、拉伸类等。
- 多种获取方式:支持网页直接下载、CDN 嵌入以及 npm 包调用。
使用指南
1. 网页浏览与下载
- 访问地址:进入 Workout Guide 网站,点击导航栏的 “Exercises”。
- 搜索与筛选:
- 使用顶部搜索栏输入英文动作名称(如 “Squat”)。
- 利用右侧筛选器按器材、肌肉群或运动类型缩小范围。
- 查看详情:点击卡片进入详情页(如“保加利亚分腿蹲”),查看主要/次要肌肉群、所需器材等元数据。
- 获取图片:
- 下载 SVG:点击每格动作下方的 “Download” 按钮保存透明背景 SVG 文件。
- CDN 嵌入:复制页面提供的 jsDelivr CDN 链接,直接嵌入网页或简报中,无需本地存储。
2. 开发者集成 (npm)
对于需要批量调用或动态渲染的项目,可通过 npm 安装完整资源包:
npm install @bryllim/workout-guide
功能亮点:
- 内置 TypeScript 类型定义。
- 支持 ESM / CommonJS 双格式。
- 提供便捷函数:
searchExercises()、getExercise()、getAssetUrl()。 - 兼容 React Native、Expo 等移动端开发环境。
授权协议:CC BY-SA 4.0
使用前请务必注意其授权条款,这比常见的 CC0 或 MIT 更为严格:
- 署名 (BY):商用或再散布时必须标示出处。
- 相同方式共享 (SA):基于此资源创作的衍生作品必须采用相同的 CC BY-SA 4.0 协议发布。
建议:若计划用于商业产品,请仔细评估“相同方式共享”条款对项目开源策略的影响,并确保正确标注来源。
注意事项
- 语言限制:网站界面、动作名称及分类标签均为英文,搜索时建议使用英文关键词以获得最准确结果。
- 静态格式:仅提供静态 SVG 插画,不包含动画或视频。如需动态效果,需结合前端动画库或 AI 工具进行后期处理。
- 无需注册:网页浏览和下载无需账号,但 npm 集成需要基本的开发知识。