# 儿童动作识别互动玩法 Demo 热身关开发规格文档

> 日期：2026-05-09
> 关联设计文档：[CHILD_MOTION_DEMO_WARMUP_LEVEL_DESIGN_2026-05-09.md](../design/CHILD_MOTION_DEMO_WARMUP_LEVEL_DESIGN_2026-05-09.md)
> 适用范围：儿童动作识别互动玩法 Demo 固定启动热身关
> 文档性质：开发落地规格
> 说明：本文只将已确认的热身关设计内容拆解为工程可执行规格，不新增未确认的玩法、文案或视觉设计。

## 1. 开发目标

热身关作为 Demo 启动后的固定流程，需要完成以下开发目标：

1. 调用摄像头并识别用户和环境。
2. 使用横屏比例展示热身关。
3. 在屏幕中央地面生成绿色圆环，引导用户到达建议位置。
4. 将用户实际位置生成纯描边小人指示器。
5. 只对摄像头背景做虚化处理，表达隐私保护、屏蔽环境干扰，并营造空间感。
6. 按固定步骤完成站位、招手、左右移动、挥动左右手检测。
7. 记录用户左右移动距离和挥动手臂空间。
8. 将记录结果仅保存在当前 Demo 体验会话内。
9. 后续关卡使用热身记录的边界进行安全提醒和暂停恢复。
10. 热身结束后进入关卡选择。

当前阶段先落浏览器本地 Demo。浏览器摄像头视频流仅作为舞台背景；热身动作检测以本地 mocap 动作数据源为准，通过 `useMocapInput` 连接 `http://127.0.0.1:8876/stream` 对应的 WebSocket 流，消费 `general.body.center_norm` 身体中心、手势和左右手坐标推进站位、招手与左右手挥动步骤。正式语音播报接口继续预留适配层，不阻塞前端热身流程、调试输入和页面表现骨架落地。

## 2. 非目标范围

热身关当前不包含以下内容：

1. 不接入创作模块。
2. 不作为可配置玩法模板提供给创作者。
3. 不允许跳过步骤。
4. 不允许系统自动进入下一步。
5. 不设置动作检测最长等待时间。
6. 不做特定用户识别。
7. 不跨会话保存左右空间边界和手臂挥动空间。
8. 不对手部细节进行识别，只对肢体进行区分。
9. 本阶段不处理无硬件、拒绝摄像头、多人入镜、识别丢失等异常流程；这些问题记录为待决策事项，后续硬件与摄像头方案稳定后再重新设计。

## 3. 运行入口与流向

### 3.1 入口

用户进入 Demo 后，先进入热身关。

### 3.2 出口

用户完成热身关所有步骤后，进入关卡选择。

热身结束后展示“开始游戏”按钮，用户点击后进入宝贝识物首关本地 Demo。该入口只用于热身关后的本地体验验证；正式平台体验仍必须通过“宝贝识物”创作模板发布后，在寓教于乐板块进入。

### 3.3 固定流程顺序

热身关必须按照以下顺序执行：

```text
进入热身关
↓
到达中央绿色圆环并保持 2 秒
↓
招手 / 摆手
↓
热身说明
↓
向左一步，到达左侧绿色圆环并保持 2 秒
↓
回到中间，到达中央绿色圆环并保持 2 秒
↓
向右一步，到达右侧绿色圆环并保持 2 秒
↓
回到中间，到达中央绿色圆环并保持 2 秒
↓
挥动左手
↓
挥动右手
↓
播放热身结束特效和结束语音
↓
进入关卡选择
```

## 4. 页面基础表现规格

### 4.1 横屏比例

热身关需要使用横屏比例制作和展示，适用于电视屏幕、电脑屏幕等环境。

### 4.2 摄像头画面处理

用户进入热身关时调用摄像头。

摄像头画面处理要求：

1. 识别用户和环境。
2. 将用户实际位置生成纯描边小人指示器。
3. 只对摄像头背景做虚化处理。
4. 用户纯描边小人指示器用于表达用户在画面中的实际位置。
5. 背景虚化用于表达对用户隐私的保护、屏蔽周围环境干扰，并营造空间感。

### 4.3 绿色圆环

