# 站立交替摆臂 PRD

## 1. 行为配置

| 字段 | 类型 | 值与规则 |
|---|---|---|
| catalogKey / section | string | `arm_swing` / `arm-swing` |
| taskId | string | `design:20261016:alternating-arm-swing`；科学文案和动作条目键 |
| behaviorId / variantId | string或null | `null` / `null`；null不可作为正式完成标识提交 |
| behaviorName / categoryId | string | 站立交替摆臂 / `agility` |
| durationLabel | string | `30秒`；仅入口预计时间，不是播放预算或动作剂量 |
| deviceRequirements | array | []；不申请相机，不采集动作或用户节拍输入 |
| illustration | 资源引用 | 统一页arm-swing配图；入口与详情共用 |
| science.shared | string | 调动双侧运动节律回路，提升肢体协调度与身体律动控制力。 |
| science.completion | string | 协调动力学经典的 HKB 模型表明，双肢异向（一前一后 180° 相位差）交替运动比同向运动需要更高的辅助运动区（SMA）控制参与，以防止动作自发滑向同向。刚才的交替摆臂，正是在训练双侧异向节律的稳定性。 |
| steps | string[] | 下列顺序常驻展开 |
| rewardType / rewardAmount | enum / integer | energy（元气） / 12；奖励配置不代替真实回执 |

`steps`：

1. 面向屏幕站稳，双膝放松、双臂自然下垂，身边留出摆臂空间。
2. 跟随镜像人物，一侧手臂向前摆，另一侧向后摆；随后交换。
3. 双脚留在原位，双臂按舒适节奏交替，幅度以自然舒适为准。

| 执行配置 | 类型 | 值与校验 |
|---|---|---|
| totalCycles / playBudgetMs | integer或null / number或null | null / null；正式结束预算必填，不能从入口30秒或一组交换快照推导 |
| mirror / feetMove | boolean | true / false；双脚留在原位 |
| cycleDefinition | string | 右臂前左臂后→左臂前右臂后→自然交换；中间位置是连续经过，不额外停顿 |
| 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，不增加权限、准备或教程确认页 |
| 行为执行 | 中部主示范 | 中心主示范表现前后纵深；一臂向前、另一臂向后，随后交换；双脚原位；前后臂用形态及“向前／向后”文字区分 |
| 行为执行 | 下方提示、轨道与进度 | 示范下方单条右向左轨道；中心落点固定；实心右菱形表示右臂向前，空心左菱形表示左臂向前，并有文字标签；prompt、aux原位替换，不遮人物 |
| 行为执行 | 底部 | 未收尾时“不舒服，结束”；结束后显示引导结束 |
| 结果 | 四层位置 | 引导事实或有效完成标题与科学文案→真实元气回执→今日进度→立即可用的返回今日行动 |

入口、详情、已有完成记录与滚动位置复用[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html)§1—2。独立资格校验通过且已提交完成后展示科学完成原文，包含pending／unknown；提交明确失败、资格不满足、预览或仅播放结束时隐藏完成原文。资源和今日进度仍等待服务确认。

## 3. 执行状态与判定

| phase | 进入条件与画面 | 推进、输入与下一状态 |
|---|---|---|
| ready | 面向屏幕站稳，双膝放松，双臂自然下垂 | 按配置时间轴开始，不新增准备时长 |
| right-front | 右臂向前、左臂向后 | 右侧事件到中心，随后自然交换进入left-front |
| left-front | 左臂向前、右臂向后 | 左侧事件到中心；自然经过return后继续right-front |
| return | 双臂交换途中经过身体两侧 | 不形成一次动作后的停顿；由正式预算决定继续还是在完整回位后收尾 |
| ended | 双臂慢慢放下，自然站稳 | 仅在有效播放预算满足并完成收尾时产生guideEnded |

正式结束预算必须有明确计量单位与边界。总周期数、总时长或阶段预算未配置时，只允许关键帧预览，不能把一个交替示例自动当作整局结束。

播放器自动衔接，不增加逐拍、逐步确认。加载时间不计播放时间；关闭声音不停止字幕、动作或轨道。轨道符号、示范位置及次数均只描述媒体，不生成用户命中、漏拍、连击、得分或健康变化。重复媒体结束事件按同一playbackRunId去重；后台时间、卡顿时间和退出冻结时间不计有效播放。

| 运行字段 | 类型与范围 | 更新规则与用途 |
|---|---|---|
| phase | enum | 按状态表控制画面与播放 |
| playbackRunId | string | 每次从首帧完整重开时生成；区分重开和继续 |
| mediaTimeMs | number，≥0 | 以媒体当前时轴为准，不以墙钟累计代替 |
| cueId / prompt / aux | string | 取当前cue；静音时保持完整可读 |
| 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 | 展示实际播放预算及已播进度；没有用户动作计数 |
| 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. 验收条件

| 操作或边界 | 通过条件 |
|---|---|
| 动作身份 | 前后异向交替，双脚原位；不能画成两臂左右张开或同向举臂 |
| 经过中位 | return只表达连续交换，没有每对后的强制停顿 |
| 预算缺项 | 不按入口30秒或一次交换结束业务练习；业务开始与完成禁用，关键帧预览可看 |
| 无动作输入 | 无相机权限、触屏节拍、轨迹采集或动作正确判定；示范进度不能改写成用户实际完成 |
| 时间轴和播放预算 | 缺配置阻止业务开始与完成，预览仍可看关键帧；媒体、字幕、轨道同轴，不用入口时长代替 |
| 退出与中断 | 退出同步冻结，继续严格遵守本项恢复；结束清除半途过程，后台不续接，不增加完成或奖励 |
| 结果与原文 | science两字段逐字匹配taskId，元气金额与行为配置总表一致；只有播放事实时不显示身体完成原文或到账 |
| 首次结果与重练 | 查看结果读取首次记录；新repeat session不覆盖首次表现、回执与今日进度；返回立即可用 |
| 窄屏与静音 | 示范、提示、轨道与底部控件互不遮挡；文字和符号独立传达动作，不依赖颜色或声音 |
