# 坐姿上身旋转 PRD

## 1. 行为配置

| 字段 | 类型 | 值与规则 |
|---|---|---|
| catalogKey / section | string | `torso_twist` / `torso-twist` |
| taskId | string | `lib:BODY-014`；读取动作与科学两字段的条目键 |
| behaviorId | string或null | `lib:BODY-014`；当日去重标识，null不得作为正式完成标识提交 |
| variantId | string或null | `lib:BODY-014:minute-v1`；null须由行为配置总表补齐后才能提交正式完成 |
| behaviorName / categoryId | string | 坐姿上身旋转 / `relaxation` |
| durationLabel | string | `75秒`；仅入口预计时间，不作为动作截止、保持时间或媒体时长 |
| deviceRequirements | array | `[camera]`；仅要求双肩入镜，须经公共权限与取景准备 |
| illustration | 资源引用 | 统一页`torso-twist`行为配图；入口和详情共用 |
| science.shared | string | 激活胸椎与深层背肌，缓解久坐僵硬，恢复上身灵活与舒展。 |
| science.completion | string | 脊柱生物力学数据显示，胸椎承担了躯干约 70% 至 80% 的水平旋转幅度（单侧生理范围约 30° 至 35°）。刚才在骨盆稳定下的上身转体，正是在温和动员久坐受限的胸椎节段与腹斜肌群。 |
| steps | string[] | 按下列顺序展示，常驻展开 |
| rewardType | enum | `energy`；显示名称“元气” |
| rewardAmount | integer或null | `15`；仅奖励资格配置，展示到账量须读取实际回执 |

`steps`：

1. 坐在稳固、无轮且无扶手的椅子上，双脚平放，坐正；手机固定在前方，让双肩入镜。
2. 双臂交叉，双手搭在肩部；髋部保持朝前并坐稳。
3. 上身慢慢转向左侧，到舒适位置保持5秒，再慢慢回正。
4. 再转向右侧；左、右交替，每侧5次，共10次。不要只转头或移动双手。

| 执行配置 | 类型 | 值与校验 |
|---|---|---|
| totalReps | integer | 10 |
| perSideReps / alternating | integer或null / boolean | 5 / true |
| holdMs | integer，毫秒 | 5000；仅本次可靠连续保持 |
| completionPolicy | object | `{mode:"full-return",requiredReps:10,holdMs:5000}`；全部完整回位后才形成自然完成资格 |
| recognitionProfile | object或null | 必填；含profileId、已验证设备类型、关键点集合、置信门限(0—1)、稳定判定时长(>0ms)、舒适目标范围、回位范围、进出滞回与事件去重规则；各数值须由目标设备验证配置，不得从线稿位置推导 |
| recognitionProfile.requiredLandmarks | string[] | `[left_shoulder,right_shoulder]`；只以双肩作为必需识别点；髋部、双臂和座位不作为取景或识别有效性的门槛 |
| settleMs | number，毫秒 | 必填，≥0；只控制回正后的结果过渡，不增加身体保持 |

正式开始须校验behaviorId、variantId、识别配置及目标设备支持列表均有效。识别配置缺失或设备未通过校验时，业务开始禁用；预览可查看关键帧，不产生识别事件、计次、完成或奖励。识别事件须携带sessionId、rep、phase、单调时间戳及唯一eventId，跨会话、跨次、重复或不可确认的事件一律拒绝。

## 2. 页面、字段与操作位置

| 页面 | 区域及顺序 | 字段与操作 |
|---|---|---|
| 今日行动 | 卡片左侧及右侧 | 左侧`illustration`；右上`behaviorName`与`durationLabel`；其下`science.shared`；元气图标及服务返回的完成状态 |
| 行为详情 | 自上而下 | 返回今日行动、`behaviorName`→`illustration`→“行为说明”及`science.shared`→“怎么做”及`steps`→底部主操作；具体方法不折叠 |
| 行为详情 | 底部固定操作区 | 未完成且配置有效、未满3项时“准备开始”；请求中禁用防重；已完成左“查看结果”、右“再练一次”；已满3项禁用开始；配置缺项显示“暂不可开始”，原位说明缺少必要配置 |
| 摄像头准备 | 权限→取景→就绪 | 复用[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html)§2；权限说明“开启摄像头，识别双肩动作与回正”；授权后取景示意只强调双肩，提示“请让双肩完整入镜”；权限拒绝可前往设置或返回详情，相机失败可重试或返回详情；双肩稳定可见且识别配置有效时才可开始，不要求髋部或双臂入镜 |
| 行为执行 | 顶部工具栏及标题 | 左“退出”，右“声音 开／关”；下方显示`behaviorName` |
| 行为执行 | 中上部主交互 | 当前转向弧线、过程小目标、水波与大目标填色；左右交替 |
| 行为执行 | 同一场景右下角 | 常驻小示范；动作、保持或回正阶段同步，示范不驱动识别和计数 |
| 行为执行 | 场景外提示及底部进度 | prompt显示当前动作，aux显示要点；底部显示“第{rep}/10次”；保持阶段显示本次剩余秒数 |
| 完成结果 | 四层顺序 | 完成标题、行为名、本局表现及符合展示条件的`science.completion`→实际元气回执→今日进度→返回今日行动；字段按第5节 |
| 退出／重练确认层 | 执行或详情上方 | 复用[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html)§3双按钮与焦点管理；本项恢复去向按第4节 |