绿色圆环用于指引用户到达指定位置。

绿色圆环出现位置包括：

1. 屏幕中央位置的地面。
2. 屏幕中心向左一个身位，约半米的地面位置。
3. 屏幕中心向右一个身位，约半米的地面位置。

“约半米”技术上以角色剪影移动距离为准，后续根据体验调校。

### 4.4 绿色圆环选中状态

用户到达绿色圆环后，绿色圆环进入 2 秒选中状态。

用户需要在绿色圆环内保持 2 秒，才算完成该位置检测。

## 5. 通用交互规则

### 5.1 不允许跳过

每个步骤都必须由用户完成。

系统不提供跳过，也不自动进入下一步。

### 5.2 引导动画规则

每个动作等待 3 秒后可以播放对应引导动画。

当前不设置最长等待时间。

### 5.3 手势检测规则

招手 / 摆手、挥动左手、挥动右手三类动作需要有动作区分。

检测只区分肢体，不识别手部细节。

### 5.4 手势引导规则

挥动哪只手，就使用对应手的引导。

## 6. 状态机规格

### 6.1 状态列表

热身关至少需要支持以下流程状态：

| 状态 ID | 状态名称 | 进入条件 | 完成条件 | 下一状态 |
|---|---|---|---|---|
| warmup_enter | 进入热身关 | 用户进入 Demo | 摄像头调用并展示中央绿色圆环 | center_arrive |
| center_arrive | 到达中央圆环 | 中央绿色圆环出现 | 用户到达中央圆环并保持 2 秒 | wave_greeting |
| wave_greeting | 招手教学 | 中央圆环完成并播放圆圈消失特效 | 用户完成招手 / 摆手 | warmup_intro |
| warmup_intro | 热身说明 | 招手 / 摆手完成 | 播放热身说明文案与语音 | move_left |
| move_left | 向左一步 | 热身说明完成 | 用户到达左侧圆环并保持 2 秒 | return_center_1 |
| return_center_1 | 回到中间（一） | 向左一步完成 | 用户到达中央圆环并保持 2 秒 | move_right |
| move_right | 向右一步 | 回到中间（一）完成 | 用户到达右侧圆环并保持 2 秒 | return_center_2 |
| return_center_2 | 回到中间（二） | 向右一步完成 | 用户到达中央圆环并保持 2 秒 | wave_left_hand |
| wave_left_hand | 挥动左手 | 回到中间（二）完成 | 用户完成挥动左手 | wave_right_hand |
| wave_right_hand | 挥动右手 | 挥动左手完成 | 用户完成挥动右手 | warmup_finish |
| warmup_finish | 热身结束 | 挥动右手完成 | 播放热身结束特效和结束语音 | level_select |
| level_select | 关卡选择 | 热身结束 | 进入关卡选择 | - |

### 6.2 状态推进约束

1. 状态必须按顺序推进。
2. 用户未完成当前状态检测目标时，不进入下一状态。
3. 位置类状态必须满足“到达绿色圆环并保持 2 秒”。
4. 动作类状态没有最长等待时间。
5. 动作类状态等待 3 秒后可以播放对应引导动画。
6. 每个步骤进入时需要先展示本步骤文字字幕和语音播报入口，约 1 秒后再进入可交互阶段并展示绿色圆环、手势引导等检测提示。
7. 步骤完成后需要先进入完成停顿阶段，当前停顿约 0.8 秒；停顿期间保留完成反馈位置，后续可在该阶段补充完成特效或音效，再切换到下一步骤。
8. 入场等待和完成停顿阶段不消费动作完成判定，避免用户上一步残留动作直接触发下一步。

### 6.3 开发者调试输入

本地 Demo 需要支持开发者调试模式，用于无摄像头和自动化验证场景。

调试映射如下：

1. `A` 键映射用户向左移动。
2. `D` 键映射用户向右移动。
3. 鼠标左键按下并拖动映射左手轨迹。
4. 鼠标右键按下并拖动映射右手轨迹。
5. 空格键仅映射小人弹起调试动画，不触发流程推进。

调试输入只作为本地 Demo 与测试辅助，不代表正式动作识别硬件口径。正式摄像头接入后，位置和手势判断需要按摄像头硬件调教结果重新校准。

