LeaScript:动作库

如果你正在编写课程待做清单(CSV),需要查找动作的 Name/ID 来填入 Ref_Item 列,但还没有下载模板,请前往《LeaScript:课程层——从‘编排’到‘商业化’》下载 csv 模板。

在 LeaScript 的分层架构中,动作库属于第一层(原子层)。它是整个系统的“标准动作单元”仓库,每个 <action_tpl2> 块对应一个可复用的标准动作。

本文是 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 建议增加的语义元数据,用于支撑两个目标:

  1. AI 语义:AI 生成操时需要理解“这个动作练哪里”、“这个动作属于什么类型”。
  2. Launcher 检索:UP 主在编辑器里找动作时,可以按部位和类型快速过滤。

它们不参与姿态判定,只作为分类标签存在。


 

二、动作 ID 命名规范

动作库中的 id 是全局唯一标识。命名规则如下:

 

2.1 字符与长度限制

  1. 仅允许使用英文字母、数字(0-9)以及下划线 _。
  2. 最大长度不得超过 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 将“如何摆手机”拆解为三个递进步骤,并在界面上给予实时的反馈。

    图 1:跟练前的手机摆放与定位状态全貌
  • 左侧边栏 -87.48°:反映手机垂直地面的加速度计倾角,绿色表示达标。*
  • 画面网格:5 条蓝色参考线,用于辅助用户对齐垫子,确保镜头与身体平行。*
  • 绿色文字:定位状态下的姿态点实时判定,直观展示“画面占比”、“居中”和“空间留白”是否合格。*

 

3.1 第一步:保证手机垂直地面

系统通过手机内置的加速度计实时测量设备的倾斜角。界面上会显示一个角度值(如图 1 左侧的 -87.48°),当倾斜角接近垂直时,数值与指示框会变为绿色,表示达标;偏离时显示红色并提示用户调整。这一步不依赖摄像头画面,是纯传感器校准,用来确保后续所有姿态点不会被“拍歪”。

 

3.2 第二步:保证镜头与身体平行

手机垂直之后,下一步是让镜头平面与用户的身体平面平行。LeaScript 会在画面中渲染 5 条蓝色参考线(如图 1 画面中的网格)。用户不需要理解“光轴”“透视”等概念,只需移动支架,让现实中瑜伽垫的长边与画面中的参考线保持平行即可。这一步决定了画面中的水平与垂直方向是否与真实世界一致,是姿态角度计算不产生系统性偏差的关键。

 

3.3 第三步:确保拍到必要的姿态点

前两步只解决“手机摆得正不正”,第三步解决“人站得对不对”。进入定位状态后,系统会根据当前动作所需的姿态点,自动判断用户的站位是否满足要求(如图 1 右侧绿色的“全身画面占比”、“左髋水平居中”等判定数据),并通过语音与画面提示引导用户向前、向后或左右移动。

这一步正是“定位模板”(_setup 动作)所负责的内容。 动作库预置了多种定位模板,覆盖躺卧、站姿髋及以上、站姿全身等典型场景,供不同的动作直接复用。

小结:第一步与第二步是设备姿态的校准,第三步是用户站位的校准。三步全部通过,才进入正式的动作检测阶段。以下我们将详细介绍动作库中预置的定位模板(对应第三步的校准)。

 

四、动作库总览(表格一:定位模板)

说明:下表列出动作库中当前提供的定位模板。UP 主在编写新操时,可以直接从这些模板中选择一个作为第一状态。

在做“横向操”(躺卧/俯卧)时,手机放右侧,距离身体约2米,高度距地面约50厘米(大约一张床的高度)。

对身体横向类动作,像新月式、平板支撑、眼镜蛇式、死虫式、侧平板等,手机右侧摆放,脸朝身体前方。并且,除平板支撑、俯卧撑外(如果是垫上,也不建议穿),强烈建议不要穿鞋。

 名称/ID开场提示适用场景
1定位(平板撑)/plank_setupxxx训练。手机摆在右侧,镜头跟身体平行,对准肚脐附近,放好手机后,原地趴下,保持不动,等待定位完成。躺卧。手机放右侧,镜头对准肚脐附近。
2定位(俯卧撑)/pushup_setupxxx训练。手机摆在右侧,镜头跟身体平行,对准肩膀附近,放好手机后,原地趴下,做出手臂伸直到最高点姿势,等待定位完成。躺卧。手机放右侧,镜头对准肩膀附近。
3定位(死虫式)/dead_bug_setupxxx训练。手机摆在右侧,镜头跟身体平行,对准肚脐附近,放好后,原地躺下,左手向后伸直,等待定位完成。躺卧。手机放右侧,做操时,可容下手向后伸平。如果操中没有平板支撑、俯卧撑动作,建议用它。
4定位(站姿髋及以上+上举)/standing_hips_raised_arms_setupxxx训练。请将手机放正前方,摆好手机后,请站到画面中央,保持身体正对镜头,等待定位完成。站姿。手机放正前方,要求髋、及以上必须入画,会留出上举、手腕自然下垂空间。如果操中动作都不须要判断膝盖以及下面姿态点,建议用它。
5定位(站姿全身入镜)/standing_full_setupxxx训练。请将手机放正前方,摆好手机后,请站到画面中央,保持身体正对镜头,等待定位完成。站姿。手机放正前方,要求全身必须入画。如果操中有动作须要看到全身,建议用它。

 

五、动作库总览(表格二:全部动作)

说明:下表列出动作库中当前提供的全部动作。一旦有动作更新,会尽快更新本表格。

 名称/ID开场提示任务身体部位动作类型演示
1平板支撑/plank_time60秒平板撑。

60秒、

纯满足时长、首尾密集报时

核心/腹部

力量

https://www.bilibili.com/video/BV1ettR6SE7Y
2俯卧撑/pushup_rep8个俯卧撑。

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 动作库的扩展

随着动作库的持续演进,新增动作时请遵循以下原则:

  1. 遵循命名规范:必须带 _time、_rep 或 _setup 后缀。
  2. 补充语义字段:新增动作时,建议同时填写 body_part 和 movement_type。
  3. 复用定位模板:新动作如果适配现有的定位模板(如 plank_setup、standing_full_setup),可以直接复用,不需要重新编写定位逻辑。
  4. 不要在同一套操里混用不同定位要求的动作:如站姿和躺卧的动作必须拆成两套操。

 

七、动作库与 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”)

全部评论: 0 条

    写评论: