feat: 收敛玩法运行时配置并加入故障恢复

doc/games/积分赛/游戏配置项.md

@@ -0,0 +1,54 @@
+# 积分赛游戏配置项
+
+本文档用于汇总当前系统对 `score-o` 的已支持可配置项，重点只看和积分赛玩法直接相关的字段。
+
+说明：
+
+- 跨玩法公共字段请继续参考 [配置选项字典](D:/dev/cmr-mini/doc/config/配置选项字典.md)
+- 本文只补积分赛视角下最常用、最关键的字段
+
+## 1. 顶层与样例入口
+
+| 字段 | 作用 | 默认逻辑 |
+| --- | --- | --- |
+| `game.mode` | 指定玩法模式 | 固定为 `score-o` |
+| `event/score-o.json` | 当前联调样例 | 可直接运行 |
+
+## 2. 点位与分值
+
+| 字段 | 作用 | 可选项 / 取值 | 默认逻辑 |
+| --- | --- | --- | --- |
+| `playfield.controlOverrides.<key>.score` | 单个积分点分值 | `number` | 未配置时回退到 `game.scoring.defaultControlScore`，再回退到玩法默认 `10` |
+| `playfield.controlOverrides.<key>.title` | 打点后内容卡标题 | `string` | 未配置时走系统默认文案 |
+| `playfield.controlOverrides.<key>.body` | 打点后内容卡正文 | `string` | 未配置时走系统默认文案 |
+| `playfield.controlOverrides.<key>.autoPopup` | 打点后是否先弹内容卡 | `true` / `false` | 默认 `true`；即使关闭，普通点默认题卡仍会自动进入 |
+
+## 3. 选点与打点
+
+| 字段 | 作用 | 可选项 / 取值 | 默认逻辑 |
+| --- | --- | --- | --- |
+| `game.punch.policy` | 打点方式 | `enter` / `enter-confirm` | 默认 `enter-confirm` |
+| `game.punch.radiusMeters` | 打点半径 | `number` | 默认 `5` |
+| `game.punch.requiresFocusSelection` | 是否必须先选目标点 | `true` / `false` | 默认 `true` |
+| `game.guidance.allowFocusSelection` | 是否允许点击地图切换目标点 | `true` / `false` | 默认 `true` |
+
+## 4. 结束与结算
+
+| 字段 | 作用 | 可选项 / 取值 | 默认逻辑 |
+| --- | --- | --- | --- |
+| `game.finish.finishControlAlwaysSelectable` | 终点是否始终可打 | `true` / `false` | 默认 `true` |
+| `game.session.autoFinishOnLastControl` | 最后一个积分点后是否自动结束 | `true` / `false` | 默认 `false` |
+| `game.session.requiresFinishPunch` | 是否要求打终点才结束 | `true` / `false` | 当前默认 `false` |
+
+## 5. 默认答题逻辑
+
+当前普通积分点会自动进入默认题卡流程，默认口径如下：
+
+- 倒计时 `10` 秒
+- 默认随机数学题
+- 答对加该点同分奖励
+- 答错或超时不得奖励分
+
+详细规则请看：
+
+- [规则说明文档](D:/dev/cmr-mini/doc/games/积分赛/规则说明文档.md)