## 7. 分步骤开发规格

### 7.1 进入热身关

#### 展示内容

- 调用摄像头。
- 识别用户和环境。
- 屏幕中央地面显示绿色圆环。
- 用户实际位置显示为纯描边小人指示器。
- 只对摄像头背景做虚化。

#### 文案与语音

```text
欢迎你，小朋友，见到你真开心
来圆圈这里和我打个招呼吧
```

首个 `center_arrive` 步骤不显示顶部大标题，只显示字幕文案。第一句展示后停顿 2 秒，再切换到第二句；绿色圆环仍按步骤入场节奏约 1 秒后出现。

#### 检测目标

用户到达中央绿色圆环并保持 2 秒。

#### 完成反馈

播放圆圈消失特效。

---

### 7.2 招手教学

#### 展示内容

播放招手的手势引导。

用户进入该步骤 3 秒仍未完成动作时，可以播放引导动画。

#### 检测目标

用户完成招手 / 摆手手势。

#### 完成后

进入热身说明。

---

### 7.3 热身说明

#### 文案与语音

```text
你好呀小朋友，为了你玩的安全和开心，先来和我一起热个身吧
```

#### 完成后

进入“向左一步”。

---

### 7.4 向左一步

#### 展示内容

屏幕中心向左一个身位，约半米的地面位置出现新的绿色圆圈。

#### 文案与语音

```text
向左一步
```

#### 检测目标

用户到达左侧绿色圆环并保持 2 秒。

#### 完成反馈

```text
真棒
```

#### 数据记录

记录本次向左移动距离，作为后续关卡中的左侧空间边界参考。

---

### 7.5 回到中间来（一）

#### 展示内容

场地中心位置出现绿色圆圈。

#### 文案与语音

```text
回到中间来
```

#### 检测目标

用户到达中央绿色圆环并保持 2 秒。

#### 完成反馈

```text
真棒
```

---

### 7.6 向右一步

#### 展示内容

屏幕中心向右一个身位，约半米的地面位置出现新的绿色圆圈。

#### 文案与语音

```text
向右一步
```

#### 检测目标

用户到达右侧绿色圆环并保持 2 秒。

#### 完成反馈

```text
真棒
```

#### 数据记录

记录本次向右移动距离，作为后续关卡中的右侧空间边界参考。

---

### 7.7 回到中间来（二）

#### 展示内容

场地中心位置出现绿色圆圈。

#### 文案与语音

```text
回到中间来
```

#### 检测目标

用户到达中央绿色圆环并保持 2 秒。

#### 完成反馈

```text
真棒
```

---

### 7.8 挥动左手

#### 展示内容

播放伸展手臂挥动左手的手势引导。

用户进入该步骤 3 秒仍未完成动作时，可以播放引导动画。

#### 文案与语音

```text
挥动左手
```

#### 检测目标

用户完成挥动左手。

当前本地 mocap 的 handedness 按摄像头视角输出，热身关内需要先换算成用户身体视角再判断：摄像头右侧手对应用户左手。挥动左手不是普通横向轨迹检测，而是用于确认现实环境中用户左侧手臂打开空间足够和安全。

完成条件必须同时满足：

1. 使用用户身体左手轨迹。
2. 手腕在左肩外侧达到最小外展距离。
3. 手腕不能处于自然下垂低位。
4. 最近连续有效帧中，手臂存在足够上下摆动幅度。
5. 最近连续有效帧中，肩膀到手腕向量的角度变化达到阈值。
6. 至少出现一次上下摆动方向变化。

#### 完成反馈

```text
真棒
```

#### 数据记录

记录用户挥动左手的轨迹、空间包络、角度范围和最大外展距离，保存为该用户对应的行为坐标。

---

### 7.9 挥动右手

#### 展示内容

播放伸展手臂挥动右手的手势引导。

用户进入该步骤 3 秒仍未完成动作时，可以播放引导动画。

#### 文案与语音

```text
挥动右手
```

#### 检测目标

用户完成挥动右手。

当前本地 mocap 的 handedness 按摄像头视角输出，热身关内需要先换算成用户身体视角再判断：摄像头左侧手对应用户右手。挥动右手不是普通横向轨迹检测，而是用于确认现实环境中用户右侧手臂打开空间足够和安全。

