# 双手上托伸展 PRD

## 1. 行为配置

| 字段 | 类型 | 值与规则 |
|---|---|---|
| catalogKey / section | string | `overhead_stretch` / `overhead-stretch` |
| taskId | string | `lib:C-001`；科学文案和动作条目键 |
| behaviorId / variantId | string或null | `lib:C-001` / `lib:C-001:minute-v1`；null不可作为正式完成标识提交 |
| behaviorName / categoryId | string | 双手上托伸展 / `relaxation` |
| durationLabel | string | `40秒`；仅入口预计时间，不是播放预算或动作剂量 |
| deviceRequirements | array | []；不申请相机，不采集动作或用户节拍输入 |
| illustration | 资源引用 | 统一页overhead-stretch配图；入口与详情共用 |
| science.shared | string | 延展背阔肌与脊柱肌群，舒缓全身紧绷，恢复挺拔体态与身体活力。 |
| science.completion | string | 运动生物力学分析显示，双臂交指上托配合下肢伸展，能同步牵拉背阔肌、胸腰筋膜与腹直肌前链，使肩关节屈曲接近 180° 生理上限。刚才的上下对拉，正是在为久坐蜷缩的躯干提供纵向延展。 |
| steps | string[] | 下列顺序常驻展开 |
| rewardType / rewardAmount | enum / integer | energy（元气） / 12；奖励配置不代替真实回执 |

`steps`：

1. 手机固定在前方，双臂上方和两侧留出空间；两脚约肩宽站稳，膝自然微屈，双手放在腹前。
2. 掌心朝上，五指交叉，提至胸前；两腿缓慢伸直，翻掌向上托起，先看双掌。
3. 继续舒适上托，下颌回收、看向前方，略停；不耸肩、不后仰、不憋气。
4. 分开双手，从两侧慢慢落下，同时屈膝，双手捧回腹前。上托与下落合为1遍，共6遍，自然呼吸。

| 执行配置 | 类型 | 值与校验 |
|---|---|---|
| totalReps | integer | 6；提手、上托、看前方、回落合为1遍 |
| readyMs | integer，毫秒 | 3000；媒体载入后的站稳准备，不是身体保持 |
| holdMs | null | 不把“略停”量化成固定秒数；按正式媒体转场 |
| breathingMode | enum | natural；自然呼吸，不增加闭息或强制节拍 |
| mediaSource | 资源引用或null | 必填；跟练视频或连续动画，须含完整回位收尾 |
| cueTimeline | object[]或null | 必填；每项cueId、phase、startMs、endMs、prompt、aux及示范遍数rep；同一媒体时轴，区间前闭后开，无重叠倒序 |
| completionPolicy | object或null | null；正式业务必填，含policyId、服务校验规则及所需独立证据；播放结束本身不得推断身体完成 |

正式开始前校验身份、媒体、完整时间轴、动作预算及completionPolicy；缺少任一必填配置时，业务开始禁用，且不能提交完成。关键帧预览不创建业务完成或奖励。时间轴的秒点读取正式媒体，不能按入口预计时间反推，不增加未确认的BPM、保持或轮数。

## 2. 页面、字段与操作位置

| 页面 | 区域及顺序 | 字段与操作 |
|---|---|---|
| 今日行动 | 卡片 | 左配图；右名称与durationLabel，下方science.shared及元气图标；完成状态读取服务 |
| 行为详情 | 自上而下 | 返回、名称→配图→“行为说明”及science.shared→“怎么做”及steps→底部主操作；方法不折叠 |
| 行为详情 | 底部 | 未完成配置有效时开始行动；配置缺项“暂不可开始”；请求中禁用；今日已满3项禁用；已完成左查看结果、右再练一次 |
| 行为执行 | 顶部 | 左退出、右声音开/关，下方行为标题；从详情直接进入局内加载或ready，不增加权限、准备或教程确认页 |
| 行为执行 | 中部主示范 | 主画面放连续动作视频／动画示范；人物、双臂上方与侧落空间完整保留；不叠重复的角落小人 |
| 行为执行 | 下方提示与进度 | 下方显示prompt、aux及“第{rep}/6遍”，为示范进度；prompt、aux原位替换，不遮人物 |
| 行为执行 | 底部 | 未收尾时“不舒服，结束”；结束后显示引导结束 |
| 结果 | 四层位置 | 引导事实或有效完成标题与科学文案→真实元气回执→今日进度→立即可用的返回今日行动 |

入口、详情、已有完成记录与滚动位置复用[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html)§1—2。独立资格校验通过且已提交完成后展示科学完成原文，包含pending／unknown；提交明确失败、资格不满足、预览或仅播放结束时隐藏完成原文。资源和今日进度仍等待服务确认。

## 3. 执行状态与判定

