# V形步配合同侧抬臂 PRD

## 1. 行为配置

| 字段 | 类型 | 值与规则 |
|---|---|---|
| catalogKey / section | string | `v_steps` / `v-steps` |
| taskId | string | `gentle:20261009:body-v-steps`；科学文案和动作条目键 |
| behaviorId / variantId | string或null | `gentle:20261009:body-v-steps` / `gentle:20261009:body-v-steps:minute-v1`；null不可作为正式完成标识提交 |
| behaviorName / categoryId | string | V形步配合同侧抬臂 / `agility` |
| durationLabel | string | `45秒`；仅入口预计时间，不是播放预算或动作剂量 |
| deviceRequirements | array | []；不申请相机，不采集动作或用户节拍输入 |
| illustration | 资源引用 | 统一页v-steps配图；入口与详情共用 |
| science.shared | string | 激活运动皮层动作协调回路，提升手脚配合度与全身动态协调性。 |
| science.completion | string | 运动学习研究表明，将上下肢同侧动作与多步空间位移（前展-后收四步序列）绑定执行，会显著调动前运动皮层与基底节的动作组块（Chunking）机制。刚才的 V 形步，正是在强化多肢体连续步序的协调输出。 |
| steps | string[] | 下列顺序常驻展开 |
| rewardType / rewardAmount | enum / integer | energy（元气） / 15；奖励配置不代替真实回执 |

`steps`：

1. 面向屏幕站稳，双脚并拢、双臂自然下垂，前方和两侧留出迈步空间。
2. 右脚向右前方迈出，同时抬起右臂；左脚向左前方迈出，同时抬起左臂，右臂保持抬起。
3. 右脚收回，同时放下右臂，左臂保持抬起；左脚收回，同时放下左臂，回到初位。
4. 按“右前、左前、右收、左收”完成一个四步周期，共跟随8个完整周期；步幅和抬臂幅度以舒适为准。

| 执行配置 | 类型 | 值与校验 |
|---|---|---|
| totalCycles / stepsPerCycle | integer | 8 / 4；共32步示范 |
| startSide / mirror | enum / boolean | right / true |
| stepOrder | string[] | right-front→left-front→right-back→left-back |
| mediaSource | 资源引用或null | 必填；跟练视频或连续动画，须含完整回位收尾 |
| cueTimeline | object[]或null | 必填；每项cueId、phase、startMs、endMs、prompt、aux、轨道位置、侧别及周期/次数；同一媒体时轴，区间前闭后开，无重叠倒序 |
| completionPolicy | object或null | null；正式业务必填，含policyId、服务校验规则及所需独立证据；播放结束本身不得推断身体完成 |

正式开始前校验身份、媒体、完整时间轴、动作预算及completionPolicy；缺少任一必填配置时，业务开始禁用，且不能提交完成。关键帧预览不创建业务完成或奖励。时间轴的秒点读取正式媒体，不能按入口预计时间反推，不增加未确认的BPM、保持或轮数。

## 2. 页面、字段与操作位置

| 页面 | 区域及顺序 | 字段与操作 |
|---|---|---|
| 今日行动 | 卡片 | 左配图；右名称与durationLabel，下方science.shared及元气图标；完成状态读取服务 |
| 行为详情 | 自上而下 | 返回、名称→配图→“行为说明”及science.shared→“怎么做”及steps→底部主操作；方法不折叠 |
| 行为详情 | 底部 | 未完成配置有效时开始行动；配置缺项“暂不可开始”；请求中禁用；今日已满3项禁用；已完成左查看结果、右再练一次 |
| 行为执行 | 顶部 | 左退出、右声音开/关，下方行为标题；从详情直接进入局内加载或ready，不增加权限、准备或教程确认页 |
| 行为执行 | 中部主示范 | 中心正面镜像示范与地面V形四脚位；右侧对应用户右侧，脚位仅表示落脚位置，不另造节奏轨道 |
| 行为执行 | 下方提示、轨道与进度 | 下方单条右向左轨道；固定中心；前迈抬臂用向上符号，收脚放臂用向下符号；每个事件带右前／左前／右收／左收文字；prompt、aux原位替换，不遮人物 |
| 行为执行 | 底部 | 未收尾时“不舒服，结束”；结束后显示引导结束 |
| 结果 | 四层位置 | 引导事实或有效完成标题与科学文案→真实元气回执→今日进度→立即可用的返回今日行动 |