完成条件必须同时满足：

1. 使用用户身体右手轨迹。
2. 手腕在右肩外侧达到最小外展距离。
3. 手腕不能处于自然下垂低位。
4. 最近连续有效帧中，手臂存在足够上下摆动幅度。
5. 最近连续有效帧中，肩膀到手腕向量的角度变化达到阈值。
6. 至少出现一次上下摆动方向变化。

#### 完成反馈

```text
真棒
```

#### 数据记录

记录用户挥动右手的轨迹、空间包络、角度范围和最大外展距离，保存为该用户对应的行为坐标。

---

### 7.10 热身结束

#### 进入条件

用户完成挥动右手后，直接进入热身结束阶段。

#### 完成反馈

播放热身结束特效、上浮字幕和语音：

```text
真厉害，你是我见过最聪明的小朋友
别走开，现在开始我们的游戏吧
```

#### 完成后

进入关卡选择。

## 8. 当前 Demo 体验会话数据

### 8.1 保存范围

以下数据仅在当前 Demo 体验会话内保存：

1. 左侧空间边界。
2. 右侧空间边界。
3. 左手挥动空间。
4. 右手挥动空间。

当前 Demo 体验会话数据需要满足：

1. 用户刷新产品或退出产品后失效。
2. 用户只关闭当前游戏关卡并重新进入时，可以直接来到开始游戏界面，不强制重复热身。
3. 首版可使用前端运行时内存或同等生命周期容器保存；不得跨产品刷新持久化保存。

### 8.2 当前 Demo 体验会话定义

“当前 Demo 体验会话”指用户本次打开并体验 Demo 的过程。

当用户关闭 Demo、刷新页面、退出当前体验流程、重新进入 Demo，或更换设备后，系统不再沿用上一次热身记录的数据，需要重新完成热身关并重新记录。

### 8.3 仅会话内保存原因

采用仅当前 Demo 体验会话内保存的原因：

1. 每名用户的身高、体型、动作幅度不同，安全边界和行为坐标会发生变化。
2. 当前 Demo 不做特定用户识别，无法确认下一次体验的是否仍是同一名用户。
3. 用户所处的体验环境可能变化，包括房间大小、摄像头位置、屏幕位置和站立距离。
4. 为保证安全，每次体验都需要重新对环境和距离进行安全检查。

## 9. 后续关卡安全边界使用规则

后续关卡需要使用热身关记录的左右空间边界进行安全判断。

### 9.1 覆盖安全边界线

当用户身体主体覆盖安全边界线时，对应侧屏幕边缘出现虚影提醒。

### 9.2 超出安全边界线

当用户身体主体超出安全边界线时：

1. 关卡内容暂停。
2. 屏幕虚化。
3. 屏幕中央地面出现绿色圆圈。
4. 屏幕提示文案：

```text
小朋友，要注意安全哦
```

5. 用户需要回到中心绿色圆圈并保持 2 秒后，才能继续游戏内容。

## 10. 识别能力清单

热身关需要接入或实现以下识别能力：

1. 摄像头调用。
2. 用户识别。
3. 环境识别。
4. 用户实际位置识别。
5. 用户是否到达中央绿色圆环位置。
6. 用户是否在绿色圆环内持续保持 2 秒。
7. 用户是否到达左侧约半米绿色圆环位置。
8. 用户是否到达右侧约半米绿色圆环位置。
9. 招手 / 摆手手势识别。
10. 挥动左手识别。
11. 挥动右手识别。
12. 用户左右移动距离记录。
13. 用户挥动手臂空间记录。
14. 用户身体主体覆盖安全边界线判断。
15. 用户身体主体超出安全边界线判断。
16. 用户回到中心绿色圆环并保持 2 秒判断。

## 11. 表现能力清单

热身关需要实现以下表现能力：

