# 变色方块反应 PRD

## 1. 行为配置

| 字段 | 类型 | 值与规则 |
|---|---|---|
| catalogKey | string | `signal_reaction`；配置与呈现键 |
| taskId | string | `design:minute:color-signal-reaction-v1`；不代填正式身份 |
| behaviorId | string／null | `design:minute:color-signal-reaction-v1`；当日完成去重 |
| variantId | string／null | `design:minute:color-signal-reaction-v1`；读取本玩法配置 |
| behaviorName | string | 变色方块反应 |
| categoryId | enum | `attention` |
| steps | string[] | 按下列顺序常驻展开 |
| durationLabel | string | `25秒`；入口预计展示值，不能作为执行截止 |
| deviceRequirements | array | []；无设备准备或权限 |
| illustration | 资源引用 | 变色方块反应配图；配置为可访问资源 |
| science.shared | string | 激活大脑视觉警觉网络，提升注意力敏锐度与信息响应速度。 |
| science.completion | string | 人类对单一视觉信号的生理反应时约为 200 至 250 毫秒。刚才的随机等待与捕捉，正在调用右侧额顶警觉网络，维持大脑的高敏锐度状态。 |
| rewardType | enum | `inspiration`；显示“灵感” |
| rewardAmount | integer／null | 10；首次有效完成配置值，到账数只读服务回执 |

`steps`：

1. 灰块显示“等一下”时先别点。
2. 变蓝显示“现在点”后尽快按一下方块。
3. 按早或未及时按下直接结束本轮，看清反馈后继续。
4. 共5轮，至少3轮在信号后及时按下才算完成。

| 玩法参数 | 类型 | 值与约束 |
|---|---|---|
| totalRounds / minimumValidSignalRounds | integer | 5 / 3 |
| readyMs / settleMs | integer，毫秒 | 各3000 |
| waitingRangeMs | number[2] | [1500,2300]；每轮独立随机 |
| responseMs / feedbackMs | integer，毫秒 | 2000 / 500 |

## 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秒 | 倒数，灰色先等变蓝再点，不受理 |
| waiting | 随机1.5—2.3秒 | □等一下；新按下→early，信号实际呈现→signal |
| signal | 最多2秒 | ■现在点；首个新按下早于截止→hit，满2秒→missed |
| hit / early / missed | 各0.5秒 | 分别显示毫秒数、还没到信号、本轮未响应；锁输入，前4轮后等待，第5轮后收束 |
| settling | 3秒 | 本局结束及有效轮数，随后按参与分流 |

- 仅方块内新的pointerdown有效；长按、跨阶段按住、开始按钮原按压、场外不计，多指只取本轮第一个。
- 反应时从实际呈现signalAtMs起计，有效区间[signalAtMs,signalAtMs+2000)。2000ms瞬间记missed，不能hit。
- 按下不能把尚未呈现的waiting先推进成signal再记命中；每轮只产生一个终态。提前点直接结束本轮，不重抽补考。
- validRounds仅计hit；averageMs只对hit求均值，无hit为null显示“—”。early及missed不计参与。
- 不显示速度换算分数、百分比或排名。

| 运行字段 | 类型与范围 | 更新规则与用途 |
|---|---|---|
| phase | enum | ready及本节状态，结果result、主动结束quit |
| phaseRemainingMs | number，毫秒≥0 | 当前阶段剩余；退出确认冻结；作答显示一位小数 |
| paused | boolean | 退出确认期间冻结，不提供额外独立暂停页 |
| naturalCompleted | boolean | 达到下述自然结束时为true；此前主动结束或中断为false |
| qualified | boolean | 5轮自然结束且validRounds≥3。 |
| round / signalAtMs | integer1—5 / number／null | 轮次及实际信号帧时刻，waiting时null |
| attempts | object[] | 每轮一条{round,status:hit/early/missed,reactionMs:number／null} |
| validRounds / averageMs | integer0—5 / number／null | hit数及有效反应时均值，显示整数毫秒 |

执行预算：计入结果的5轮：3000+5×(2300+2000+500)+3000=30000ms；不含作废重来的未判定片段。 不计确认层冻结时间；错误不追加题目、补考或加时。

## 4. 结束、退出、中断与重练

| 条件 | 处理与去向 |
|---|---|
| 开始 | 身份和必填配置有效后按公共§1创建sessionId，直接进入ready，无教程或额外规则确认 |
| 自然结束且合格 | 进入收束；首次按原sessionId提交一次完成事件；重练保存本次表现并关联首次回执 |
| 自然结束但参与不足 | 进入收束，不提交首次有效完成。未完成结果仅原因、本局表现与返回今日行动，不显示完成正文或到账 |
| 未结束，或自然结束但参与不足的收束中点退出 | 先处理当前时刻边界再冻结，显示公共未完成退出确认；继续按本项专属恢复；结束清局回今日行动 |
| 合格收束中点退出 | 保留完成事实、表现与原请求；继续恢复剩余收束，查看结果查询原sessionId，不重复提交 |
| 后台、锁屏、系统关闭 | 自然结束前清局，回前台到今日行动，不按后台时间补判；已自然结束但参与不足也返回今日行动、不提交完成；自然结束且合格则保留结果并查询原sessionId |
| 重练 | 已完成详情进入公共重复提醒，显示不重复奖励及当前X/3；取消留详情，继续创建新repeat session，从ready重来，首次记录不覆盖 |

专属恢复：waiting或signal被打断，继续仅作废本轮未判片段并重新随机等待，已判轮不重开；ready、反馈、收束恢复剩余。作废不记early或missed。

参与不足原因：“本局已结束。至少3轮在方块变蓝后及时按下，才算完成行动。”

弹层文本、双按钮、焦点与冻结规则采用[公共页面与结算](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 | 有效反应{validRounds}轮；有效平均用时{averageMs或“—”}毫秒 |
| completionPolicy | boolean条件 | 5轮自然结束且validRounds≥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 | 提前点、hit、未响应文字不同，灰度仍可辨信号。 |
| 专项2 | 跨阶段长按不计，松手后新按下才可能受理。 |
| 专项3 | 1999ms有效，2000ms记missed，同轮不重复。 |
| 专项4 | 未判片段退出继续从waiting重来，已判轮不重开。 |
| 专项5 | 3轮hit合格，2轮不足，均值只含hit。 |
| 字段与文案 | 名称、预计时长、身份、奖励与配置总表一致；science两字段逐字匹配；做法常驻展开 |
| 位置与表现 | 提示在玩法区上方，文字不遮对象；无游戏分、百分比和“科学收获”标题 |
| 退出与中断 | 覆盖未结束、合格收束、参与不足收束；继续恢复本项状态，结束和中断去向正确 |
| 服务与重练 | 同一会话不重复完成或发奖，首次记录不被覆盖；查询不阻塞返回且不伪造进度或到账 |