入口、详情、已有完成记录与滚动位置复用[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html)§1—2。独立资格校验通过且已提交完成后展示科学完成原文，包含pending／unknown；提交明确失败、资格不满足、预览或仅播放结束时隐藏完成原文。资源和今日进度仍等待服务确认。

## 3. 执行状态与判定

| phase | 进入条件与画面 | 推进、输入与下一状态 |
|---|---|---|
| ready | 双脚并拢、双臂自然下垂，留出前侧空间 | 自然进入第1周期right-front；不新增固定准备秒数 |
| right-front | 右脚向右前迈、右臂抬起；左脚原位、左臂垂下 | 第1步，进入left-front |
| left-front | 左脚向左前迈、左臂抬起；右臂仍抬，双脚呈V形 | 第2步，进入right-back |
| right-back | 右脚收回、右臂放下；左臂仍抬、左脚仍在前 | 第3步，进入left-back |
| left-back | 左脚收回、左臂放下；双脚回初位 | 第4步完成1周期；未满8继续right-front，满8进入ended |
| ended | 双臂放松，自然站稳 | 8完整四步周期引导结束，仅产生guideEnded |

周期数只在第4步完整示范收脚后增加；所有8×4步必须在时间轴中完整存在，不能用8步替代8周期。抬起一侧时另一侧的手臂状态必须保留，不能每步都放下双臂。

播放器自动衔接，不增加逐拍、逐步确认。加载时间不计播放时间；关闭声音不停止字幕、动作或轨道。轨道符号、示范位置及次数均只描述媒体，不生成用户命中、漏拍、连击、得分或健康变化。重复媒体结束事件按同一playbackRunId去重；后台时间、卡顿时间和退出冻结时间不计有效播放。

| 运行字段 | 类型与范围 | 更新规则与用途 |
|---|---|---|
| phase | enum | 按状态表控制画面与播放 |
| playbackRunId | string | 每次从首帧完整重开时生成；区分重开和继续 |
| mediaTimeMs | number，≥0 | 以媒体当前时轴为准，不以墙钟累计代替 |
| cueId / prompt / aux | string | 取当前cue；静音时保持完整可读 |
| cycle / step | integer，1—8 / integer，1—4 | 当前示范周期和步序；第4步完整收脚后进入下一周期 |
| paused | boolean | 退出确认期间冻结媒体、字幕、轨道与声音 |
| guideEnded | boolean | 自然播完全部预算及回位收尾后为true；跳播、审阅跳转或卡顿不补判 |
| qualified | boolean | 仅业务身份、completionPolicy及独立证据校验通过才true；不得直接等于guideEnded |

## 4. 结束、退出、中断与重练

| 条件 | 状态处理 | 可见内容与去向 |
|---|---|---|
| 点退出 | 先处理已到的媒体边界，再同步冻结示范、字幕、声音、轨道与输入 | 公共双按钮“继续行动 / 结束本次”；正文提示“慢慢收脚、放下双臂并站稳。结束后，本次引导进度将清除。” |
| 退出继续 | 恢复退出前周期、步序、字幕与轨道位置；不重置周期，也不把冻结时间算入引导 | 留在原执行容器，不增加独立教程页 |
| 确认结束或不适 | 停止引导，清除本次未完成过程；不适时提示慢慢收脚、放下双臂并站稳 | 返回原今日行动；不催补做，不产生本次完成 |
| 后台、锁屏或关闭页面 | 停止并结束半途引导；不补算后台时间 | 回前台今日行动；再次开始为新sessionId，从首帧开始 |
| 引导自然结束 | 封存本次播放事实，按独立资格策略校验 | 仅播放事实进入引导结果；资格有效再按公共完成路径 |
| 已获有效自然完成再退出或系统中断 | 保留表现、原sessionId完成请求和回执 | 进入结果查询原请求，不重复提交 |
| 再练一次 | 按公共重复提醒；继续创建新的repeat session | 从本项首帧新引导开始；首次记录、首次回执及今日进度不变 |