1. 横屏比例显示。
2. 摄像头背景虚化。
3. 用户位置生成纯描边小人指示器。
4. 屏幕中央地面绿色圆环。
5. 左侧约半米地面绿色圆环。
6. 右侧约半米地面绿色圆环。
7. 绿色圆环 2 秒选中状态。
8. 圆圈消失特效。
9. 招手手势引导。
10. 伸展手臂挥动左手手势引导。
11. 伸展手臂挥动右手手势引导。
12. 热身结束特效。
13. 上浮字幕。
14. 语音播报。
15. 安全边界虚影提醒。
16. 关卡暂停时屏幕虚化。
17. 关卡暂停时屏幕中央地面绿色圆圈。
18. 关卡暂停提示文案。

角色剪影、绿色圆环、虚影提醒、圆圈消失特效、手势引导动画和热身结束特效的正式视觉资源将通过 gpt-image-2 设计和生成。本地 Demo 阶段可以先使用 CSS、Canvas 或临时占位资源实现相同交互位置与状态，不把占位资源写死为正式资产。

## 12. 固定文案与语音清单

以下文案需要作为屏幕中上方浮现文字，并同步语音播报。

正式语音播报后续接入语音播报功能接口。本地 Demo 阶段保留播报适配层与调用点，可先只展示文字，不强制生成或播放正式语音资产。

```text
欢迎你，小朋友，见到你真开心
来圆圈这里和我打个招呼吧
你好呀小朋友，为了你玩的安全和开心，先来和我一起热个身吧
向左一步
真棒
回到中间来
真棒
向右一步
真棒
回到中间来
真棒
挥动左手
真棒
挥动右手
真厉害，你是我见过最聪明的小朋友
别走开，现在开始我们的游戏吧
小朋友，要注意安全哦
```

## 13. 开发验收标准

### 13.1 热身流程验收

1. 用户进入 Demo 后先进入热身关。
2. 热身关使用横屏比例展示。
3. 摄像头被调用。
4. 用户位置显示为纯描边小人指示器。
5. 摄像头背景被虚化。
6. 中央、左侧、右侧绿色圆环可以按流程出现。
7. 用户到达每个绿色圆环后，需要保持 2 秒才算完成。
8. 每个步骤未完成时不能跳过，也不能自动进入下一步。
9. 动作等待 3 秒后可以播放对应引导动画。
10. 所有固定文案可以展示并语音播报。
11. 完成全部热身步骤后进入关卡选择。

### 13.2 数据记录验收

1. 完成向左一步后，可以记录左侧空间边界。
2. 完成向右一步后，可以记录右侧空间边界。
3. 完成挥动左手后，可以记录左手挥动空间。
4. 完成挥动右手后，可以记录右手挥动空间。
5. 以上数据仅在当前 Demo 体验会话内保存。
6. 重新进入 Demo 后，不沿用上一次热身记录，需要重新完成热身关。

### 13.3 后续关卡安全边界验收

1. 用户身体主体覆盖安全边界线时，对应侧屏幕边缘出现虚影提醒。
2. 用户身体主体超出安全边界线时，关卡内容暂停。
3. 关卡暂停时，屏幕虚化。
4. 关卡暂停时，屏幕中央地面出现绿色圆圈。
5. 关卡暂停时，展示提示文案：

```text
小朋友，要注意安全哦
```

6. 用户回到中心绿色圆圈并保持 2 秒后，游戏内容继续。

## 14. 不确定项与补充确认

当前需求已明确本文所需的热身关开发规格。

以下内容作为待决策事项保留，后续硬件、摄像头和正式关卡设计稳定后再补充：

1. 具体接入的动作识别 SDK、硬件接口和摄像头接口。
2. 无硬件、摄像头拒绝授权、多人入镜、识别不到用户、跟踪丢失等异常流程。
3. 小人指示器、圆环、虚影提醒、特效、手势引导动画的正式资源文件命名。
4. 绿色圆环、小人指示器、安全边界在线性空间或屏幕坐标中的正式计算公式。
5. 正式关卡选择页与后续游戏关卡的具体页面结构。

## 15. 第 3 项本地 Demo 落地记录

本地浏览器 Demo 入口已落在：

```text
/child-motion-demo
```

当前实现范围：