| phase | 进入条件与画面 | 推进、输入与下一状态 |
|---|---|---|
| loading / error | 准备示范；加载中时间轴停止；失败显示“示范暂不可用” | 成功进入ready；失败可重试或结束回列表 |
| ready | 站稳，双手放在腹前；3秒后开始 | 不采集动作，到时进入第1遍lift |
| lift | 十指交叉提至胸前，膝慢慢伸开 | 按媒体时间轴进入up |
| up | 翻掌上托，目视双掌，不后仰 | 配音提示下颌回收、看前方，进入settle；不要求抬头时盯屏 |
| settle | 舒适上托，下颌回收看前方，略停 | 不设保持倒数；按媒体提示转lower |
| lower | 双手侧落，轻轻屈膝，捧回腹前 | 完整示范回落后rep加1；未满6接lift，第6遍后进入ended |
| recover | 先慢慢放下双臂，站稳 | “重新开始 / 结束本次”；重新开始从首帧及第1遍，不自动重放或续接上托停姿 |
| ended | 放下双臂，自然站稳 | 仅产生guideEnded；进入引导结果，资格按独立业务策略校验 |

卡顿立即停止媒体与字幕，进入recover。第6遍完整回落、放松收尾后才能产生引导结束；不得因播放到某个总秒数让示范停在上托姿势。

播放器自动衔接，不增加逐拍、逐步确认。加载时间不计播放时间；关闭声音不停止字幕、动作或轨道。轨道符号、示范位置及次数均只描述媒体，不生成用户命中、漏拍、连击、得分或健康变化。重复媒体结束事件按同一playbackRunId去重；后台时间、卡顿时间和退出冻结时间不计有效播放。

| 运行字段 | 类型与范围 | 更新规则与用途 |
|---|---|---|
| phase | enum | 按状态表控制画面与播放 |
| playbackRunId | string | 每次从首帧完整重开时生成；区分重开和继续 |
| mediaTimeMs | number，≥0 | 以媒体当前时轴为准，不以墙钟累计代替 |
| cueId / prompt / aux | string | 取当前cue；静音时保持完整可读 |
| rep | integer，1—6 | 当前示范遍数，只在完整回落后进入下一遍；不表示用户完成次数 |
| paused | boolean | 退出确认期间冻结媒体、字幕、轨道与声音 |
| guideEnded | boolean | 自然播完全部预算及回位收尾后为true；跳播、审阅跳转或卡顿不补判 |
| qualified | boolean | 仅业务身份、completionPolicy及独立证据校验通过才true；不得直接等于guideEnded |

## 4. 结束、退出、中断与重练

| 条件 | 状态处理 | 可见内容与去向 |
|---|---|---|
| 点退出 | 先处理已到的媒体边界，再同步冻结示范、字幕、声音、轨道与输入 | 公共双按钮“继续行动 / 结束本次”；正文提示“慢慢放下双臂，自然站稳。结束后，本次引导进度将清除。” |
| 退出继续 | 先回稳定位，进入recover；由用户选择“重新开始 / 结束本次”，不自动续播；重开从第1遍 | 留在原执行容器，不增加独立教程页 |
| 确认结束或不适 | 停止引导，清除本次未完成过程；不适时提示慢慢放下双臂，自然站稳 | 返回原今日行动；不催补做，不产生本次完成 |
| 后台、锁屏或关闭页面 | 停止并结束半途引导；不补算后台时间 | 回前台今日行动；再次开始为新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 | 引导播放6遍；仅在整段自然播放并完成收尾后显示，不写“已完成6遍动作” |
| 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. 验收条件

| 操作或边界 | 通过条件 |
|---|---|
| 完整遍数 | 6遍，每遍包含提手、上托、看前方和完整回落；不是两轮 |
| 略停与呼吸 | 不显示固定保持秒数或闭息提示；静音时仍可通过示范和文字理解看前方与回落 |
| 卡顿或退出继续 | 先放下双臂；选择重开从第1遍，不能续接高举停姿或自动追加播放 |
| 无动作输入 | 无相机权限、触屏节拍、轨迹采集或动作正确判定；示范进度不能改写成用户实际完成 |
| 时间轴和播放预算 | 缺配置阻止业务开始与完成，预览仍可看关键帧；媒体、字幕、轨道同轴，不用入口时长代替 |
| 退出与中断 | 退出同步冻结，继续严格遵守本项恢复；结束清除半途过程，后台不续接，不增加完成或奖励 |
| 结果与原文 | science两字段逐字匹配taskId，元气金额与行为配置总表一致；只有播放事实时不显示身体完成原文或到账 |
| 首次结果与重练 | 查看结果读取首次记录；新repeat session不覆盖首次表现、回执与今日进度；返回立即可用 |
| 窄屏与静音 | 示范、提示、轨道与底部控件互不遮挡；文字和符号独立传达动作，不依赖颜色或声音 |

