# 图形拼合 PRD

## 1. 行为配置

| 字段 | 类型 | 值与规则 |
|---|---|---|
| catalogKey | string | `shape_fit`；配置与呈现键 |
| taskId | string | `com:LS-CP-LUMOSITY:masterpiece`；不代填正式身份 |
| behaviorId | string／null | `com:LS-CP-LUMOSITY:masterpiece`；当日完成去重 |
| variantId | string／null | `design:20261011:masterpiece-fit-v1`；读取本玩法配置 |
| behaviorName | string | 图形拼合 |
| categoryId | enum | `logic` |
| steps | string[] | 按下列顺序常驻展开 |
| durationLabel | string | `50秒`；入口预计展示值，不能作为执行截止 |
| deviceRequirements | array | []；无设备准备或权限 |
| illustration | 资源引用 | 图形拼合配图；配置为可访问资源 |
| science.shared | string | 调动顶叶空间整合网络，提升结构思维与全局布局能力。 |
| science.completion | string | 空间认知研究显示，将局部几何图形无重叠地整合进整体框架，核心依赖后顶叶皮层（PPC）的视觉空间加工机制。刚才的拼合尝试，正是在锻炼大脑对部分与整体关系的空间筹划。 |
| rewardType | enum | `inspiration`；显示“灵感” |
| rewardAmount | integer／null | 15；首次有效完成配置值，到账数只读服务回执 |

`steps`：

1. 把三角形和四边形拼进上方不规则轮廓，不能重叠或超出边界。
2. 点一块选中，再点旋转改朝向；按住拖动，放不下回原位。
3. 已放图块可再拖或拖回下方；轮廓内不显示答案分割线。
4. 共两幅，先3块再5块，拼成或到时自动继续。

| 玩法参数 | 类型 | 值与约束 |
|---|---|---|
| totalRounds / pieceCounts | integer / integer[] | 2 / [3,5] |
| readyMs / settleMs | integer，毫秒 | 各3000 |
| boardLimitsMs / feedbackMs | integer[] / integer，毫秒 | [24000,28000] / 1200 |
| rotationStep / reflection | integer / boolean | 90度 / false |
| snapUnit / minimumDistinctAttempts | number / integer | 0.5坐标单位 / 2 |

## 2. 页面、字段与操作位置

| 页面或区域 | 字段、位置与操作 |
|---|---|
| 今日行动 | 卡片左侧配图；右侧名称＋预计时长，名称下方science.shared；资源区为灵感图标和服务完成状态 |
| 详情 | 名称→配图→“行为说明”及science.shared→“怎么做”及steps→底部主操作；步骤常驻展开 |
| 详情操作 | 未完成且今日名额可用：开始行动；开始处理中禁用防重复。今日已完成：左查看结果、右再练一次。3/3禁用未完成项，历史日只读 |
| 执行顶部 | 左退出、右声音；名称下方、玩法区上方显示当前prompt或结果提示，可换行但不覆盖操作对象 |
| 执行中部 | 上方凸不规则轮廓，下方多行图块托盘，中间旋转按钮；图块字母与选中加粗描边。拖动有原尺寸跟手图和合法预览，不提示答案。 |
| 执行底部 | 左第{round}/2幅，右本幅剩余；反馈保持该幅与已放片数。 |
| 结果 | 完成标题→名称→本局表现→science.completion→资源回执→今日进度→固定返回今日行动；不显示“科学收获”标题；内容可滚动，返回立即可用 |

入口、详情、历史日期与列表滚动恢复采用[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html) §1，执行容器采用§2。

## 3. 执行状态与判定

| phase／子状态 | 时长与条件 | 画面、输入、反馈及转移 |
|---|---|---|
| ready | 3秒 | 首轮3片和轮廓，倒数，不能选择或拖动 |
| play·选择旋转 | 本幅时限内 | 点片选中，再点可取消；按钮每次90度，托盘可自由转，已放片转后须合法 |
| play·拖动 | 同一时间一片 | 按住位移跟手，显示合法落点预览；只点不计拖入尝试 |
| play·松手 | 严格早于截止 | 合法吸附，非法回提交前位置，托盘松手取出；全部合法置入即拼成 |
| feedback | 每幅1.2秒 | 拼成了或时间到，保留已放片数量，锁输入；首幅后5片新图，末幅后收束 |
| settling | 3秒 | 本局结束及拼成幅数，按尝试键数量分流 |

- 使用下方目标和片顶点；凸多边形平移与90度旋转，不镜像，不能替换成4×4四格拼盘。
- 原点以目标中心(0,0)，松手坐标吸附0.5单位。旋转平移后所有顶点在边界内，且与其他已放片无正面积重叠才合法；共边共顶可放。
- 拖起已放片时验证排除自身旧占位，非法松手恢复原提交状态；已放片旋转不合法则保持原角度，提示先回托盘旋转。
- 全部片合法置入即拼成，片面积之和等于目标面积；不限校验解的位置，不显示内部答案线。
- 参与键=boardId＋pieceId；原在托盘的片真实拖入轮廓交互区松手记一次，失败也计。点、旋转、同片重复、场外松手不增加。
- 到时尚未松手取消拖动并恢复已提交状态；跨幅pointerup无效；松手在手机左右场外不能误认为托盘。