1. `src/ChildMotionDemoApp.tsx` 挂载独立 Demo 应用壳。
2. `src/components/child-motion-demo/childMotionWarmupModel.ts` 维护热身步骤、圆环目标、2 秒保持判定、热身校准记录和当前运行时会话完成标记。
3. `src/components/child-motion-demo/ChildMotionWarmupDemo.tsx` 实现横屏舞台、背景虚化占位层、角色剪影、绿色圆环、手势引导、热身记录面板、热身完成后的“开始游戏”按钮，并复用宝贝识物运行态进入首关本地 Demo。
4. `src/services/child-motion-demo/childMotionDebugInput.ts` 保留开发者调试输入适配层，后续可被正式动作识别 SDK 适配层替换或并行接入。
5. `src/routing/appRoutes.tsx` 新增 `/child-motion-demo` 独立路由，并复用 `VITE_ENABLE_EDUTAINMENT_ENTRY` 开关；开关关闭时不允许通过该直达路径进入 Demo。

当前调试输入：

1. `A` 键映射用户向左移动，松开后回到中心。
2. `D` 键映射用户向右移动，松开后回到中心。
3. 鼠标左键按下并拖动映射左手轨迹。
4. 鼠标右键按下并拖动映射右手轨迹。
5. 空格键仅映射小人弹起调试动画，不触发流程推进。
6. 调试输入只在步骤可交互阶段触发步骤完成；步骤入场字幕阶段和完成停顿阶段会忽略完成判定，便于观察节奏和后续补充特效。

当前硬件和动作检测接口接入：

1. 浏览器摄像头视频流已接入舞台背景。
2. 热身关全流程已通过 `src/services/useMocapInput.ts` 接入本地 mocap WebSocket `/stream`；动作数据源状态优先于浏览器背景摄像头状态展示。
3. mocap 包支持从 `general.body.center_norm` 读取身体中心，位置类步骤使用该身体中心更新小人指示器横向位置并完成圆环保持检测。
4. 身体中心横向坐标进入小人指示器前必须做输入稳定化处理：先 clamp 到 `0..1`，再使用小幅死区、低通阻尼和单包最大步长限制，避免硬件噪声造成角色左右误判、画面抽搐或视觉上的忽大忽小。当前实现参数为死区 `0.012`、阻尼系数 `0.28`、单包最大步长 `0.035`；位置保持检测使用稳定化后的角色坐标。
5. 小人指示器渲染需要把水平位移和跳跃表现拆开：外层只负责横向定位，内层资源只负责轮廓图和跳跃位移，避免 `left` 与 `transform` 同时抢占导致资源重采样抖动。
6. mocap 包支持从 `actions/action/gesture/gestures/event/name/type` 读取动作名，并支持 `hands[]`、`leftHand/rightHand`、`left_hand/right_hand` 读取左右手坐标。
7. `hands[].landmarks` 存在时优先用手腕和 MCP 点计算掌心中心；掌心点不足时退回 wrist landmark，再退回 hand 直出坐标。
8. 热身舞台需要复用宝贝识物运行态的左右手指示器资源与样式，显示用户当前左右手位置；mocap 显示同样按摄像头视角换算成用户身体视角，用户左手使用 camera-right，用户右手使用 camera-left。手部指示器优先使用 `general.limb_nodes` / `limb_nodes` 中换算后同侧的 `right_wrist` / `left_wrist` 骨架手腕节点，骨架手腕缺失时再回退到手部 landmark 的 `wrist`，最后回退到 hand 直出坐标，避免手掌识别不稳时指示器跟随掌心抽搐。鼠标左键 / 右键调试时也同步显示同款左手 / 右手指示器。
9. `wave_greeting` 只消费左手、右手或未知单手的连续横向挥手轨迹，不再使用 `wave`、`hand_wave`、`open_palm`、张手状态或动作名直接完成判定；进入轨迹判定前必须先满足抬手有效区：优先使用 `hands[].landmarks.wrist` 与 `general.limb_nodes` 的同侧 `*_elbow` / `*_shoulder` 判断，当前阈值为 `wrist.y <= elbow.y + 0.04`，缺少肘部时使用 `wrist.y <= shoulder.y + 0.08`；缺少同侧肘部和肩膀参考时不允许招呼通过，不再使用身体中心兜底判断抬手。轨迹阈值为至少 5 个连续抬手点，横向 `x` 范围差值不小于 `0.075`，且至少出现 1 次横向方向变化，避免“手刚露出画面”或“手自然下垂抖动”被误判为招手。
10. `wave_greeting` 完成后直接进入 `warmup_intro` 的“准备热身 / 你好呀小朋友...”字幕节奏，不显示“真棒”完成飘字；后续位置移动、左右手挥动等正式热身步骤仍保留“真棒”反馈。
11. `wave_left_hand` 和 `wave_right_hand` 只消费用户身体侧对应手的连续坐标轨迹，不再使用动作名、张手状态或 primary hand 兜底完成判定；本地 mocap handedness 当前按摄像头视角输出，因此用户左手使用 camera-right，用户右手使用 camera-left。完成判定必须同时满足对应肩肘腕外展、手腕非自然下垂、连续有效帧、横向范围、上下摆动范围、肩腕角度范围和上下方向变化，当前阈值为连续外展点不少于 5 个、横向 `x` 范围不小于 `0.055`、垂直 `y` 范围不小于 `0.08`、肩腕角度范围不小于 `28°`、外展距离不小于 `0.12`、手腕相对肩膀外侧距离不小于 `0.1`；后续以真实体验结果继续调参。
12. 挥动右手完成后直接进入 `warmup_finish`，不再要求原地跳跃检测或记录跳跃空间。
13. 键盘 `A/D/Space` 与鼠标左右键拖拽仍保留为本地 Demo 调试兜底，不代表正式硬件口径；其中 `Space` 只播放小人弹起调试动画，不推进热身流程。

