如果你正在编写课程待做清单(CSV),需要查找动作的 Name/ID 来填入 Ref_Item 列,但还没有下载模板,请前往《LeaScript:课程层——从‘编排’到‘商业化’》下载 csv 模板。
在 LeaScript 的分层架构中,动作库属于第一层(原子层)。它是整个系统的“标准动作单元”仓库,每个 <action_tpl2> 块对应一个可复用的标准动作。
本文是 LeaScript 系列的第三篇。前两篇分别介绍了:
- 《LeaScript:面向端侧/视觉跟练的动作脚本规范》:讲解原子层(动作库)与序列层(操)的完整语法。
- 《LeaScript:课程层——从“编排”到“商业化”》:讲解顶层(课程)的编排与商业化。
本篇专门聚焦动作库本身,回答两个问题:LeaScript 提供了哪些动作?这些动作如何被组织和复用?
一、动作库文件:action_tpl2s.cfg
动作库存储在一个独立的配置文件 action_tpl2s.cfg 中。文件内由多个 <action_tpl2> 块组成,每个块代表一个标准的、可复用的独立动作。
每个 <action_tpl2> 包含以下核心字段:
| 字段名 | 必需 | 数据类型 | 说明 |
| id | 是 | 字符串 | 全局唯一标识,命名规则见下文。 |
| name | 是 | 字符串 | 动作的中文名称,用于编辑器界面和语音播报。 |
| msg | 是 | 字符串 | 动作开始前的标准开场/教学语音提示。 |
| body_part | 否 | 字符串 | 身体部位标签(多值,分号分隔)。 |
| movement_type | 否 | 字符串 | 动作类型标签(多值,分号分隔)。 |
| reference | 否 | 字符串 | 演示视频 URL。 |
| <track_pose> | 是 | 子块 | 姿态判断逻辑。 |
| <task> | 是 | 子块 | 计时或计次任务。 |
关于 body_part 与 movement_type:
这两个字段是 LeaScript 建议增加的语义元数据,用于支撑两个目标:
- AI 语义:AI 生成操时需要理解“这个动作练哪里”、“这个动作属于什么类型”。
- Launcher 检索:UP 主在编辑器里找动作时,可以按部位和类型快速过滤。
它们不参与姿态判定,只作为分类标签存在。
二、动作 ID 命名规范
动作库中的 id 是全局唯一标识。命名规则如下:
2.1 字符与长度限制
- 仅允许使用英文字母、数字(0-9)以及下划线 _。
- 最大长度不得超过 40 字节。
2.2 后缀规则
动作 ID 必须以下列后缀之一结尾,以标识该动作的任务类型:
| 后缀 | 含义 | 示例 |
| _time | 计时动作(type="time_counter") | plank_time、cobra_stretch_time |
| _rep | 计次动作(type="rep_counter") | pushup_rep、dead_bug_rep |
| _setup | 定位动作(is_setup=true) | plank_setup、pushup_setup |
为什么会有 _setup?
因为定位状态本质上也是一个姿态状态,它同样需要写 <track_pose> 来检测用户是否站好。定位状态和普通姿态状态的区别在于:
- 定位状态带有 is_setup=true 标记。
- 定位状态不计入做操时长。
- 定位状态通常作为一套操的第一个姿态状态。
由于定位状态的判定逻辑在不同动作之间高度相似(都是“全身入镜、画面居中、朝向正确”),因此动作库预先提供了几个通用的定位模板(如 plank_setup、pushup_setup、dead_bug_setup、standing_full_setup 等),供不同场景直接复用。
2.3 关于“同一套操只能有一个定位状态”的约定
在编写一套操时,不要让这套操出现不同定位要求的动作。例如:
- 允许:plank_setup(躺卧) + plank_time(躺卧) + cobra_stretch_time(躺卧)
- 禁止:plank_setup(躺卧) + standing_clasp_stretch_time(站姿)
因为用户一旦在定位状态摆好了手机和站位,就不应该在操进行到一半时再重新摆手机。如果需要同时包含站姿和躺卧的动作,应该拆分成两套操。
三、跟练前:如何摆手机
在进入任何动作的定位模板之前,用户需要先完成一次物理环境的基础校准。这是所有视觉姿态判定的前提,也是跟练体验中最先遇到的问题:如果手机没摆对,系统连人在哪都看不清,更谈不上纠正动作。
LeaScript 将“如何摆手机”拆解为三个递进步骤,并在界面上给予实时的反馈。

