# 方格位置回忆 PRD

## 1. 行为配置

| 字段 | 类型 | 值与规则 |
|---|---|---|
| catalogKey / section | string | `matrix` / `matrix` |
| behaviorId | string | `com:LS-CP-LUMOSITY:memory-matrix`；用于当日完成去重 |
| variantId | string | `design:minute:memory-matrix-5rounds-progressive-v1`；用于读取玩法配置 |
| behaviorName | string | 方格位置回忆 |
| durationLabel | string | `55秒`；仅用于入口展示，不作为执行截止条件 |
| deviceRequirements | array | 空数组；无需设备准备或权限申请 |
| illustration | 资源引用 | 方格位置回忆配图；复用统一页的3×3网格、第1轮2个亮格示意 |
| science.shared | string | 强化额顶叶记忆网络，稳固空间与短时记忆。 |
| science.completion | string | 认知心理学研究证实，人类视觉工作记忆的平均容量仅限 3 至 4 个独立信息块。你刚才正是针对这一容量瓶颈，深度调用了额顶叶网络的空间驻留功能。 |
| steps | string[] | 按下列顺序展示，常驻展开 |
| rewardType | enum | `inspiration`，显示名称为“灵感” |
| rewardAmount | integer | 12；读取[奖励配置总表](https://fuguang-design.pages.dev/daily-island/prd/rewards.html)，实际增加量读取奖励回执 |

`steps`：

1. 先记住本轮亮起的方格，隐藏后点回它们的位置，不用按顺序。
2. 每轮需选数量会提示，选满本轮数量就会揭晓；选满前，再点已选方格可以取消。
3. 每轮最多8秒作答，到时按已选位置揭晓；答错后继续下一轮。
4. 共5轮，依次记住2、3、3、4、4格，观察时间逐步缩短；至少两轮点选过方格才算完成，不要求全对。

| 玩法参数 | 类型 | 值 |
|---|---|---|
| gridRows / gridColumns | integer | 各3 |
| targetCounts | integer[5] | [2,3,3,4,4]；按round−1读取本轮目标数量 |
| totalRounds | integer | 5 |
| readyMs | integer，毫秒 | 3000 |
| observeMs | integer[5]，毫秒 | [3000,3000,2500,2500,2000]；按round−1读取 |
| answerLimitMs | integer，毫秒 | 8000；选满本轮targetCount提前结束 |
| revealMs | integer，毫秒 | 1500 |
| settleMs | integer，毫秒 | 3000 |
| minimumParticipatingRounds | integer | 2 |

| 轮次 | targetCount | observeMs | answerLimitMs |
|---|---:|---:|---:|
| 1 | 2 | 3000 | 8000 |
| 2 | 3 | 3000 | 8000 |
| 3 | 3 | 2500 | 8000 |
| 4 | 4 | 2500 | 8000 |
| 5 | 4 | 2000 | 8000 |

网格从左上至右下按行编号为0—8。每轮按targetCount随机生成不同目标格；与上一轮目标集合完全相同时换一组，目标数量不变。格子位置在整局内保持不变。

## 2. 页面、字段与操作位置

| 页面 | 区域及顺序 | 字段与操作 |
|---|---|---|
| 今日行动 | 行为卡片左侧 | `illustration` |
| 今日行动 | 卡片右侧上行 | 左侧`behaviorName`，右侧`durationLabel` |
| 今日行动 | 名称下方 | `science.shared` |
| 今日行动 | 卡片资源区 | 灵感图标；完成状态读取当日完成记录 |
| 行为详情 | 页首 | 左上返回今日行动；标题`behaviorName` |
| 行为详情 | 标题下方 | `illustration`→“行为说明”及`science.shared`→“怎么做”及`steps`；步骤不折叠 |
| 行为详情 | 底部固定操作区 | 按下方详情状态表显示按钮 |
| 行为执行 | 顶部工具栏 | 左“退出”，右“声音 开／关” |
| 行为执行 | 工具栏下方 | 标题`behaviorName` |
| 行为执行 | 标题下、网格上方 | `prompt`；当前操作或本轮反馈，允许换行，不覆盖网格 |
| 行为执行 | 中部玩法区 | 3×3等大方格；仅方格区域受理玩法输入 |
| 行为执行 | 底部进度区 | 左侧`第{round} / 5轮`；作答时右侧显示剩余秒数，保留一位小数；其他阶段隐藏剩余作答秒数 |
| 退出／重练确认层 | 执行页或详情页上方 | 居中标题、正文、底部并排双按钮；具体状态见第4节 |
| 完成结果 | 从上到下 | 完成标题、行为名称、本局表现、`science.completion`→资源回执→今日进度→返回今日行动；不显示“科学收获”标题 |
| 未完成结果 | 从上到下 | “本次未完成”、原因、本局表现→“本次进度不保留”→“返回今日行动”；不显示完成文案及奖励区域 |

完成结果的“返回今日行动”固定在底部并立即可用；内容超出可用高度时滚动查看，不遮挡按钮。

| 详情状态 | 底部操作 | 点击结果 |
|---|---|---|
| 今日未完成，完成数小于3 | “开始行动” | 创建新`sessionId`后进入执行内倒数；不经过准备、教程或规则确认页 |
| 开始请求处理中 | “开始行动”禁用 | 不重复创建会话；成功进入倒数，失败留在详情显示原因并允许重试 |
| 今日未完成，完成数为3 | 禁用按钮“今天已完成 3 项行动” | 保持详情 |
| 今日已完成 | 左“查看结果”、右“再练一次” | 查看结果读取当日首次记录；再练进入重复提醒 |
| 奖励处理中或待查询 | 左“查看结果”、右“再练一次” | 奖励查询入口仅放在结果页回执区域 |

返回今日行动时保留原列表滚动位置。

## 3. 执行状态与判定

| phase | 时长与进入条件 | 画面和`prompt` | 输入及下一状态 |
|---|---|---|---|
| `ready` 倒数 | 开始成功后3秒 | 空网格，网格上覆盖3→2→1；提示“先记2格，再逐轮增加到4格，隐藏后点回原位置” | 不受理点格；结束进入第1轮`observe` |
| `observe` 观察 | 本轮observeMs | 本轮targetCount个目标格同时亮起；提示“记住亮起的{targetCount}格” | 不受理点格，不计参与；到时隐藏目标，进入`answer` |
| `answer` 作答 | 每轮不超过8秒 | 未选格不显示目标信息；选中格显示实线边框和实心点。提示“点回刚才亮起的位置，还需选{targetCount−selectedCount}格；选满即揭晓”；已有选择时追加“再点已选格可取消” | 点未选格加入选择，点已选格取消；选满本轮targetCount或到时进入`reveal` |
| `reveal` 揭晓 | 每轮1.5秒 | 选中且正确的格显示✓；选错格显示×；漏选目标显示○及虚线边框；其他格为空。上方显示“本轮记对{roundCorrect}格”；结束时无选择则显示“时间到，本轮未选择，记对0格” | 不受理点格；前4轮结束后轮次加1、清空选择并进入下一轮观察；第5轮结束进入`settling` |
| `settling` 收束 | 3秒 | 提示“本局结束”；玩法区显示“本局表现”及“记对{correctCells}格” | 不受理点格；参与达标进入完成结果，否则进入未完成结果 |

输入与计时：

- 以完整点按的受理时刻判定。只有`answer`且受理时刻严格早于该轮截止时刻的点按有效；截止瞬间及之后不受理。
- 选中或取消不重置计时；本轮第targetCount格受理后立即锁定选择并进入揭晓，不增加确认按钮。
- 到时以当前选择集合判定；未选满仍计入正确格，空集合记0格。每轮只结算一次。
- 第5轮揭晓结束即自然结束；不因答错重开、补题或加时。阶段边界按原定截止推进，不因慢帧延长时窗。
- 声音关闭不改变视觉提示、判定或计时；正误均通过符号表达。

| 运行字段 | 类型与范围 | 更新规则与用途 |
|---|---|---|
| phase | enum | `ready / observe / answer / reveal / settling / result / quit`；决定画面、输入与跳转 |
| prompt | string | 按上方状态表生成当前操作或反馈文案；状态或选择变化时更新 |
| round | integer，1—5 | 每轮揭晓结束后递增；结果保留5 |
| targetCount / observeDurationMs | integer / integer，毫秒 | 取当前轮targetCounts及observeMs；观察与作答提示、选择上限使用同一targetCount |
| targetCells | integer[]，本轮targetCount个不同的0—8 | 进入本轮观察时生成；作答阶段不显示 |
| selectedCells | integer[]，0—targetCount个不同的0—8 | 本轮作答时选中或取消；揭晓后锁定；下一轮清空 |
| phaseRemainingMs | number，毫秒，≥0 | 当前阶段剩余时间；退出确认期间冻结；作答倒计时向上取整至0.1秒显示 |
| roundCorrect | integer，0—targetCount | 揭晓时计算`selectedCells ∩ targetCells`的数量 |
| correctCells | integer，0—16 | 各轮`roundCorrect`之和；仅显示“记对{correctCells}格”，不换算分数或百分比 |
| participatingRounds | integer[]，去重的1—5 | 某轮作答中首次受理选格时加入该轮；之后取消全部选择也不移除 |
| naturalCompleted | boolean | 初值false，第5轮揭晓结束时置为true；此前主动退出或中断保持false；进入收束后不回退 |
| qualified | boolean | `naturalCompleted=true`且`participatingRounds.length≥2` |
| paused | boolean | 仅退出确认期间为true；不提供独立暂停按钮 |

总执行时长上界为`3000 + (3000+3000+2500+2500+2000) + 5×8000 + 5×1500 + 3000 = 66500ms`，不计退出确认冻结时间。选满本轮targetCount可缩短作答；退出冻结不计入时长，入口55秒为预计标签，不截断执行。

## 4. 结束、退出、中断与重练

| 条件 | 状态处理 | 可见内容、操作与去向 |
|---|---|---|
| 自然结束且参与达标 | 进入收束；首次练习按同一`sessionId`提交一次完成事件 | 收束后进入完成结果；完成提交与奖励状态按第5节显示 |
| 自然结束但参与不足 | 进入收束；不提交完成事件，不产生本次奖励 | 未完成结果原因：“本局已结束。至少两轮点选过方格，才算完成行动。”；返回今日行动 |
| 未自然结束时点退出，或参与不足的收束中点退出 | 先处理点击时刻已到达的阶段边界，再冻结阶段、计时和输入；遮住网格内容，不提交完成事件 | 标题“结束本次行动？”；首次正文“结束后，本局进度将清除。”；重练正文追加“首次完成记录保持不变。”；左“继续行动”，右“结束本次” |
| 退出确认中继续 | 关闭确认层，恢复原阶段、目标、选择及剩余时间 | 重新显示网格；不重新给予完整观察或作答时间 |
| 退出确认中结束 | `phase=quit`，清除本局过程数据；不提交完成事件 | 返回今日行动；已有首次记录与回执保持不变 |
| 收束中已满足参与条件时点退出 | 冻结收束；保留本局表现及原完成请求 | 标题“本局已结束”，正文“本局练习结果已保留，可以继续查看。”；左“继续行动”恢复剩余收束，右“查看完成结果”进入结果并查询原`sessionId` |
| 后台、锁屏或系统关闭，尚未自然结束 | 结束会话并清除过程数据；不把后台时间记为超时作答 | 回前台返回今日行动；重新开始创建新会话并从第1轮倒数开始 |
| 后台、锁屏或系统关闭，已自然结束但参与不足 | 保留无效会话状态，不提交完成 | 回前台返回今日行动 |
| 后台、锁屏或系统关闭，已自然结束且参与达标 | 保留本局表现、同一完成请求和回执 | 回前台进入结果；提交结果未知时查询原`sessionId` |
| 已完成详情点再练一次 | 显示重复提醒 | 标题“重复练习提醒”；正文“今天已完成此行动。再练不会重复获得奖励，今日进度保持{completedCount}/3。”；左“取消”返回详情，右“继续练习”创建新`sessionId`、`repeatSession=true`并进入倒数 |
| 重练自然结束且参与达标 | 保存本次表现；不覆盖当日首次表现、完成记录及奖励回执 | 结果标题“本次练习完成”；显示本次“记对X格”和完成文案，奖励区读取首次回执、本次新增0，今日进度不变 |

退出弹层出现后焦点进入弹层，Tab焦点限定在两个按钮内；取消或继续后回到原操作区域。冻结期间声音及网格输入均不受理。

## 5. 完成记录与结果字段

| 字段 | 类型 | 生成、读取及约束 |
|---|---|---|
| businessDate | string，`YYYY-MM-DD` | 开始会话时由服务返回的业务日期；本次完成沿用该日期 |
| sessionId | string | 开始成功时生成；关联本局表现、完成请求与查询；请求重试沿用原值 |
| repeatSession | boolean | 当日该行为已有完成记录时为true；本次练习不新增奖励或今日完成数 |
| completionId | string或null | 服务确认首次有效完成后返回；未确认前为null |
| completedAt | 带时区的ISO 8601时间或null | 服务确认首次完成时返回；用于已完成详情和结果 |
| completionStatus | enum或null | 首次完成请求发出前为null，发出后为pending；响应确定为success或failed，响应结果无法确定为unknown；重练读取首次记录状态，不发起新的首次完成提交 |
| failureReason | string或null | 完成提交明确失败时服务返回的可展示原因；其他状态为null |
| rewardStatus | enum或null | `pending / success / failed / unknown`；由奖励事务返回，尚无完成记录时为null |
| rewardReceipt | object或null | 服务返回的资源类型、实际增加量及到账目标标识；不以配置金额代替实际回执 |
| completedCount | integer，0—3 | 服务端当日已完成的不同行为数；本局正确数量不参与计算 |
| firstResult | object或null | 当日首次完成记录，含`sessionId`、`completionId`、`completedAt`、`correctCells`及`completedCountAtCompletion`；无首次记录时为null；重练不得覆盖 |
| firstResult.completedCountAtCompletion | integer，1—3 | 首次完成时的当日完成数；1或2对应“行动完成”，3对应“今日目标已完成”；后续进度增加不改变首次结果标题 |

首次完成请求包含本次`sessionId`、`businessDate`、`behaviorId`、`variantId`、`naturalCompleted`、`participatingRounds`及`correctCells`。相同`sessionId`不重复创建完成记录或奖励事务；服务校验当日行为去重与3项上限。

| 结果条件 | 第一层：标题、表现及完成文案 | 第二层：资源回执 | 第三层：今日进度 |
|---|---|---|---|
| 首次完成请求处理中或结果未知 | “完成状态确认中”、行为名称、“记对X格”、完成文案 | “待确认”；不显示已到账或预填+12；提供“查询完成状态”，使用原`sessionId` | 未取得服务确认前不增加；显示已有确认值，无值时显示“待确认” |
| 服务确认首次完成，为当日第1或第2项 | “行动完成”、行为名称、“记对X格”、完成文案 | 按下方奖励状态表显示 | 服务返回的`completedCount / 3` |
| 服务确认首次完成，为当日第3项 | “今日目标已完成”、行为名称、“记对X格”、完成文案 | 同上 | `3 / 3` |
| 完成提交明确失败 | “本次未完成”、服务返回的可展示原因、本局表现；不显示完成文案 | 不显示本次奖励 | 刷新服务端实际值，不自行增加 |
| 重练完成 | “本次练习完成”、行为名称、本次“记对X格”、完成文案 | 首次奖励回执＋“本次新增0” | 沿用原值 |
| 从已完成详情查看结果 | 读取首次完成记录的标题、表现与完成文案 | 查询首次`completionId`的当前回执 | 读取当前业务日进度 |

| rewardStatus | 回执区域内容与操作 |
|---|---|
| `success` | 显示实际增加的灵感数量及“已到账”，不再显示查询按钮 |
| `pending` | “奖励处理中”＋“查询奖励状态”；查询原`completionId` |
| `failed / unknown` | “奖励待查询”＋“查询奖励状态”；查询原`completionId`，不重新创建奖励事务 |

查询只刷新对应状态区域，不重开练习。任何结果状态下“返回今日行动”立即可用；返回后刷新列表、完成进度和奖励状态。

## 6. 验收条件

| 操作或边界 | 通过条件 |
|---|---|
| 从卡片进入并开始 | 入口显示55秒；方法常驻展开；创建会话后直接进入3秒倒数，无设备准备或额外确认页 |
| 五轮递增 | 亮格数依次2/3/3/4/4，观察时长3/3/2.5/2.5/2秒；每轮作答最多8秒；3×3位置全局不变 |
| 观察、揭晓或收束时点格 | 不改变选择、正确数量和参与轮次 |
| 作答时选中后取消 | 当前选择恢复；计时不重置，该轮参与记录仍保留 |
| 选满本轮目标数 | 立即进入揭晓，只结算一次；后续点按不改变结果 |
| 截止前、截止瞬间、截止后点按 | 截止前受理；截止瞬间及之后拒绝，不延长作答时间 |
| 选择包含正确、错误、遗漏目标 | 揭晓同时正确显示✓、×、○；本轮数量等于选择与目标的交集 |
| 只选部分格或空选至到时 | 部分选择正常累计正确格；空选为0格；自动继续下一轮 |
| 仅一轮反复选择；两轮各选择后全部取消 | 前者参与不足；后者自然结束后参与达标；正确数量均不决定参与资格 |
| 退出后继续或结束 | 确认层遮挡网格并冻结；继续恢复原内容与剩余时间，结束清局返回列表 |
| 自然结束前后发生系统中断 | 前者不续局、不记完成；后者参与达标时保留同一完成请求并进入结果 |
| 完成或奖励请求超时后查询 | 沿用原`sessionId`或`completionId`，不重复完成或发奖 |
| 查看首次结果后重练 | 首次表现及回执不被覆盖；重练显示本次正确数量，不增加进度和奖励 |
| 检查完成结果 | 仅显示正确格数，无游戏分、百分比和“科学收获”标题；完成正文逐字匹配配置 |
| 手机视口检查 | 操作和反馈位于网格上方，文字换行不遮格；进度在左、作答秒数在右，返回按钮可见可用 |