当前未接入但已保留边界：

1. 正式语音播报接口暂不接入，当前先展示热身文案。
2. 后续关卡安全边界暂停逻辑暂未落地，当前只完成热身记录和宝贝识物首关本地 Demo 衔接。

## 16. 当前视觉资产与生图口径补充

儿童动作 Demo 的视觉口径已经统一收敛到绘本风格草地舞台：

1. 舞台主环境采用卡通绘本风格、明亮草地、天空、小山坡和树木的组合，默认背景环境需要保证中心与下方前景留空，便于角色轮廓和地面指示环叠加。
2. 该卡通绘本草地风格是儿童动作 Demo 后续场景、物品、UI 资源的全局风格要求；新增资源不得切回暗色科技风、真实照片风或后台面板风。
3. `src/index.css` 中的热身舞台、摄像头背景层、地面、角色轮廓、地面圆环、开始按钮和横屏提示均按绘本草地风格接入真实资源；资源加载失败时保留 CSS 兜底。
4. 生成脚本固定为 `scripts/generate-child-motion-demo-assets.mjs`，并通过 `npm run assets:child-motion-demo` 触发；脚本使用 `gpt-image-2-all` 调用 VectorEngine `POST /v1/images/generations`，透明资源先生成品红底源图，再在本地移除色键，源图写入 `tmp/child-motion-demo-assets/`。
5. 当前已生成并接入以下正式 Demo 资源：
   - `public/child-motion-demo/picture-book-grass-stage.png`：默认草地舞台背景。
   - `public/child-motion-demo/picture-book-foreground-grass-v2.png`：底部前景草坪条，只覆盖舞台下沿，不作为整块地板拉伸。
   - `public/child-motion-demo/picture-book-ground-ring-v3.png`：已按透视绘制的浅蓝与暖黄色地面椭圆指示环，和草地材质做明显区分，CSS 只等比缩放。
   - `public/child-motion-demo/picture-book-character-outline-v4.png`：用户位置小人指示器，基于 v2 本地后处理为更细的白色描边样式，中间完全透明，耳朵、手指、脚趾等细节已弱化；页面显示尺寸相对上一版放大 50%。
   - `public/child-motion-demo/picture-book-hud-strip-v2.png`：顶部 HUD 细长软纸条。
   - `public/child-motion-demo/picture-book-calibration-strip-v2.png`：右下角五格热身状态条。
   - `public/child-motion-demo/picture-book-start-panel-v2.png`：开始按钮背后的轻盈托盘。
   - `public/child-motion-demo/picture-book-ui-button-v2.png`：开始按钮绘本风按钮底图。
   - `public/child-motion-demo/picture-book-wave-cat-body-guide-v7.png`：招手阶段中央猫咪身体底座资源，按可动纸偶结构只包含猫头和短身体；v7 基于 v6 局部去除了身体左右两侧不协调的小圆点，不再和旧猫头、胸口或猫爪资源叠加。
   - `public/child-motion-demo/picture-book-wave-cat-arm-guide-v7.png`：招手阶段左右独立手臂资源，也用于左右手阶段单手提示；网页用同一拆件承接挥手摆动动画，但左手阶段使用 `picture-book-wave-cat-paw-left-v1.png`，右手阶段使用 `picture-book-wave-cat-paw-right-v1.png`，不再依赖同图镜像猜方向。v7 重点修正猫爪掌面朝向，末端圆猫爪必须正面对玩家，避免看起来朝内或朝向角色自己。
