# 青蛙跳跃路线 PRD

## 1. 行为配置

| 字段 | 类型 | 值与规则 |
|---|---|---|
| catalogKey | string | `frog`；配置与呈现键 |
| taskId | string | `com:LS-CP-LUMOSITY:follow-that-frog`；不代填正式身份 |
| behaviorId | string／null | `com:LS-CP-LUMOSITY:follow-that-frog`；当日完成去重 |
| variantId | string／null | `design:minute:frog-short-sequence-v1`；读取本玩法配置 |
| behaviorName | string | 青蛙跳跃路线 |
| categoryId | enum | `memory` |
| steps | string[] | 按下列顺序常驻展开 |
| durationLabel | string | `45秒`；入口预计展示值，不能作为执行截止 |
| deviceRequirements | array | []；无设备准备或权限 |
| illustration | 资源引用 | 青蛙跳跃路线配图；配置为可访问资源 |
| science.shared | string | 激活前额叶序列记忆回路，提升信息有序加工与步骤记忆力。 |
| science.completion | string | 经典的柯西块敲击研究表明，人类的空间序列短时记忆跨度约为 5 至 6 步。刚才按顺序复现跳跃路径，正在调动背外侧前额叶与辅助运动区，巩固脑内的步骤顺序编码。 |
| rewardType | enum | `inspiration`；显示“灵感” |
| rewardAmount | integer／null | 12；首次有效完成配置值，到账数只读服务回执 |

`steps`：

1. 先看示范青蛙，记住依次落在哪些荷叶，先看完不用跟点。
2. 轮到你时玩家蛙回到本段起点，按刚才顺序点下一片荷叶。
3. 走对的步骤会留在路线上。点错或时间到，这段就结束；看清揭晓的路线后自动进入下一段，不重做这一段。
4. 共5段，每段先看示范，再从本段起点出发；至少3段在轮到你时点过其他荷叶才算完成。

| 玩法参数 | 类型 | 值与约束 |
|---|---|---|
| pads / totalRounds | integer | 6 / 5 |
| jumpCounts | integer[] | [2,2,3,3,3]；合计13步 |
| readyMs / settleMs | integer，毫秒 | 各3000 |
| observeMs / demoStepMs | integer，毫秒 | 2400 / 800 |
| answerLimitMs / revealMs / landingLockMs | integer，毫秒 | 5400 / 2400 / 200 |
| minimumParticipatingRounds | integer | 3 |

## 2. 页面、字段与操作位置

| 页面或区域 | 字段、位置与操作 |
|---|---|
| 今日行动 | 卡片左侧配图；右侧名称＋预计时长，名称下方science.shared；资源区为灵感图标和服务完成状态 |
| 详情 | 名称→配图→“行为说明”及science.shared→“怎么做”及steps→底部主操作；步骤常驻展开 |
| 详情操作 | 未完成且今日名额可用：开始行动；开始处理中禁用防重复。今日已完成：左查看结果、右再练一次。3/3禁用未完成项，历史日只读 |
| 执行顶部 | 左退出、右声音；名称下方、玩法区上方显示当前prompt或结果提示，可换行但不覆盖操作对象 |
| 执行中部 | 六片固定荷叶分两排；深色示范蛙与浅色玩家蛙可区分；起点双圈和“本段起点”。作答只显示已走对的实线路径、步骤和✓，不显示未走的答案线、步骤或下一目标。 |
| 路线局部反馈 | 正确标记紧邻已走对荷叶；错误×和“点错了”紧邻被点错荷叶，错误尝试线从玩家当前叶指向错叶；不覆盖蛙或可点荷叶。揭晓结果及下一段去向紧邻荷叶区，不只显示在页首 |
| 执行底部 | 左第{round}/5段，作答右剩余秒数；上方区分先看示范与轮到你。 |
| 结果 | 完成标题→名称→本局表现→science.completion→资源回执→今日进度→固定返回今日行动；不显示“科学收获”标题；内容可滚动，返回立即可用 |

入口、详情、历史日期与列表滚动恢复采用[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html) §1，执行容器采用§2。

## 3. 执行状态与判定

| phase／子状态 | 时长与条件 | 画面、输入、反馈及转移 |
|---|---|---|
| ready | 3秒 | 倒数、先看完示范再凭记忆重走，不受理 |
| observe | 2.4秒 | 示范蛙每800ms一跳，玩家蛙隐藏，“现在不能点” |
| answer | 最多5.4秒 | 玩家蛙回起点，提示按记忆点下一叶；正确步prefix+1并锁200ms，保留已经走对的路线和叶上✓；错点立即reveal |
| answer·landing | 200ms，包含在作答内 | 正确新叶原位强调，显示“第{prefix}步 ✓”；玩家蛙落在该叶，全叶暂锁；强调结束后已走痕迹仍保留。最后一步落定后reveal，截止可截断 |
| reveal | 2.4秒 | 保留荷叶及玩家蛙位置，原位显示正误与完整路线；全对、点错、时间到分别显示结果和转场倒数。全程锁输入，结束才进入下一段observe，末段进入settling |
| settling | 3秒 | 本局结束及正确步数，按参与分流 |

