2.8 KiB
2.8 KiB
方洞挑战拖拽玩法重构 2026-05-05
1. 目标
把方洞挑战从“按洞口按钮点选”改成“拖拽形状到目标洞口”的玩法，同时把洞口选项与形状选项的编辑关系改成稳定 ID + 名称联动。
2. 编辑态规则
- 洞口选项不再暴露
square / circle / triangle之类的下拉框。 - 每个洞口选项只保留稳定
holeId、可编辑名称label，以及可选图片字段。 - 洞口名称改动后，所有引用该洞口的形状选项下拉框必须同步显示新名称。
- 形状选项不再直接绑定洞口“形状类型”，而是绑定一个目标洞口
targetHoleId。 - 形状选项下拉框展示的是洞口名称，底层值是
targetHoleId。 - 形状选项仍保留自己的视觉配置字段，如
shapeKind、imagePrompt、imageSrc。 - 去掉加分选项，所有洞口选项一律平权。
3. 运行态规则
- 运行态上半区展示全部洞口，布局成一块平面。
- 下半区展示当前轮次的形状选项。
- 每轮随机选择一个形状选项作为当前轮显示项，并以它绑定的
targetHoleId作为目标洞口。 - 箭头动画只负责给出随机引导洞口，不绑定正确答案；多洞口时优先避开当前正确洞口，避免直接剧透。
- 用户把当前形状拖到任意洞口上松开后，前端把该洞口的
holeId提交给后端。 - 后端以
holeId === currentShape.targetHoleId作为唯一判定标准。 - 命中后进入下一轮；未命中时后端返回错误反馈、清空连击并保留当前运行态。
- 计分不再包含任何加分洞口分支。
- 游戏模式下洞口和当前选项只展示图片卡片，不再按
shapeKind/holeKind裁剪成圆形、三角形、星形等几何形状。
4. 图片槽位
- 封面图、背景图、形状图、洞口图都使用独立图片槽位。
- 洞口图对应新的历史素材类型
square_hole_hole_image。 - 图片槽位查看面板内保留历史图片、上传入口和 AI 生成入口。
5. 后端契约要求
- 共享契约里补充形状到洞口的目标引用字段。
- 共享契约里补充洞口图片字段。
- 运行态快照里必须包含当前形状对应的目标洞口信息，便于前端画箭头。
- 作品和草稿返回的洞口数据必须和运行态保持同一组 ID 与名称。
6. 验收标准
- 编辑洞口名称后，形状下拉框立即显示新名称。
- 洞口编辑不再出现
square / circle / triangle下拉框。 - 运行态不再是按钮点选洞口，而是拖拽命中。
- 每轮都能看到箭头或高亮引导洞口，但该引导不等同于正确答案。
- 计分中不再出现
bonus相关加分。 - 游戏模式中洞口、当前选项和拖拽影子不再显示几何形状，只显示对应图片或中性图片占位。