6. v2 资源按最终用途拆分，CSS 必须按资源原始比例、`aspect-ratio` 或 `background-size: contain / auto` 等方式等比使用；禁止把方形面板强行拉伸为 HUD、状态条或地板，也禁止把底部草坪扩展成覆盖角色脚下的大色块。
7. 猫咪招手引导拆件必须由 `.child-motion-gesture-guide__wave-cat` 父级统一承接上下浮动；身体层不再单独 bob，左右手臂只在同一父级坐标系内围绕肩部挂点旋转，并且手臂层级必须位于身体层前方。招手阶段使用独立全屏定位容器，猫咪整体放在上半屏幕、顶部字幕 UI 下方，避免压到地面小人指示器和圆环。当前 v7 资源的手臂贴近身体外缘摆放，左右侧距为 `12%`，左臂使用原图层与 `60% 78%` 旋转轴，右臂使用镜像图层与 `40% 78%` 旋转轴；左右手臂同步摆动，挥手动画周期为 `0.47s`，相对上一版约提速 50%，避免身体和手臂在动画过程中产生相对位移或压住胸口主体。8/11 挥动左手和 9/11 挥动右手阶段的单手猫猫手臂提示需要与打招呼双臂区分：不再使用左右招手式摆动，而是显示单侧外展安全弧线，并让猫爪沿外侧弧线做上下摆动，和“手臂外展、上下摆动幅度、角度变化、方向变化”的判定规则保持一致。
8. 猫咪招手引导资源使用 `cat-guide` 透明后处理：先由 image-2 生成品红底源图，再通过边缘背景连通区域去背，避免把浅粉、淡橘和暖棕主体误删。源图只保存在 `tmp/child-motion-demo-assets/`，正式页面只引用 `public/child-motion-demo/` 下的最终 PNG。
9. 若后续补充或重绘资源，应先运行 `npm run assets:child-motion-demo -- --dry-run` 核对 prompt 和输出路径，再使用 `--live --only <asset-id>` 小批量生成；仅调整透明去背、裁切、画布归一、品红边缘、`character-outline-only-v3` / `character-outline-white-v4` 或 `wave-cat-body-guide-v7` 这种基于正式资源的局部后处理时，可用 `npm run assets:child-motion-demo -- --live --postprocess-only --force --only <asset-id>` 复用本地源图，不额外请求 image-2；不得把 `VECTOR_ENGINE_API_KEY`、源图或中间预览图提交到仓库。

已执行的定向验证命令：

```bash
npx eslint src/components/child-motion-demo/ChildMotionWarmupDemo.tsx src/components/child-motion-demo/childMotionWarmupModel.ts src/components/child-motion-demo/ChildMotionWarmupDemo.test.tsx src/components/child-motion-demo/childMotionWarmupModel.test.ts src/services/child-motion-demo/childMotionDebugInput.ts src/services/child-motion-demo/childMotionDebugInput.test.ts src/services/child-motion-demo/index.ts src/ChildMotionDemoApp.tsx src/routing/appRoutes.tsx src/routing/appRoutes.test.ts --ext .ts,.tsx --max-warnings 0
npx vitest run src/components/child-motion-demo/childMotionWarmupModel.test.ts src/components/child-motion-demo/ChildMotionWarmupDemo.test.tsx src/services/child-motion-demo/childMotionDebugInput.test.ts src/routing/appRoutes.test.ts
npm run check:encoding
```