- 每段随机排列6叶，取起点＋2/2/3/3/3步，各段内叶不重复；不要求相邻段完全不同。
- 示范每800ms推进；两跳段末叶停留余下800ms，三跳段连续示范。作答回route[0]，不是接示范末叶。
- 只在answer无落定锁时点非当前叶有效；点当前叶、示范期、落定期均无效且不计参与。
- 正确步即刻计入correctSteps、prefix并更新position，再锁200ms；该锁不增加5.4秒。
- 错点保留正确前缀与原位置，不把玩家蛙移到错叶，wrongIndex只供揭晓×，不要求改对。
- 截止前受理的最后正确步有效，即使落定未结束；截止即揭晓，瞬间输入拒绝。有效点非当前叶的段记一次参与，正误均可。

| 反馈触发 | 路线、荷叶与蛙 | 原位文字、持续与去向 |
|---|---|---|
| 点对下一片 | 先更新正确数量和位置；新走对的路径为实线，目的叶出现步骤号与✓并强调；已走对标记保留到本段结束 | 200ms落定锁内提示正在落定；锁结束可继续，不用额外确认；不能以动效为由延长作答 |
| 点错下一片 | 立即冻结本段作答；错叶出现显著×与“点错了”，误尝试为带×的虚线，玩家蛙留在最后正确叶；正确前缀保持实线✓ | “点错了，本段结束”；保留2.4秒，显示到下一段的倒数；不跳回起点、不清空已得正确步数、不要求改对或重做 |
| 本段全对 | 完整已走路径为实线✓，末叶标记全对；不挪动玩家蛙 | “这段走对了，本段结束”；保留2.4秒并显示转场倒数 |
| 时间到 | 保留正确前缀与蛙的位置，揭晓其余正确路线；不虚构错叶或错误尝试线 | “时间到，本段结束”；保留2.4秒并显示转场倒数 |
| 揭晓正确路线 | 已走前缀保持实线与✓；未走的正确后续用较弱的虚线路径、步骤号区分；误尝试虚线带×，不得与正确后续混淆 | 只在reveal显示未走答案；作答和示范期不提前泄露 |
| 中间段揭晓结束 | 揭晓结束前路线和结果不闪退；倒数完成后才清掉该段反馈 | “即将进入第{round+1}段”；自动进入下一段示范，先看完再作答 |
| 第5段揭晓结束 | 同样完整保留最后一段反馈，不再生成下一段 | “即将查看本局结果”；倒数结束进入3秒收束，再按原参与条件分流 |

局部标记由步骤号、实线/虚线、✓/×和文字共同表达，不只依赖颜色或短暂闪光；不新增全屏闪烁、独立结果弹窗或逐步确认按钮。误点已经走过或尚未轮到的荷叶时，保留该叶原步骤信息，另加“这一步点错”标记，不覆盖正确前缀历史。路线覆盖层不拦截点按；起点、当前蛙、正误标记及转场提示在手机画布内完整可见。SVG连线与荷叶使用同一坐标映射，缩放后仍连接实际叶中心。

声音沿现有正确信号：开启时每个受理的正确步只播一次短提示音；错误和超时不新增独立音效。关闭声音时不播放，路线和文字反馈完整保留。减少动态效果时保留相同位置、符号与反馈持续时间，不依赖闪动解释正误。

| 运行字段 | 类型与范围 | 更新规则与用途 |
|---|---|---|
| phase | enum | ready及本节状态，结果result、主动结束quit |
| phaseRemainingMs | number，毫秒≥0 | 当前阶段剩余；退出确认冻结；作答显示一位小数 |
| paused | boolean | 退出确认期间冻结，不提供额外独立暂停页 |
| naturalCompleted | boolean | 达到下述自然结束时为true；此前主动结束或中断为false |
| qualified | boolean | 5段自然结束且participatingRounds.length≥3。 |
| route / position | integer[] / integer0—5 | 本段无重复路线与玩家当前叶 |
| prefix / correctSteps | integer | 本段正确前缀和累计0—13步 |
| wrongIndex | integer／null | 错点叶，未错null |
| frogOutcome | enum | 空串 / success / wrong / timeout；本段揭晓结果，只在结束作答时确定，反馈中不改变 |
| feedbackRemainingMs | number，毫秒，0—2400 | 仅reveal取剩余反馈时间，其他阶段为0；转场倒数由此派生，退出冻结，不因重绘重置 |
| lockRemainingMs | number，毫秒 | 落定锁最多200，且不超过作答剩余 |
| participatingRounds | integer[]，去重 | 有效点非当前叶的段号 |