- 左侧边栏 -87.48°:反映手机垂直地面的加速度计倾角,绿色表示达标。*
- 画面网格:5 条蓝色参考线,用于辅助用户对齐垫子,确保镜头与身体平行。*
- 绿色文字:定位状态下的姿态点实时判定,直观展示“画面占比”、“居中”和“空间留白”是否合格。*
3.1 第一步:保证手机垂直地面
系统通过手机内置的加速度计实时测量设备的倾斜角。界面上会显示一个角度值(如图 1 左侧的 -87.48°),当倾斜角接近垂直时,数值与指示框会变为绿色,表示达标;偏离时显示红色并提示用户调整。这一步不依赖摄像头画面,是纯传感器校准,用来确保后续所有姿态点不会被“拍歪”。
3.2 第二步:保证镜头与身体平行
手机垂直之后,下一步是让镜头平面与用户的身体平面平行。LeaScript 会在画面中渲染 5 条蓝色参考线(如图 1 画面中的网格)。用户不需要理解“光轴”“透视”等概念,只需移动支架,让现实中瑜伽垫的长边与画面中的参考线保持平行即可。这一步决定了画面中的水平与垂直方向是否与真实世界一致,是姿态角度计算不产生系统性偏差的关键。
3.3 第三步:确保拍到必要的姿态点
前两步只解决“手机摆得正不正”,第三步解决“人站得对不对”。进入定位状态后,系统会根据当前动作所需的姿态点,自动判断用户的站位是否满足要求(如图 1 右侧绿色的“全身画面占比”、“左髋水平居中”等判定数据),并通过语音与画面提示引导用户向前、向后或左右移动。
这一步正是“定位模板”(_setup 动作)所负责的内容。 动作库预置了多种定位模板,覆盖躺卧、站姿髋及以上、站姿全身等典型场景,供不同的动作直接复用。
小结:第一步与第二步是设备姿态的校准,第三步是用户站位的校准。三步全部通过,才进入正式的动作检测阶段。以下我们将详细介绍动作库中预置的定位模板(对应第三步的校准)。
四、动作库总览(表格一:定位模板)
说明:下表列出动作库中当前提供的定位模板。UP 主在编写新操时,可以直接从这些模板中选择一个作为第一状态。
在做“横向操”(躺卧/俯卧)时,手机放右侧,距离身体约2米,高度距地面约50厘米(大约一张床的高度)。
对身体横向类动作,像新月式、平板支撑、眼镜蛇式、死虫式、侧平板等,手机右侧摆放,脸朝身体前方。并且,除平板支撑、俯卧撑外(如果是垫上,也不建议穿),强烈建议不要穿鞋。
| 名称/ID | 开场提示 | 适用场景 | |
| 1 | 定位(平板撑)/plank_setup | xxx训练。手机摆在右侧,镜头跟身体平行,对准肚脐附近,放好手机后,原地趴下,保持不动,等待定位完成。 | 躺卧。手机放右侧,镜头对准肚脐附近。 |
| 2 | 定位(俯卧撑)/pushup_setup | xxx训练。手机摆在右侧,镜头跟身体平行,对准肩膀附近,放好手机后,原地趴下,做出手臂伸直到最高点姿势,等待定位完成。 | 躺卧。手机放右侧,镜头对准肩膀附近。 |
| 3 | 定位(死虫式)/dead_bug_setup | xxx训练。手机摆在右侧,镜头跟身体平行,对准肚脐附近,放好后,原地躺下,左手向后伸直,等待定位完成。 | 躺卧。手机放右侧,做操时,可容下手向后伸平。如果操中没有平板支撑、俯卧撑动作,建议用它。 |
| 4 | 定位(站姿髋及以上+上举)/standing_hips_raised_arms_setup | xxx训练。请将手机放正前方,摆好手机后,请站到画面中央,保持身体正对镜头,等待定位完成。 | 站姿。手机放正前方,要求髋、及以上必须入画,会留出上举、手腕自然下垂空间。如果操中动作都不须要判断膝盖以及下面姿态点,建议用它。 |
| 5 | 定位(站姿全身入镜)/standing_full_setup | xxx训练。请将手机放正前方,摆好手机后,请站到画面中央,保持身体正对镜头,等待定位完成。 | 站姿。手机放正前方,要求全身必须入画。如果操中有动作须要看到全身,建议用它。 |
五、动作库总览(表格二:全部动作)
说明:下表列出动作库中当前提供的全部动作。一旦有动作更新,会尽快更新本表格。
| 名称/ID | 开场提示 | 任务 | 身体部位 | 动作类型 | 演示 | |
| 1 | 平板支撑/plank_time | 60秒平板撑。 | 60秒、 纯满足时长、首尾密集报时 | 核心/腹部 | 力量 | https://www.bilibili.com/video/BV1ettR6SE7Y |
| 2 | 俯卧撑/pushup_rep | 8个俯卧撑。 | 8次, 向下/向上 | 上肢; 核心/腹部 | 力量 | https://www.bilibili.com/video/BV1NZ4y1P7Et |
| 3 | 死虫式/dead_bug_rep | 屁股向脚尖方向微微滑动,把腰压平贴地,抬左脚,举右手。 | 10次, 抬左脚/抬右脚 | 核心/腹部 | 力量 | https://www.bilibili.com/video/BV1cv3E6HEGy |
| 4 | 侧支撑转体触脚/side_plank_crunch_toe_touch_left_rep | 侧支撑,撑住身体,收紧核心,不要塌腰。 | 10次, 侧支撑/触脚 | 核心/腹部 | 力量 | https://www.bilibili.com/video/BV1Xdg564Ehf |
| 5 | 平板支撑髋部转体/plank_hip_dips_rep | 做出平板支撑姿势,双脚并拢,但弓腰,让正面转向摄像头。 | 10次, 转正面/转背面 | 核心/腹部 | 力量 | https://www.bilibili.com/video/BV1Xdg564Ehf |
| 6 | 反向卷腹/reverse_crunch_rep | 双手放松,伸腿、双膝并拢,屈膝抬平,第二阶段用下腹发力卷起骨盆。 | 10次, 放平/向上卷 | 核心/腹部 | 力量 | https://www.bilibili.com/video/BV1Xdg564Ehf |
| 7 | 交叉卷腹/cross_crunch_rep | 双手抱头,先屈左腿,右手肘带动右侧腰向左侧卷,碰左膝。 | 10次, 屈左腿/屈右腿 | 核心/腹部 | 力量 | https://www.bilibili.com/video/BV1Xdg564Ehf |
| 8 | 眼镜蛇式拉伸/cobra_stretch_time | 俯卧垫上,双腿贴地,双手撑起上身,腹部微离地,眼睛看天。 | 30秒 纯满足时长、首尾密集报时 | 背/腰 | 拉伸 | https://www.bilibili.com/video/BV1ettR6SE7Y |
| 9 | 站姿十指交叉上举拉伸/standing_clasp_stretch_time | 十指相扣,手臂向上延展,抬头,眼睛看手臂。 | 10秒 严格满足时长、全程密集报时 | 肩, 上肢 | 拉伸 | https://www.bilibili.com/video/BV1oC4y1r7dh |
| 10 | 抱肩下颚贴胸拉伸/cross_arm_neck_stretch_time | 双手在体前,交叉相抱,含胸,下颚向下贴胸骨。 | 10秒 严格满足时长、全程密集报时 | 颈 | 拉伸 | https://www.bilibili.com/video/BV1oC4y1r7dh |
| 11 | 右侧侧颈拉伸手下垂/neck_side_stretch_right_arm_down_time | 抬起右侧手臂,环绕头部,放在左侧太阳穴,把头部向右侧作牵拉。 | 10秒 严格满足时长、全程密集报时 | 颈 | 拉伸 | https://www.bilibili.com/video/BV1oC4y1r7dh |
| 12 | 左侧侧颈拉伸手下垂/neck_side_stretch_left_arm_down_time | 抬起左侧手臂,环绕头部,放在右侧太阳穴,把头部向左侧作牵拉。 | 10秒 严格满足时长、全程密集报时 | 颈 | 拉伸 | https://www.bilibili.com/video/BV1oC4y1r7dh |
| 13 | 抱头颈后对抗/head_press_back_time | 双手交叉抱头,双肘向后打开,头后仰看天,和双手轻轻对抗。 | 10秒 严格满足时长、全程密集报时 | 颈 | 力量, 拉伸 | https://www.bilibili.com/video/BV1oC4y1r7dh |
| 14 | 右侧侧颈拉伸手背后/neck_side_stretch_right_arm_back_time | 左手放于后腰,固定肩膀;抬起右侧手臂,放在左侧太阳穴,把头部向右侧作牵拉。 | 10秒 严格满足时长、全程密集报时 | 颈 | 拉伸 | https://www.bilibili.com/video/BV188gr6FEeV |
| 15 | 左侧侧颈拉伸手背后/neck_side_stretch_left_arm_back_time | 右手放于后腰,固定肩膀;抬起左侧手臂,放右侧太阳穴,把头部向左侧作牵拉。 | 10秒 严格满足时长、全程密集报时 | 颈 | 拉伸 | https://www.bilibili.com/video/BV188gr6FEeV |
| 16 | 靠墙天使滑动/wall_angel_slide_rep | 背靠墙站立,后脑勺、背部、臀部贴近墙面,双臂屈肘90度贴近墙面,第二阶段时缓慢上举。 | 8次 屈肘/上举 | 肩 | 灵活性/热身 | https://www.bilibili.com/video/BV188gr6FEeV |
| 17 | 动态臀桥/glute_bridge_dynamic_rep | 仰卧屈膝,双手放平,双脚打开,与肩同宽,臀部发力向上顶起。 | 10次 顶起/放下 | 髋/臀, 核心/腹部 | 力量 | https://www.bilibili.com/video/BV1kSbB6sEbz |
| 18 | 仰卧触膝卷腹/touch_knee_crunch_rep | 屈膝踩地,双手伸向膝盖,用腹部卷起,控制核心不松。 | 10次 卷起/还原 | 核心/腹部 | 力量 | https://www.bilibili.com/video/BV1Z4bH6NEyp |
| 19 | 卷腹手臂拍击/crunch_arm_pulse_rep | 屈膝抬腿,卷起上身,下背部贴住垫子,快速拍击。 | 10次 拍击/后放 | 核心/腹部 | 力量 | https://www.bilibili.com/video/BV1Z4bH6NEyp |
| 20 | 仰卧屈膝抬腿/supine_leg_lift_rep | 屁股向脚尖方向微微滑动,把腰压平贴地,屈膝抬起,小腿放平。 | 10次 抬腿/下放 | 核心/腹部 | 力量 | https://www.bilibili.com/video/BV1Z4bH6NEyp |
| 21 | 体前体侧交替侧卷腹/side_plank_front_side_crunch_left_rep | 左手撑地,右脚伸到体前,右手向前去触碰右脚尖,呼气收腹。 | 10次 体前/体侧 | 核心/腹部 | 力量 | https://www.bilibili.com/video/BV1Z4bH6NEyp |
| 22 | 仰天开合/neck_open_close_lookup_rep | 双手握拳屈肘。 | 12次 合/开 | 颈 | 灵活性/热身 | https://www.bilibili.com/video/BV1EK411h7r6 |
| 23 | 触肩旋颈/neck_rotation_shoulder_touch_rep | 右手搭左肩,头向左后方旋转,感受颈侧拉伸。注意,旋转颈椎时要缓慢。 | 6次 向右看/各左看 | 颈 | 灵活性/热身 | https://www.bilibili.com/video/BV1EK411h7r6 |
| 24 | 游禽翘首/bird_stretch_neck_up_rep | 双臂伸直向上举,抬头看天花板,感受颈前拉伸。 | 12次 上举/下放 | 颈 | 拉伸 | https://www.bilibili.com/video/BV1EK411h7r6 |
| 25 | 环臂摆腰伸右臂/waist_swing_arm_circle_right_rep | 朝向右,身体微转向镜头,不要完全侧对,左脚向后退。 | 10次 环臂/摆腰 | 背/腰, 髋/臀 | 灵活性/热身 | https://www.bilibili.com/video/BV1yP411z7iF |
| 26 | 环臂摆腰伸左臂/waist_swing_arm_circle_left_rep | 朝向左,身体微转向镜头,不要完全侧对,右脚向后退。 | 10次 环臂/摆腰 | 背/腰, 髋/臀 | 灵活性/热身 | https://www.bilibili.com/video/BV1yP411z7iF |
| 27 | 侧踢迎掌/side_kick_palm_touch_alternating_rep | 右腿向侧后方踢,右手去迎右脚掌。 | 10次 踢右脚/踢左脚 | 下肢 | 灵活性/热身 | https://www.bilibili.com/video/BV1yP411z7iF |
| 28 | 挤腰空踏右/waist_squeeze_air_step_right_rep | 朝向右,身体微转向镜头,不要完全侧对,抬右脚。 | 10次 挤腰/空踏 | 背/腰, 髋/臀 | 灵活性/热身 | https://www.bilibili.com/video/BV1yP411z7iF |
| 29 | 挤腰空踏左/waist_squeeze_air_step_left_rep | 朝向左,身体微转向镜头,不要完全侧对,抬左脚。 | 10次 挤腰/空踏 | 背/腰, 髋/臀 | 灵活性/热身 | https://www.bilibili.com/video/BV1yP411z7iF |
| 30 | 新月式左脚在前/crescent_moon_pose_left_time | 左脚在前屈膝,右膝跪地,骨盆下沉,看正前方,感受髋部前侧拉伸。 | 30秒 | 髋/臀 | 拉伸 | https://www.bilibili.com/video/BV14Tb96uEk7 |
| 31 | 新月式右脚在前/crescent_moon_pose_right_time | 右脚在前屈膝,左膝跪地,骨盆下沉,看正前方,感受髋部前侧拉伸。 | 30秒 | 髋/臀 | 拉伸 | https://www.bilibili.com/video/BV14Tb96uEk7 |
| 32 | 半神猴式左脚在前/half_hanumanasana_left_time | 左腿向前伸直勾脚,右膝跪地,身体从髋部向前折叠。 | 30秒 | 腿; 髋/臀 | 拉伸 | https://www.bilibili.com/video/BV14Tb96uEk7 |
| 33 | 半神猴式右脚在前/half_hanumanasana_right_time | 右腿向前伸直勾脚,左膝跪地,身体从髋部向前折叠。 | 30秒 | 腿; 髋/臀 | 拉伸 | https://www.bilibili.com/video/BV14Tb96uEk7 |
| 34 | 鸟狗式伸右手左脚/bird_dog_right_arm_left_leg_rep | 四肢跪地,右手向前伸,左腿向后蹬,背部保持平直。 | 10次 伸右手/收回 | 核心/腹部; 背/腰 | 力量; 平衡 | https://www.bilibili.com/video/BV161qHBQEhf/ |
| 35 | 鸟狗式伸左手右脚/bird_dog_left_arm_right_leg_rep | 四肢跪地,左手向前伸,右腿向后蹬,背部保持平直。 | 10次 伸左手/收回 | 核心/腹部; 背/腰 | 力量; 平衡 | https://www.bilibili.com/video/BV161qHBQEhf/ |
| 36 | 半蝗虫式抬上半身动态/half_locust_upper_body_rep | 双手贴身体向后伸,肩膀下沉夹紧肩胛骨,用上背部发力,抬起上半身。 | 10次 抬起/落下 | 背/腰 | 力量 | https://www.bilibili.com/video/BV1EZDWBbEoG |
| 37 | 半蝗虫式抬上半身静态/half_locust_upper_body_time | 双手贴身体向后伸,肩膀下沉夹紧肩胛骨,用上背部发力,抬起上半身。 | 30秒 | 背/腰 | 力量; 等长收缩 | https://www.bilibili.com/video/BV1EZDWBbEoG |
| 38 | 全蝗虫式/full_locust_time | 双手贴身体向后伸,肩膀下沉夹紧肩胛骨,用上背部和臀部发力,抬起上身双腿。 | 30秒 | 背/腰; 髋/臀 | 力量; 等长收缩 | https://www.bilibili.com/video/BV1EZDWBbEoG |
| 39 | 人面狮身式/sphinx_pose_time | 俯卧垫上,手肘撑地,手肘与肩膀同宽,背部发力,把胸口向前推起,眼睛平视前方。 | 30秒 | 背/腰; 核心/腹部 | 拉伸; 等长收缩 | https://www.bilibili.com/video/BV1moCEBuENJ |
| 40 | 玛里琪扭转左/marichyasana_twist_left_time | 左手掌撑在屁股侧后方,视线平视镜头,左腿屈膝踩地,右肘抵住左膝,不要发力。吸气拉长脊柱,呼气向左扭转。 | 30秒 | 脊柱; 核心/腹部 | 灵活性/热身; 拉伸 | https://www.bilibili.com/video/BV1EZDWBbEoG |
| 41 | 玛里琪扭转右/marichyasana_twist_right_time | 右手掌撑在屁股侧后方,视线平视前方,右腿屈膝踩地,左肘抵住右膝,不要发力。吸气拉长脊柱,呼气向右扭转。 | 30秒 | 脊柱; 核心/腹部 | 灵活性/热身; 拉伸 | https://www.bilibili.com/video/BV1EZDWBbEoG |
| 42 | 骆驼式/camel_pose_time | 双膝跪地,髋部向前推,双手向后抓住脚后跟,胸腔向上打开,头微微后仰,保持呼吸。 | 15秒 | 背/腰; 髋/臀 | 拉伸 | https://www.bilibili.com/video/BV1EZDWBbEoG |
| 43 | 婴儿式/childs_pose_time | 跪姿,臀部坐在脚跟上,身体向前折叠,额头贴地,双手向前伸展,闭上眼睛,放松呼吸。 | 30秒 | 背/腰; 髋/臀 | 拉伸; 静态 | https://www.bilibili.com/video/BV1EZDWBbEoG |
| 44 | 站姿向右侧弯/standing_side_bend_right_time | 右手虎口卡在胯骨上方,左手扶右耳,手肘朝天。靠侧腰发力向右侧弯,拉伸左侧腰。 | 20秒 | 背/腰; 核心/腹部 | 拉伸; 灵活性/热身 | https://www.bilibili.com/video/BV1HYhM6rEQk |
| 45 | 站姿向左侧弯/standing_side_bend_left_time | 左手虎口卡在胯骨上方,右手扶左耳,手肘朝天。靠侧腰发力向左侧弯,拉伸右侧腰。 | 20秒 | 背/腰; 核心/腹部 | 拉伸; 灵活性/热身 | https://www.bilibili.com/video/BV1HYhM6rEQk |
| 46 | 站姿小燕飞 /standing_swallow_rep | 双脚站稳,双臂向后伸直,肩膀向后展开,骨盆微微前送,头可轻微后仰,感受腰背舒展。 | 12次 展开/还原 | 背/腰; 肩 | 力量 | https://www.bilibili.com/video/BV1HYhM6rEQk |
| 47 | 仰卧抱腿/knees_to_chest_time | 仰卧垫上,双手抱住小腿,将双腿拉向胸口,腰背贴紧垫子,后脑勺放松贴地,放松呼吸。 | 30秒 | 背/腰; 髋/臀 | 拉伸; 静态 | https://www.bilibili.com/video/BV181ZQYjEPD |
| 48 | 单腿抱膝屈腿左/single_knee_to_chest_bent_leg_left_rep | 仰卧垫上,右腿屈膝踩实地面,左腿屈膝拉向胸口,双手抱住左小腿,不要硬拉,有轻微拉伸感即可,下背部贴紧垫子。 | 10次 抱左腿/放平 | 髋/臀; 腿 | 拉伸 | https://www.bilibili.com/video/BV181ZQYjEPD |
| 49 | 单腿抱膝屈腿右/single_knee_to_chest_bent_leg_right_rep | 仰卧垫上,左腿屈膝踩实地面,右腿屈膝拉向胸口,双手抱住右小腿,不要硬拉,有轻微拉伸感即可,下背部贴紧垫子。 | 10次 抱右腿/放平 | 髋/臀; 腿 | 拉伸 | https://www.bilibili.com/video/BV181ZQYjEPD |
| 50 | 仰卧屈膝交替点地/supine_bent_knee_alt_toe_tap_rep | 双腿先屈膝悬空,小腿平行地面。左脚尖轻轻点地收回,再换右脚尖点地。全程腰部贴紧垫子,不要塌腰。 | 10次 点左脚/点右脚 | 核心/腹部; 髋/臀 | 力量; 平衡 | https://www.bilibili.com/video/BV181ZQYjEPD |
| 51 | 基础静态臀桥/static_glute_bridge_basic_time | 双手放平,双脚与肩同宽,臀部与脚跟约一掌距离。收紧屁股,用臀部发力把身体顶起来,注意别用腰硬折。 | 45秒 | 髋/臀; 核心/腹部 | 力量; 等长收缩 | https://www.bilibili.com/video/BV181ZQYjEPD |
| 52 | 卧英雄式/reclining_hero_pose_time | 双腿折叠,脚跟在臀部两侧,膝盖并拢。向后平躺,膝盖有痛感立即停止。 | 15秒 | 髋/臀; 腿 | 拉伸 | https://www.bilibili.com/video/BV181ZQYjEPD |
| 53 | 仰卧蝴蝶式/supine_butterfly_time | 平躺,双脚脚心相对,双膝自然向两侧打开,双手轻放腹部。闭上眼睛,放松呼吸。 | 45秒 | 髋/臀 | 拉伸; 静态 | https://www.bilibili.com/video/BV181ZQYjEPD |
六、动作的复用与扩展
6.1 在 Launcher 中复用动作
在 launcher 编辑器中,UP 主可以通过 “粘贴动作” 功能,将动作库中的任意动作应用到当前 <state2>。具体规则参见《LeaScript:面向端侧/视觉跟练的动作脚本规范》第五章。
6.2 通过 action_tpl2_id 引用与定制
<state2> 可以通过 action_tpl2_id 引用动作库中的模板,并对部分参数进行定制(如修改 max_count、调整某个 <pose> 的 min/max)。这实现了动作一致性与脚本定制性的平衡。
6.3 动作库的扩展
随着动作库的持续演进,新增动作时请遵循以下原则:
- 遵循命名规范:必须带 _time、_rep 或 _setup 后缀。
- 补充语义字段:新增动作时,建议同时填写 body_part 和 movement_type。
- 复用定位模板:新动作如果适配现有的定位模板(如 plank_setup、standing_full_setup),可以直接复用,不需要重新编写定位逻辑。
- 不要在同一套操里混用不同定位要求的动作:如站姿和躺卧的动作必须拆成两套操。
七、动作库与 AI 的对接
动作库不仅是 UP 主的“素材库”,也是 AI 生成操的“语义层”。AI 需要理解以下信息才能生成合理的操:
- 身体部位:body_part 帮 AI 理解“这个动作练哪里”。
- 动作类型:movement_type 帮 AI 理解“这个动作在训练流程中扮演什么角色”。
- 任务类型:_time / _rep 帮 AI 区分“这个动作是计时还是计次”。
- 难度等级:当前动作库暂未提供 level 字段,AI 生成操时默认为“全部适合初级用户”。
- 风险提示:当前动作库暂未提供 risk_flag 字段,AI 生成操时暂不考虑风险规避。
随着动作库扩大,将来极可能会逐步增加 level、risk_flag、contraindication_hint 等字段,以支撑更精细的 AI 生成逻辑。
八、姿态判断编写经验
在编写动作库的 <track_pose> 逻辑时,以下经验或许可提升用户体验和系统稳定性。
8.1 姿态判断的排列顺序
编写 <track_pose> 逻辑时,判断的先后顺序直接影响用户听到的第一条语音提示。
核心原则:先写用于支撑的关节判断。
- 以平板支撑、俯卧撑、侧平板为例:应先写“用于支撑”的关节判断(如“右上臂角度”),再写其他部位(如躯干、腿部)。
- 工程原因:引擎会依次检查所有姿态判断,但语音播报的,永远是第一个不满足的判断项。支撑关节是动作的根基,它的稳定性直接影响其他部位。把支撑判断排在前面,能确保用户首先听到并调整支撑臂,避免因支撑不稳导致动作全盘变形或受伤。
- 举例:
正确顺序:右上臂角度 → 躯干角度 → 右腿角度
若支撑臂未垂直,用户先听到 右臂太偏头了,身体向脚尖移,优先修正支撑问题。
错误顺序:躯干角度 → 右腿角度 → 右上臂角度
若支撑臂未垂直,用户可能先听到 身体塌了 或 腿没放平,调整后支撑问题依然存在,导致反复报错、体验卡顿。
同理,对于卷腹、臀桥等动作,也应先写“核心发力”相关的判断,再写四肢判断,确保用户优先把“躯干”摆正,再去调整手脚。
8.2 不满足提示的三要素
一个好的不满足提示,应同时满足:
- 告知原因:指出具体问题(如“右髋下沉太多”)。
- 给出处理:告诉用户如何解决(如“骨盆往上收一点”)。
- 文字精炼:语音提示不超过 12 字,便于跟练时快速反应。
8.3 空间方位锚点的选择(躺卧类动作关键)
- 避免“前、后”等抽象词:当用户处于仰躺状态(如死虫式、仰卧屈膝抬腿)时,“前、后”会引发空间认知混乱,应避免使用。
- 首选“脚尖”、“头部”等身体锚点:使用“脚尖”和“头部”作为方向锚点更直观。
示例:右脚太靠近头了,让远离头些。 或 右脚太偏离头了,往头方向移些。 - 备选方案:使用“靠近头部 / 远离头部”:当动作涉及脚部移动时,直接说“靠近头部”或“远离头部”,比“向上/向下”更明确,因为它不受身体倾斜角度的影响。
8.4 针对局部关节类动作
- 直接指导关节移动:对于新月式拉伸等涉及特定关节角度的动作,不要告诉用户去移身体(如“身体向后移”),而应直接说“膝盖往后收一些”、“膝盖往前移一点”。
- 原因:这类动作的角度变化,90% 是由单一关节的移动引起的。直接指挥关节,用户反应更快,效果更精准。
8.5 角度方向性判断的取舍
- 对于需要区分“左右歪斜”的动作(如臀桥的反弓),优先使用 angle3p(360)(有向角),它能区分“上凸”和“下凹”两种相反错误,并配合正负数值给出对应的两种提示语。
- 对于普通弯曲角度(如手肘弯曲),继续使用 angle3p(180)(几何夹角),因为它更直观,且不受旋转方向影响。
8.6 防止提示语与实际动作脱节
- 避免使用“收腹”、“核心收紧”等抽象术语:普通用户对这些词没有身体感知,容易“蒙”。
- 使用具体的动作指令:如“身体前倾了,向后仰些”、“右髋下沉太多,骨盆往上收一点”、“膝盖向脚尖方向移”。这些指令能直接引导用户做出正确的物理动作。
九、总结
- 文件:action_tpl2s.cfg,由多个 <action_tpl2> 块组成。
- ID 规则:仅允许英文字母/数字/下划线,≤ 40 字节;必须以 _time / _rep / _setup 结尾。
- 定位模板:预置 5 个通用定位模板(表格一),UP 主可直接复用。
- 动作列表:当前共 53 个动作(表格二),涵盖核心、肩颈、背腰、髋腿等部位。
- 语义字段:body_part(身体部位)、movement_type(动作类型),支撑 AI 生成与 Launcher 检索。
- 复用机制:通过 action_tpl2_id 引用动作库,并支持部分参数定制。
- 约束:同一套操不得混用不同定位要求的动作,需拆分为两套操。
延伸阅读:
- 《LeaScript:面向端侧/视觉跟练的动作脚本规范》:讲解原子层(动作库)与序列层(操)的完整语法。
- 《LeaScript:课程层——从“编排”到“商业化”》:讲解顶层(课程)的编排与商业化。
联系我们
对 LeaScript 的开源规范感兴趣?想深入探讨底层引擎、动作库定制,或是交流开发和跟练中的实际问题?欢迎添加我们的微信,一起交流。

(扫码添加,备注“LeaScript”)