# 交叉拍膝 PRD

## 1. 行为配置

| 字段 | 类型 | 值与规则 |
|---|---|---|
| catalogKey / section | string | `cross_knee` / `cross-knee` |
| taskId | string | `ext:20261008:EXT-CROSS-KNEE`；科学文案和动作条目键 |
| behaviorId / variantId | string或null | `ext:20261008:EXT-CROSS-KNEE` / `design:20261011:cross-knee-bhf-8-v1`；null不可作为正式完成标识提交 |
| behaviorName / categoryId | string | 交叉拍膝 / `agility` |
| durationLabel | string | `30秒`；仅入口预计时间，不是播放预算或动作剂量 |
| deviceRequirements | array | []；不申请相机，不采集动作或用户节拍输入 |
| illustration | 资源引用 | 统一页cross-knee配图；入口与详情共用 |
| science.shared | string | 激活对侧运动协调网络，提升四肢协调性与身体反应敏捷度。 |
| science.completion | string | 运动控制研究显示，上肢越过身体中线配合对侧下肢抬起，需要双侧前运动皮层与小脑通过跨半球通路进行更密集的时序协同。刚才的左右交替拍膝，正是在练习跨中线的四肢动态衔接。 |
| steps | string[] | 下列顺序常驻展开 |
| rewardType / rewardAmount | enum / integer | energy（元气） / 15；奖励配置不代替真实回执 |

`steps`：

1. 站稳，双脚约髋宽，把手机固定在前方；身体周围留出抬膝与落脚的空间。
2. 像照镜子一样跟随：抬右膝，左手跨过身体轻靠右膝；膝盖只抬到舒适高度。
3. 手随膝慢慢落下，把右脚放回地面、站稳，再换左膝与右手。
4. 左右交替，共8个单侧动作，左右各4次；一次抬膝、对侧手靠近和落脚合为1次。

| 执行配置 | 类型 | 值与校验 |
|---|---|---|
| totalReps / repsPerSide | integer | 8 / 4；8个单侧完整周期，不是8对 |
| startSide / mirror | enum / boolean | right / true；画面右对应用户右 |
| phasesPerRep | string[] | approach→contact→lower→landing |
| demoMs / singleSideMs | integer，毫秒 | 6000 / 3000；先示范右、左各1个单侧，共6秒；不计入下列8个跟练单侧 |
| followMs / endingMs / totalGuideMs | integer，毫秒 | 24000 / 3000 / 33000；8个跟练单侧各3秒后，完整放松收束3秒才结束 |
| guideSegments | object[] | demo `[0,6000)`；follow `[6000,30000)`；ending `[30000,33000)`；同一播放时间轴，不另加准备段 |
| mediaSource | 资源引用或null | 必填；跟练视频或连续动画，须含完整回位收尾 |
| cueTimeline | object[]或null | 必填；每项cueId、phase、startMs、endMs、prompt、aux、轨道位置、侧别及周期/次数；同一媒体时轴，区间前闭后开，无重叠倒序 |
| completionPolicy | object或null | null；正式业务必填，含policyId、服务校验规则及所需独立证据；播放结束本身不得推断身体完成 |

正式开始前校验身份、媒体、完整时间轴、动作预算及completionPolicy；缺少任一必填配置时，业务开始禁用，且不能提交完成。关键帧预览不创建业务完成或奖励。入口30秒仅为预计标签，不截断33秒引导。正式媒体与单侧内部接触、下落、落脚的精准cue点位仍可留空，成片后按媒体回填，不推定BPM或新增保持。

跟练第rep个单侧的时段为`[6000+(rep−1)×3000, 6000+rep×3000)`，rep为1—8，右左交替、各4次。静态approach/contact/lower/landing关键帧共用本侧时段，精确phaseOffsetMs暂为null；同一3秒区间内的四幅图不是各占3秒。末次落脚后进入30—33秒收束，33秒才形成引导结束事实。

## 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 / demo | 双脚站稳，先看左右各1次镜像示范 | 0—3秒右侧、3—6秒左侧；共6秒，不计入8个跟练单侧，不另加准备时长 |
| approach | 当前侧膝抬起，对侧手跨中线靠近 | 本侧接触菱形从右方接近中心；进入contact |
| contact | 对侧手与当前侧膝轻靠 | 接触菱形到中心；不固定保持或拍完弹开，进入lower |
| lower | 手随膝慢慢落下 | 接触菱形经过中心，落脚短线接近中心；进入landing |
| landing | 当前侧脚放回地面，站稳 | 落脚短线到中心；8个单侧按右左交替，每个单侧含完整3秒周期，未满8进入另一侧approach，末次进入ending |
| ending | 30—33秒，双臂放松，自然站稳 | 保留3秒放松收束，不增加身体保持或额外单侧动作 |
| ended | 完整播放至33000ms并收束 | 只产生guideEnded，不宣称实际动作达标；静态收束关键帧不自行创建该事实 |

接触事件与落脚事件分开；当前接触到中心时，同侧落脚是右侧最近的下一事件，另一侧接触更远。轨道和人物共用媒体时轴，轨道不接收输入。

播放器自动衔接，不增加逐拍、逐步确认。加载时间不计播放时间；关闭声音不停止字幕、动作或轨道。轨道符号、示范位置及次数均只描述媒体，不生成用户命中、漏拍、连击、得分或健康变化。重复媒体结束事件按同一playbackRunId去重；后台时间、卡顿时间和退出冻结时间不计有效播放。

| 运行字段 | 类型与范围 | 更新规则与用途 |
|---|---|---|
| phase | enum | 按状态表控制画面与播放 |
| playbackRunId | string | 每次从首帧完整重开时生成；区分重开和继续 |
| mediaTimeMs | number，≥0 | 以媒体当前时轴为准，不以墙钟累计代替 |
| cueId / prompt / aux | string | 取当前cue；静音时保持完整可读 |
| rep / side | integer，1—8 / enum | rep奇数为right，偶数为left；只表示单侧示范序号与当前侧 |
| 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个单侧周期；不写实际完成次数 |
| 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个单侧、每侧4；每次包含抬膝、对侧手靠近、随膝下落和落脚 |
| 播放预算 | 示范6秒不计入跟练8单侧；跟练每单侧3秒共24秒；再收束3秒，总33秒，不能用入口30秒提前结束 |
| 关键帧时间范围 | 8个跟练区间连续覆盖6—30秒，四个动作阶段共享各自单侧区间，不乘成每阶段3秒；精准cue仍可为空 |
| 轨道同步 | 接触菱形和落脚短线依次到中心；同侧落脚先于另一侧接触 |
| 对侧与镜像 | 画面右膝对应用户右膝、画面左手跨向右膝；左侧动作完全镜像 |
| 无动作输入 | 无相机权限、触屏节拍、轨迹采集或动作正确判定；示范进度不能改写成用户实际完成 |
| 时间轴和播放预算 | 缺配置阻止业务开始与完成，预览仍可看关键帧；媒体、字幕、轨道同轴，不用入口时长代替 |
| 退出与中断 | 退出同步冻结，继续严格遵守本项恢复；结束清除半途过程，后台不续接，不增加完成或奖励 |
| 结果与原文 | science两字段逐字匹配taskId，元气金额与行为配置总表一致；只有播放事实时不显示身体完成原文或到账 |
| 首次结果与重练 | 查看结果读取首次记录；新repeat session不覆盖首次表现、回执与今日进度；返回立即可用 |
| 窄屏与静音 | 示范、提示、轨道与底部控件互不遮挡；文字和符号独立传达动作，不依赖颜色或声音 |