执行预算：3000+5×(2400+5400+2400)+3000=57000ms；点错或提早完成可缩短。入口45秒仅为预计用时，不截断执行；退出确认冻结时间不计入预算。错误不追加题目或补考。

## 4. 结束、退出、中断与重练

| 条件 | 处理与去向 |
|---|---|
| 开始 | 身份和必填配置有效后按公共§1创建sessionId，直接进入ready，无教程或额外规则确认 |
| 自然结束且合格 | 进入收束；首次按原sessionId提交一次完成事件；重练保存本次表现并关联首次回执 |
| 自然结束但参与不足 | 进入收束，不提交首次有效完成。未完成结果仅原因、本局表现与返回今日行动，不显示完成正文或到账 |
| 未结束，或自然结束但参与不足的收束中点退出 | 先处理当前时刻边界再冻结，显示公共未完成退出确认；继续按本项专属恢复；结束清局回今日行动 |
| 合格收束中点退出 | 保留完成事实、表现与原请求；继续恢复剩余收束，查看结果查询原sessionId，不重复提交 |
| 后台、锁屏、系统关闭 | 自然结束前清局，回前台到今日行动，不按后台时间补判；已自然结束但参与不足也返回今日行动、不提交完成；自然结束且合格则保留结果并查询原sessionId |
| 重练 | 已完成详情进入公共重复提醒，显示不重复奖励及当前X/3；取消留详情，继续创建新repeat session，从ready重来，首次记录不覆盖 |

专属恢复：遮住荷叶区，冻结示范位置、路线、prefix、玩家位置、落定锁、局部反馈及转场倒数；继续原进度，不重抽路线。reveal中退出继续，恢复原正误标记及剩余2.4秒反馈时间，不重新完整计时，也不直接跳下一段。

参与不足原因：“本局已结束。至少三段轮到你时点过其他荷叶，才算完成行动。”

弹层文本、双按钮、焦点与冻结规则采用[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html) §3；确认期间声音和玩法输入均不受理。

## 5. 完成记录与结果字段

| 字段 | 类型 | 生成、读取与约束 |
|---|---|---|
| sessionId / businessDate / repeatSession | string / string / boolean | 开始服务返回，贯穿本局；同一请求重试与查询沿用原sessionId |
| completionStatus | enum／null | 未提交首次完成为null；提交后pending/success/failed/unknown；重练关联首次状态，不提交新的首次完成 |
| completionId / rewardStatus / rewardReceipt | string／null / enum／null / object／null | 完成记录和奖励事务分开；资源、金额、到账目标仅从回执读取 |
| performance | string | 顺序正确{correctSteps}步 |
| completionPolicy | boolean条件 | 5段自然结束且participatingRounds.length≥3。 |
| firstResult | object／null | 所选业务日首次完成会话、表现、完成时间及原回执，重练不可覆盖 |

完成请求包含本项身份、sessionId、businessDate、naturalCompleted、本项参与证据及表现原始字段。qualified只形成完成候选，不代替服务确认。完成去重、3项上限、请求未知与查询采用[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html) §4；结果标题、四层结构、奖励回执与重练新增0采用§5。

待确认时不预填到账数；奖励处理中或失败、未知均查询原completionId，不新建奖励事务。完成明确失败或参与不足时不显示完成正文及到账。查看结果读取首次表现；重练显示本次表现，保持首次记录、回执与今日进度。

## 6. 验收条件

| 操作或边界 | 通过条件 |
|---|---|
| 专项1 | 示范和玩家蛙身份清楚，观察不能点，作答不泄露路线。 |
| 专项2 | 5段步数2/2/3/3/3，新段回本段起点，最大13。 |
| 专项3 | 正确后200ms锁，暂停恢复保留锁剩余。 |
| 专项4 | 错点保留前缀，截止前最后步有效，截止瞬间拒绝。 |
| 专项5 | 全对、点错、超时提示不同，三段错点也可合格。 |
| 路线正误 | 每步正确在落点显示✓并保留已走实线；错误在被点叶显示×与错误尝试，不把蛙移到错叶；作答不泄露后续答案 |
| 错误机制 | 点错立即结束本段但不重做，已得步数不清零；完整揭晓2.4秒且倒数说明下一去向；第5段进入收束而不是再开一段 |
| 揭晓恢复 | 揭晓点按无效；退出继续恢复同一标记、路线和剩余倒数，不因重绘、声音开关或慢帧重新开始反馈 |
| 字段与文案 | 名称、预计时长、身份、奖励与配置总表一致；science两字段逐字匹配；做法常驻展开 |
| 位置与表现 | 提示在玩法区上方，文字不遮对象；无游戏分、百分比和“科学收获”标题 |
| 退出与中断 | 覆盖未结束、合格收束、参与不足收束；继续恢复本项状态，结束和中断去向正确 |
| 服务与重练 | 同一会话不重复完成或发奖，首次记录不被覆盖；查询不阻塞返回且不伪造进度或到账 |