入口、详情及已完成按钮关系复用[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html)§1。返回今日行动保留列表滚动位置；结果底部返回立即可用。

## 3. 执行状态与判定

| phase | 进入条件与画面 | 输入、判定与下一状态 |
|---|---|---|
| move | 当前次开始；“上身慢慢向左／右转” | 按本项已校准的双肩动作信号推进过程反馈；到舒适目标进入hold |
| hold | “保持在舒适位置”；显示本次5秒剩余量 | 仅可靠连续保持累计；满5000ms立即提示回正，进入return；提前离开或信号丢失进入recover，当前次不计 |
| return | “慢慢回正”；当前次尚未计为完成 | 可靠确认回到自然坐姿后completedReps加1；未满总数进入下一次move，交替行为换侧；最后一次回正进入settling |
| recover | 先慢慢回正，停止填色与保持，当前次标无效 | 保留此前完整次数；回正并让双肩稳定重新入镜后重做当前次，当前保持从0开始；可结束回今日行动 |
| settling | 回到自然坐姿，显示已确认完整次数 | 不加做、不继续保持；按settleMs结束进入结果 |

次数以“完整动作＋可靠连续保持5秒＋回正”为单位，当前次未回正不加1。短暂抖动由recognitionProfile的稳定与滞回规则过滤，不补算不可确认时段；可靠输入持续不足时进入recover。目标按个人舒适范围配置，不以固定图形坐标要求更大幅度。从左侧开始，左右交替各5次；只转头、抬手或全身平移均不代替上身转动；识别依据为本项已校准的双肩信号，不要求获取肩髋相对关系。

识别仅使用双肩必需关键点及其校准后的时序变化；姿态阈值仍读取已验证的recognitionProfile，不从示范图推导。仅髋部、双臂或座位未入镜不触发未就绪或识别丢失。双肩可靠信号不足时停止当前反馈并提示“先慢慢回正，让双肩重新入镜”，按recover重做当前次。

没有统一时长截断；入口预计时间不触发完成。保持到时即回正，命中、水波和填色动画不阻塞动作、不替代识别事件。

| 运行字段 | 类型与范围 | 更新规则与用途 |
|---|---|---|
| phase | enum | 按状态表控制输入；只有动作态接收本项可靠识别事件 |
| rep | integer | 当前计划动作序号，按本项上限递增 |
| completedReps | integer | 只累计可靠确认并完整回位的次数；不能由示范或动画增长 |
| paused | boolean | 退出确认期间为true；冻结输入及反馈 |
| naturalCompleted / qualified | boolean | 自然收尾事实与业务资格分开；有效证据、身份及完成策略全部通过后qualified才为true |
| side | enum，left / right | rep奇数为left、偶数为right；从左开始，左右交替 |
| holdElapsedMs | number，0—5000 | 当前次可靠连续保持时长；提前离开或失真后归零 |
| fill | number，0—1 | 本次视觉进展；不参与业务计次或奖励 |

## 4. 结束、退出、中断与重练