| 运行字段 | 类型与范围 | 更新规则与用途 |
|---|---|---|
| phase | enum | ready及本节状态，结果result、主动结束quit |
| phaseRemainingMs | number，毫秒≥0 | 当前阶段剩余；退出确认冻结；作答显示一位小数 |
| paused | boolean | 退出确认期间冻结，不提供额外独立暂停页 |
| naturalCompleted | boolean | 达到下述自然结束时为true；此前主动结束或中断为false |
| qualified | boolean | 两幅各因拼成或到时自然收束，且attemptKeys.length≥2。 |
| board / round | object / integer1—2 | 目标、pieces、初始角度及当前幅 |
| placements | object，pieceId→{x,y}或null | 已提交图块原点，托盘中null |
| angles / selected | object / string／null | 各片0—3个90度及选择id |
| attemptKeys | string[]，去重 | 原托盘到轮廓区松手的题目＋图块键 |
| history / solvedCount | object[] / integer0—2 | 每幅{solved,placed,total}及拼成幅数 |

执行预算：3000+24000+1200+28000+1200+3000=60400ms，拼成可提前。 不计确认层冻结时间；错误不追加题目、补考或加时。

几何配置（轮廓中心为原点，逆时针顶点；angles为90度次数）：

| 幅 | target | pieces与angles |
|---|---|---|
| 1 | [[-2,-1],[0,-2],[2,0],[0,2]] | A:[[0,0],[-2,-1],[0,-2],[2,0]]；B:[[0,0],[2,0],[0,2]]；C:[[0,0],[0,2],[-2,-1]]；angles=[1,3,2] |
| 2 | [[-2,-1],[-1,-2],[1,-2],[2,0],[1,2],[-1,1]] | A:[[0,0],[-2,-1],[-1,-2],[1,-2]]；B:[[0,0],[1,-2],[2,0]]；C:[[0,0],[2,0],[1,2]]；D:[[0,0],[1,2],[-1,1]]；E:[[0,0],[-1,1],[-2,-1]]；angles=[1,3,2,1,3] |

所有片及目标为凸体，面积之和等于目标面积，正确解无正面积重叠；容差1e-7。

## 4. 结束、退出、中断与重练

| 条件 | 处理与去向 |
|---|---|
| 开始 | 身份和必填配置有效后按公共§1创建sessionId，直接进入ready，无教程或额外规则确认 |
| 自然结束且合格 | 进入收束；首次按原sessionId提交一次完成事件；重练保存本次表现并关联首次回执 |
| 自然结束但参与不足 | 进入收束，不提交首次有效完成。未完成结果仅原因、本局表现与返回今日行动，不显示完成正文或到账 |
| 未结束，或自然结束但参与不足的收束中点退出 | 先处理当前时刻边界再冻结，显示公共未完成退出确认；继续按本项专属恢复；结束清局回今日行动 |
| 合格收束中点退出 | 保留完成事实、表现与原请求；继续恢复剩余收束，查看结果查询原sessionId，不重复提交 |
| 后台、锁屏、系统关闭 | 自然结束前清局，回前台到今日行动，不按后台时间补判；已自然结束但参与不足也返回今日行动、不提交完成；自然结束且合格则保留结果并查询原sessionId |
| 重练 | 已完成详情进入公共重复提醒，显示不重复奖励及当前X/3；取消留详情，继续创建新repeat session，从ready重来，首次记录不覆盖 |

专属恢复：取消未提交拖动并恢复原状态；冻结本幅时限、角度、选择及1.2秒反馈。继续最后提交布局，不重抽或回新幅。

参与不足原因：“本局已结束。至少把两块不同图形拖进轮廓试试，才算完成行动。”

弹层文本、双按钮、焦点与冻结规则采用[公共页面与结算](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 | 拼成{solvedCount}幅图形 |
| completionPolicy | boolean条件 | 两幅各因拼成或到时自然收束，且attemptKeys.length≥2。 |
| firstResult | object／null | 所选业务日首次完成会话、表现、完成时间及原回执，重练不可覆盖 |

完成请求包含本项身份、sessionId、businessDate、naturalCompleted、本项参与证据及表现原始字段。qualified只形成完成候选，不代替服务确认。完成去重、3项上限、请求未知与查询采用[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html) §4；结果标题、四层结构、奖励回执与重练新增0采用§5。

待确认时不预填到账数；奖励处理中或失败、未知均查询原completionId，不新建奖励事务。完成明确失败或参与不足时不显示完成正文及到账。查看结果读取首次表现；重练显示本次表现，保持首次记录、回执与今日进度。

## 6. 验收条件

| 操作或边界 | 通过条件 |
|---|---|
| 专项1 | 3片→5片，均含三角和四边形，初始朝向需旋转，轮廓无答案线。 |
| 专项2 | 选择和真实拖放分别工作，每次旋转90度。 |
| 专项3 | 共边合法，越界或重叠拒绝并恢复原位。 |
| 专项4 | 可拖回托盘，场外不误清除，跨幅松手无效。 |
| 专项5 | 两幅各1.2秒反馈，至少两种尝试键才合格。 |
| 字段与文案 | 名称、预计时长、身份、奖励与配置总表一致；science两字段逐字匹配；做法常驻展开 |
| 位置与表现 | 提示在玩法区上方，文字不遮对象；无游戏分、百分比和“科学收获”标题 |
| 退出与中断 | 覆盖未结束、合格收束、参与不足收束；继续恢复本项状态，结束和中断去向正确 |
| 服务与重练 | 同一会话不重复完成或发奖，首次记录不被覆盖；查询不阻塞返回且不伪造进度或到账 |