弹层焦点与未知请求恢复遵循[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html)§3。退出继续的本项规则优先于通用恢复；冻结时间不得变成额外身体保持或自动计完成。

## 5. 完成记录与结果字段

完成记录、幂等与回执字段精确复用[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html)§4—5：`businessDate、sessionId、repeatSession、completionId、completedAt、completionStatus、failureReason、rewardStatus、rewardReceipt、completedCount、firstResult、firstResult.completedCountAtCompletion`。

| 本项字段 | 类型 | 生成、读取及约束 |
|---|---|---|
| guideEnded / guideEndedAt | boolean / 带时区ISO时间或null | 本次有效自然播放及收尾结束事实；与身体完成分开 |
| guideProgress | object | 记录媒体源、playbackRunId、实际媒体进度与收尾cue，不含用户动作次数 |
| performance | string | 引导播放8个四步周期；不写“实际完成32步” |
| completionPolicyId / sessionEvidence | string或null / object或null | 正式完成须满足经配置的业务策略；不得伪造相机信号或从媒体位置生成身体动作证据 |
| qualified | boolean | completionPolicy为null、身份缺项或证据不满足时固定false |

| 结果条件 | 第一层 | 资源与今日进度 |
|---|---|---|
| 仅引导结束或预览收束 | “引导结束”＋本项播放事实；不显示以身体完成为前提的science.completion | 不创建completionId或奖励事务；资源无回执显示“待确认”，今日进度显示服务已确认值，无值“待确认” |
| 资格有效且已提交完成 | completionStatus为pending或unknown时显示“完成状态确认中”、行为名、本局实际表现及science.completion；success时标题按公共§5 | pending／unknown时资源“待确认”，查询原sessionId，进度不增加；完成成功后显示实际奖励回执与服务进度 |
| completionStatus为failed | “本次未完成”、可展示失败原因及本局表现；隐藏science.completion | 不显示本次奖励；刷新服务实际进度，不自行增加 |
| 重练且资格有效 | “本次练习完成”＋本次表现；首次记录不变 | 读取首次回执并显示“本次新增0”；今日进度不增加 |
| 已完成详情查看结果 | 读取当日首次有效完成记录 | 查询首次completionId回执；服务当前业务日进度 |

查询沿用原sessionId或completionId，不重新播放、不重复发奖；返回今日行动始终立即可用。

## 6. 验收条件

| 操作或边界 | 通过条件 |
|---|---|
| 完整步序 | 8周期32步；每周期严格右前、左前、右收、左收 |
| 同侧手脚 | 迈哪只脚抬同侧臂；右收时左臂仍抬，左收才放下左臂 |
| 末次收尾 | 最后左收回初位后放松，不在V形前展姿态结束 |
| 无动作输入 | 无相机权限、触屏节拍、轨迹采集或动作正确判定；示范进度不能改写成用户实际完成 |
| 时间轴和播放预算 | 缺配置阻止业务开始与完成，预览仍可看关键帧；媒体、字幕、轨道同轴，不用入口时长代替 |
| 退出与中断 | 退出同步冻结，继续严格遵守本项恢复；结束清除半途过程，后台不续接，不增加完成或奖励 |
| 结果与原文 | science两字段逐字匹配taskId，元气金额与行为配置总表一致；只有播放事实时不显示身体完成原文或到账 |
| 首次结果与重练 | 查看结果读取首次记录；新repeat session不覆盖首次表现、回执与今日进度；返回立即可用 |
| 窄屏与静音 | 示范、提示、轨道与底部控件互不遮挡；文字和符号独立传达动作，不依赖颜色或声音 |