| 条件 | 状态处理 | 可见内容、操作与去向 |
|---|---|---|
| 点退出 | 先处理受理时刻已到的自然边界，再冻结动作输入、计时、媒体、字幕及反馈 | “结束本次行动？”；正文“请先慢慢回正。结束后，本次进度将清除。”；左“继续行动”、右“结束本次” |
| 退出确认中继续 | 保留此前完整次数，当前次无效；先回正、重新稳定取景，再从当前次move重新做；不续接部分保持 | 关闭确认层，按本项恢复规则回到执行页；不得补算冻结时间 |
| 退出确认中结束 | `phase=quit`，清除本会话未完成过程 | 返回原今日行动列表；不提交本次完成，已有首次记录及回执不变 |
| 不适停止 | 停止输入或播放，慢慢回到舒适坐姿 | 显示“请停止练习，慢慢回到舒适坐姿”；返回今日行动，不催补做 |
| 后台、锁屏或关闭页面，尚无有效自然完成 | 停止本会话，清除半途动作与播放进度 | 回前台返回今日行动；再次开始新会话，从第1次或媒体首帧开始，不补算后台时间 |
| 已自然结束且业务资格有效 | 保留本局表现和同一完成请求 | 收束中退出显示“本局已结束”；继续恢复剩余收束，查看完成结果直接进入结果；系统中断后查询原sessionId |
| 只有引导结束或业务资格不足 | 不提交完成、不创建奖励事务 | 按第5节显示引导结束或未完成结果；不得借退出、重新进入或查询补造有效完成 |
| 已完成详情点再练一次 | 按[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html)§3显示重复提醒 | 取消返回详情；继续创建新sessionId与repeatSession=true；重新走本项所需准备，清空本轮状态，首次记录不变 |
| 重练结束 | 保留本次表现，首次记录与奖励事务不变 | 只有资格校验通过才显示“本次练习完成”；本次新增0，今日进度不增加；仅引导结束仍按引导结果显示 |

退出确认与异常恢复均在原公共执行容器内处理。弹层内Tab限定双按钮，继续后焦点返回原操作区。

## 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`。同一sessionId仅提交一次；重试和查询沿用原标识；配置元气数不能代替到账回执。

| 本项字段 | 类型与范围 | 生成、读取及约束 |
|---|---|---|
| completedReps | integer，0—10 | 可靠确认并完整回位的次数；表现“完整回位{completedReps}次” |
| requiredReps | integer | 10 |
| recognitionProfileId / recognitionEvidence | string / object[] | 关联校验通过的识别配置及去重事件摘要；不得由动画或手动预览补造 |
| naturalCompleted / qualified | boolean | 末次回正确认后自然结束；满requiredReps且所有业务校验通过才可提交 |

首次完成请求除公共字段外包含completedReps、requiredReps、recognitionProfileId与本项有效事件摘要；不提交视觉fill或小目标数量作为健康效果证据。服务确认前不增加今日完成数。

| 结果条件 | 第一层内容 | 资源与今日进度 |
|---|---|---|
| 资格有效且已提交完成 | completionStatus为pending或unknown时显示“完成状态确认中”、行为名、本局实际表现及science.completion；success时标题按公共§5 | pending／unknown时资源“待确认”，查询原sessionId，进度不增加；完成成功后显示实际奖励回执与服务进度 |
| completionStatus为failed | “本次未完成”、可展示失败原因及本局表现；隐藏science.completion | 不显示本次奖励；刷新服务实际进度，不自行增加 |
| 资格无效或业务配置缺项 | “本次未完成”、原因及已确认动作事实；不显示完成原文 | 不创建本次奖励；无确认值显示“待确认”；已有服务进度如实保留，不增加 |
| 从已完成详情查看结果 | 读取首次记录的标题、表现和科学完成原文 | 查询首次completionId奖励回执；显示当前业务日服务进度 |
| 重练且资格有效 | “本次练习完成”及本次表现，完成原文按公共规则显示 | 首次回执＋“本次新增0”；不覆盖首次表现和完成时标题，今日进度不增加 |

所有结果保留立即可用的“返回今日行动”；查询仅刷新对应区域，不重新播放或重复发奖。

## 6. 验收条件

| 操作或边界 | 通过条件 |
|---|---|
| 肩部取景 | 仅双肩入镜即可准备；髋部、双臂和座位未入镜不阻止开始、不触发丢失；权限、取景、执行丢失和恢复提示均只要求双肩 |
| 动作量 | 左右交替各5次，共10次；每次连续5秒并回正 |
| 提前离开、丢失或退出后继续 | 此前完整次数不减；当前次不计，回正后重做；保持不得拼接前后两段 |
| 回正确认与重复事件 | 未回正不计数；同一eventId只记一次，旧rep事件不记到下一次 |
| 时长与反馈 | 预计时间到达不截断；保持到时立刻提示回正，不等待填色或水波 |
| 识别缺配置 | 业务开始禁用；线稿、点击外部审阅按钮和填色不会伪造动作完成 |
| 核对入口与详情 | 名称、配图、共用科学文案与展开方法顺序一致；预计时间不驱动动作或媒体截止 |
| 核对科学与资源 | 两段原文逐字匹配taskId；本项资源仅元气；无回执不显示到账，无score、动作分或百分比 |
| 查看结果与再练 | 底部并排双按钮；首次记录和回执不被重练覆盖，查询沿用原标识，返回立即可用 |
| 手机可用性 | 文字、示范和进度互不覆盖；滚动不遮主操作；静音不损失动作及退出信息 |
