# 搭肩绕肘 PRD

## 1. 行为配置

| 字段 | 类型 | 值与规则 |
|---|---|---|
| catalogKey / section | string | `elbow_circles` / `elbow-circles` |
| taskId | string | `candidate:20261016:shoulder-elbow-circles-v1`；读取动作与科学两字段的条目键 |
| behaviorId | string或null | null；当日去重标识，null不得作为正式完成标识提交 |
| variantId | string或null | null；null须由行为配置总表补齐后才能提交正式完成 |
| behaviorName / categoryId | string | 搭肩绕肘 / `relaxation` |
| durationLabel | string | `45秒`；仅入口预计时间，不作为动作截止、保持时间或媒体时长 |
| deviceRequirements | array | `[camera]`；须经公共权限与取景准备 |
| illustration | 资源引用 | 统一页`elbow-circles`行为配图；入口和详情共用 |
| science.shared | string | 联动肩袖与肩胛肌群，缓解肩颈沉重感，恢复肩背舒展与活力。 |
| science.completion | string | 运动学著名的“肩肱节律”指出，手臂大范围活动需要盂肱关节与肩胛骨以约 2:1 的比例协同运转。刚才以肘画圈的动作，正是在温和动员肩袖与肩胛周围肌群，促进肩部复合体的协调活动。 |
| steps | string[] | 按下列顺序展示，常驻展开 |
| rewardType | enum | `energy`；显示名称“元气” |
| rewardAmount | integer或null | `15`；仅奖励资格配置，展示到账量须读取实际回执 |

`steps`：

1. 坐稳、坐直，双脚平放；手机固定在前方，让双肩、双肘和双手完整入镜。
2. 双手放在肩上，跟着示范，用双肘慢慢绕一轮；左右肘分别带动左右水轮，只做舒适的幅度。
3. 每轮绕完放下双臂、放松，两股水汇到同一株小芽，让它逐步长大；再搭肩开始下一次。
4. 共做10次，同一方向，不抢拍、不追求更大的幅度。

| 执行配置 | 类型 | 值与校验 |
|---|---|---|
| plannedAttempts | integer | 10；同一示范方向的计划动作机会，不额外补次数 |
| circleDirection | enum或null | 必填且整局不变，与示范一致；不在局内新增反向一组 |
| recognitionProfile | object或null | 必填；含profileId、已验证设备类型、关键点集合、置信门限(0—1)、稳定判定时长(>0ms)、舒适目标范围、回位范围、进出滞回与事件去重规则；各数值须由目标设备验证配置，不得从线稿位置推导 |
| completionPolicy | object或null | null；必填，定义有效结束证据、最低确认要求及服务校验；不得自行把10次计划机会或植物开花等同业务资格 |
| settleMs | number，毫秒 | 必填，≥0；只控制放松后的结果过渡 |

正式开始须校验behaviorId、variantId、识别配置及目标设备支持列表均有效。识别配置缺失或设备未通过校验时，业务开始禁用；预览可查看关键帧，不产生识别事件、计次、完成或奖励。识别事件须携带sessionId、attemptIndex、phase、单调时间戳及唯一eventId，跨会话、跨次、重复或不可确认的事件一律拒绝。 completionPolicy缺失时只能预览，不允许正式业务开始与完成。

## 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为“搭肩／双肘慢慢绕一轮／放下双臂”；进度“第{attemptIndex}/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 | 进入条件与画面 | 输入、判定与下一状态 |
|---|---|---|
| align | “双手轻放肩上” | 可靠确认搭肩后进入circle；不以点击进入确认动作 |
| circle | 双肘慢慢绕一轮；左右水轮分别随leftProgress/rightProgress转动 | 两侧均可靠完成同一圈轨迹后进入release；单侧多绕不多计 |
| release | “放下双臂，轻轻放松” | 完整下放确认后本次confirmed=true，completedReps及growthCount各加1；每次只释放固定一股汇流水 |
| water | 两股水浇向同一株植物 | 动画不阻塞下一次align；第10次机会后回到舒适坐姿并进入settling |
| lost / recover | 看不清一侧时停止进度，提示先放松双臂；重新取景 | 当前机会标未确认，不释水、不增加生长；恢复后继续下一次计划机会，不补做；第10次失真后直接放松收尾 |
| settling | 双臂放松，自然坐稳 | 保留实际确认数与生长，不强制开花；按completionPolicy校验后进入对应结果 |

一次完整动作包括搭肩、双肘绕一轮、双臂下放。attemptIndex是本项唯一的计划机会序号，上限10；事件适配层如使用rep，rep必须为attemptIndex的只读同源别名，不能单独保存或递增。completedReps与growthCount均不超过已结束的计划机会数。水轮各自表达本侧进度，只有两侧完成且下放可靠确认后才同时增加一次计数和生长；速度、幅度和单侧多绕均不增加水量。识别丢失或退出打断当前次时，不追补该次；不存在恢复后为了凑开花而增加第11次。自然结束与资格分开，最低有效确认数不得自行补定。

| 运行字段 | 类型与范围 | 更新规则与用途 |
|---|---|---|
| phase | enum | 按状态表控制输入；只有动作态接收本项可靠识别事件 |
| completedReps | integer | 只累计可靠确认并完整回位的次数；不能由示范或动画增长 |
| paused | boolean | 退出确认期间为true；冻结输入及反馈 |
| naturalCompleted / qualified | boolean | 自然收尾事实与业务资格分开；有效证据、身份及完成策略全部通过后qualified才为true |
| attemptIndex | integer，1—10 | 本次结束或未确认恢复后递增；达到上限停止追加动作 |
| leftProgress / rightProgress | number，各0—1 | 分别来自左右肘可靠信号；失真即停止，不外推 |
| attemptResults | object[]，最多10项 | 每项attemptIndex、confirmed、reason；每个机会只封存一次 |
| growthCount | integer，0—10 | 等于已确认完整次数；视觉生长不因丢失倒扣，不补齐未确认阶段 |

## 4. 结束、退出、中断与重练

| 条件 | 状态处理 | 可见内容、操作与去向 |
|---|---|---|
| 点退出 | 先处理受理时刻已到的自然边界，再冻结动作输入、计时、媒体、字幕及反馈 | “结束本次行动？”；正文“请先放下双臂。结束后，本次进度将清除。”；左“继续行动”、右“结束本次” |
| 退出确认中继续 | 保留完整次数和植物生长；先下放重新取景，中断当前机会不补做，继续余下计划次数；若已是第10次则收尾 | 关闭确认层，按本项恢复规则回到执行页；不得补算冻结时间 |
| 退出确认中结束 | `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仅提交一次；重试和查询沿用原标识；配置元气数不能代替到账回执。

| 本项字段 | 类型与范围 | 生成、读取及约束 |
|---|---|---|
| attemptResults | object[] | 本局10次机会各自的确认状态；无效事件不可补判 |
| completedReps / growthCount | integer，0—10 | 表现“确认{completedReps}次完整动作”；两者一致 |
| naturalCompleted / qualified | boolean | 计划机会结束并放松为自然收尾；qualified须读取completionPolicy，不由开花或确认次数自行推断 |

completionPolicy或正式身份未配置时qualified=false，不提交完成或奖励。资格有效后完成请求携带attemptResults、completedReps与识别证据摘要；植物图像和开花状态不作为服务完成证据。

| 结果条件 | 第一层内容 | 资源与今日进度 |
|---|---|---|
| 资格有效且已提交完成 | completionStatus为pending或unknown时显示“完成状态确认中”、行为名、本局实际表现及science.completion；success时标题按公共§5 | pending／unknown时资源“待确认”，查询原sessionId，进度不增加；完成成功后显示实际奖励回执与服务进度 |
| completionStatus为failed | “本次未完成”、可展示失败原因及本局表现；隐藏science.completion | 不显示本次奖励；刷新服务实际进度，不自行增加 |
| 资格无效或业务配置缺项 | “本次未完成”、原因及已确认动作事实；不显示完成原文 | 不创建本次奖励；无确认值显示“待确认”；已有服务进度如实保留，不增加 |
| 从已完成详情查看结果 | 读取首次记录的标题、表现和科学完成原文 | 查询首次completionId奖励回执；显示当前业务日服务进度 |
| 重练且资格有效 | “本次练习完成”及本次表现，完成原文按公共规则显示 | 首次回执＋“本次新增0”；不覆盖首次表现和完成时标题，今日进度不增加 |

所有结果保留立即可用的“返回今日行动”；查询仅刷新对应区域，不重新播放或重复发奖。

## 6. 验收条件

| 操作或边界 | 通过条件 |
|---|---|
| 单次下放 | 绕完未下放不计数；双侧可靠且下放确认后只计1次、只长1阶段 |
| 缺一路识别 | 当前机会不确认；不补判、不补次数，已有确认数和生长不减少 |
| 第10次机会未确认 | 放松后收尾，可停在未开花状态；不能加第11次强制凑齐 |
| 退出继续 | 当前机会不续接、不补做；余下机会与已有植物阶段正确 |
| 资格与配置 | 正式身份、方向、识别或完成策略缺失阻止业务开始与完成；预览不得生成真实动作记录 |
| 核对入口与详情 | 名称、配图、共用科学文案与展开方法顺序一致；预计时间不驱动动作或媒体截止 |
| 核对科学与资源 | 两段原文逐字匹配taskId；本项资源仅元气；无回执不显示到账，无score、动作分或百分比 |
| 查看结果与再练 | 底部并排双按钮；首次记录和回执不被重练覆盖，查询沿用原标识，返回立即可用 |
| 手机可用性 | 文字、示范和进度互不覆盖；滚动不遮主操作；静音不损失动作及退出信息 |
