feat: add production campaigns, gameplay labs, and review documentation

README.md

@@ -2,7 +2,13 @@
 
 一款竖屏六角轨道解谜游戏：观察路线，点击箭头棋子让它离场；免费旋转底盘和尝试路线，在清楚的反馈中逐步清空棋盘。
 
-项目使用原生 JavaScript ES modules 和 Canvas，无第三方运行依赖，无在线字体或 CDN。选关窗口提供 v0.1 最初 24 关、v0.2 直线较多的 48 关与 v0.3 当前弯轨 48 关；默认 v0.3，按 8 章 × 6 拍制作。另有关卡工坊、求解器、确定性关卡生成器，以及 Cocos Creator 适配示例。
+项目使用原生 JavaScript ES modules 和 Canvas，无第三方运行依赖，无在线字体或 CDN。选关窗口提供 v0.1 最初 24 关、v0.2 直线较多的 48 关、v0.3 弯轨 48 关、v0.4「长路与惊喜」20 关，以及 v0.5「千段轨迹」1000 关。新玩家默认 v0.5，已有版本选择继续保留。另有关卡工坊、求解器、确定性关卡生成器，以及 Cocos Creator 适配示例。
+
+v0.5 按 20 章 × 50 关组织花瓣、环绕、螺旋、回折、编织、双叶交叉六类真实路线，穿插巡游、清挡、反差、换路和分段释放。沿用主游戏的快速连点与并行离场。每关保存构造配方、正式解、体验解与 20 种顺序回放；制作与验收范围见 [千关制作报告](docs/v0.5-production-report.md)。
+
+正式第 1 关前另有 3 关入门序章：单棋子沿弯路离场、两棋子清挡连点、旋转底盘找出口。三课都使用与正式第 1 关相同的完整 19 格六边形棋盘，分别只放 1、2、2 枚棋子。新玩家从序章开始，教学单独存档，原 1–1000 编号与完成记录保持原位；选关窗口可以重玩教学。[开始教学](http://localhost:4173/?campaign=v0.5&tutorial=1)，[教学设计与验证](docs/tutorial-prologue.md)。明确的 `?level=1` 链接仍直达正式第 1 关。
+
+v0.4 按 4 组 × 5 关安排长路巡游、朝内棋子一次旋转放行、短路清挡和往返换路。设计依据见 [新版关卡设计准则](docs/level-design-principles-v2.md)，逐关制作意图与完整操作证据见 [v0.4 体验报告](docs/v0.4-experience-review.md)。长路径本身是观看内容，轻巧反差也可通过短路径兑现；不按难度分对关卡排序。
 
 后续关卡优化的原始设计参照见 [v0.1 · 最初 24 关设计理念](docs/v0.1-design-philosophy.md)：还原必要旋转、空间让路与分阶段解开轨道的结构，并区分历史规则、实际布局和本次设计归纳。
 
@@ -19,6 +25,9 @@ npm run dev
 打开 [游戏](http://localhost:4173/)。请通过 HTTP 访问，直接双击 HTML 文件无法正常加载 ES modules。开发服务监听 `0.0.0.0`，同一局域网的手机可通过电脑 IP 和端口访问。
 
 - [关卡工坊](http://localhost:4173/?editor=1)：当前精简游戏界面隐藏工坊导航，通过此地址进入。
+- [千关版](http://localhost:4173/?campaign=v0.5&level=1)：按章选关或直接输入 1–1000；URL 的关号从 1 开始。
+- [千关审核页](http://localhost:4173/labs/campaign-review/index.html)：按章看布局，检查制作证据，逐步回放和导出本章总览。
+- [花形轨道测试](http://localhost:4173/labs/flower/index.html)：双层十二瓣与三重环带编织成花，包含 10 枚棋子的独立可玩实验，详见 [设计说明](docs/flower-study.md)。
 - [交互设计规范](http://localhost:4173/Design.html)：色板、图标、组件状态与动效示例。
 - 修改端口：`PORT=4174 npm run dev`。
 
@@ -30,15 +39,15 @@ npm run dev
 - 只有成功移除棋子消耗 1 次预算；旋转和失败试路均免费。主线预算等于初始棋子数，只表示剩余消除工作量，不惩罚试错。撤销恢复棋盘、棋子、朝向和计数；没有倒计时。
 - 提示会高亮可安全离场的棋子，或建议旋转方向。棋子配色不影响规则。
 
-主线每章按“进入 → 换路 → 展开 → 小挑战 → 释放 → 长局回报”安排，不按难度分数单调排序，也不要求每关必须旋转。早期就可使用 37 格棋盘，后期舒缓关使用 61 格延长熟悉操作的体验；19 格小棋盘也可承担局部挑战。棋盘规模与认知难度分别记录。
+v0.3 每章按“进入 → 换路 → 展开 → 小挑战 → 释放 → 长局回报”安排，不按难度分数单调排序，也不要求每关必须旋转。早期就可使用 37 格棋盘，后期舒缓关使用 61 格延长熟悉操作的体验；19 格小棋盘也可承担局部挑战。棋盘规模与认知难度分别记录。
 
 9 月 9 日版的 48 关以真正的弯轨消除为主：每关参考解答至少 65% 的成功离场棋子经过弯道，且不少于 3 枚。直线只作少量节奏调剂，不安排纯直出关，也不用空格上的装饰曲线充数。当前单关最多 25 枚棋子，后期长局增加的是沿弯轨观察与解开的实际内容。
 
-第 1 关为 37 格、8 枚棋子，开局全部可离场，每枚参考路径恰好转弯一次，无需旋转；“全部可离场”不表示任意朝向都相同。前 7 关通过 `lesson` 字段依次学习箭头起步与弯轨转向、旋转换路而棋子箭头不动、交叉不换轨、阻挡先后、舒缓的一两弯、大盘连续解路径，以及完整路线观察。
+v0.3 第 1 关为 37 格、8 枚棋子，开局全部可离场，每枚参考路径恰好转弯一次，无需旋转；“全部可离场”不表示任意朝向都相同。前 7 关通过 `lesson` 字段依次学习箭头起步与弯轨转向、旋转换路而棋子箭头不动、交叉不换轨、阻挡先后、舒缓的一两弯、大盘连续解路径，以及完整路线观察。
 
-主线发布要求包括完整可解、每枚棋子在六个朝向下的独立路线无闭环，以及参考解答中的阻挡可解释、旋转后有明确进展；这些门槛不代表玩家任意旋转或点击序列都不会遇阻。制作方向见 [玩法方向](docs/gameplay-direction.md)，逐关生成与验收记录见 [主线审阅报告](docs/campaign-review.md)，验证结果以实际生成报告和测试输出为准。
+v0.3 发布要求包括完整可解、每枚棋子在六个朝向下的独立路线无闭环，以及参考解答中的阻挡可解释、旋转后有明确进展；这些门槛不代表玩家任意旋转或点击序列都不会遇阻。该版制作方向见 [玩法方向](docs/gameplay-direction.md)，逐关生成与验收记录见 [主线审阅报告](docs/campaign-review.md)，验证结果以实际生成报告和测试输出为准。v0.4 按新版准则单独筛选与回放，不沿用以上全部布局限制。
 
-所有关卡可自由选择。在左上角选关窗口切换 v0.1 / v0.2 / v0.3，分别保存通关进度与上次选关；对应旧存档会自动迁移，旧数据继续保留。历史布局原样恢复，三版共用当前免费旋转与失败试路规则，详见 [关卡版本与来源](docs/campaign-versions.md)。以上弯轨比例与节奏门槛针对 v0.3。音效使用 Web Audio 合成，首次交互后启用，可在设置中关闭并保存偏好。
+所有关卡可自由选择。在左上角选关窗口切换 v0.1 至 v0.5，分别保存通关进度与上次选关；对应旧存档会自动迁移，旧数据继续保留。历史布局原样恢复，五版共用当前免费旋转与失败试路规则，详见 [关卡版本与来源](docs/campaign-versions.md)。以上弯轨比例与节奏门槛针对 v0.3。音效使用 Web Audio 合成，首次交互后启用，可在设置中关闭并保存偏好。
 
 ## 关卡工坊
 
@@ -57,8 +66,11 @@ npm run dev
 | `npm run dev` | 启动本地开发服务，默认端口 4173 |
 | `npm test` | 执行 Node 内置测试套件 |
 | `npm run build` | 生成设计资源并输出静态站点到 `dist/` |
-| `npm run levels` | 读取主线种子清单重新生成 48 关，同步关卡 JSON、共享模块和实际路径验收报告 |
-| `npm run levels:versions` | 校验历史关卡归档并生成 v0.1 / v0.2 的浏览器模块 |
+| `npm run levels` | 读取 v0.3 种子清单重新生成 48 关，同步关卡 JSON、共享模块和实际路径验收报告 |
+| `npm run levels:v04` | 读取 v0.4 制作卡重新生成 20 关，验证两套完整回放并同步体验报告 |
+| `npm run levels:v05` | 离线生成并筛选完整 1000 关，冻结配方、布局、分章数据及回放证据 |
+| `npm run levels:v05:verify` | 校验冻结数据及生成源码指纹，重新求解 1000 关并回放每关 22 套解 |
+| `npm run levels:versions` | 校验历史关卡归档并生成 v0.1 / v0.2 / v0.3 的归档模块 |
 | `npm run design` | 生成颜色 token、CSS、JSON、PNG、对比度报告和设计指南 HTML |
 | `node scripts/serve.mjs --dist` | 本地预览构建产物 |
 
@@ -66,7 +78,9 @@ npm run dev
 
 修改语义颜色时编辑 `src/design-tokens.js`，然后运行 `npm run design` 并检查生成资源的差异。修改关卡生成逻辑后运行 `npm run levels` 和 `npm test`，确保关卡数据同步且全部可解。
 
-主线布局来源为 `levels/campaign-seeds.json`，包含逐关种子和生成参数；不要直接编辑派生关卡。`levels/campaign-analysis.json` 的 `pathUsage` 记录参考解答中真正成功走过的弯轨/直线路径、转弯数量与逐棋子明细，不能用棋盘弯线总数替代。报告仍是结构与回放证据，不包含真人体验数据。
+v0.3 布局来源为 `levels/campaign-seeds.json`，包含逐关种子和生成参数；v0.4 来源为 `levels/v0.4-seeds.json`，包含种子、生成参数、设计意图和完整体验动作。不要直接编辑派生关卡。`levels/campaign-analysis.json` 与 `levels/v0.4-analysis.json` 记录实际成功路径；后者还区分最少旋转参考解与突出关键反差的体验解。报告是结构与回放证据，不包含真人体验数据。
+
+v0.5 的编排在 `src/production-plan.js`，选中配方在 `levels/v0.5-recipes.json`；静态构建只验证冻结千关，不在每次构建时重新抽取布局。完整生产使用确定性种子，每个槽位在同一种形态和体验内比较候选。调试小批次可运行 `node scripts/build-production-levels.mjs --count=50`，仅写入临时目录；仅完整 1000 关可通过 `--publish` 写入本地正式数据。此标志不会部署网站。
 
 ## 项目结构
 
@@ -84,6 +98,12 @@ npm run dev
 | `levels/campaign-seeds.json` | 48 关种子与生成参数的制作来源 |
 | `levels/campaign.json`、`src/levels.js` | 根据种子清单生成的主线 JSON 与浏览器模块 |
 | `levels/campaign-analysis.json` | 逐关回放、真实成功路径 `pathUsage` 与结构指标 |
+| `levels/v0.4-seeds.json`、`src/experience-generator.js` | v0.4 逐关制作卡与支持不同朝向逆向放置的生成器 |
+| `levels/v0.4.json`、`src/levels-v04.js`、`levels/v0.4-analysis.json` | v0.4 布局、浏览器模块与双方案回放证据 |
+| `src/route-grammar.js`、`src/stage-seed.js`、`src/production-generator.js` | 六类开放路线、两次换路锁组与有构造解的布子 |
+| `src/campaign-evidence.js` | 正式求解、策略回放、对称去重、结构难度与体验兑现证据 |
+| `levels/v0.5.json`、`levels/v0.5/`、`src/levels-v05.js` | 千关全集、20 章独立 JSON 与浏览器模块 |
+| `levels/v0.5-analysis.json`、`levels/v0.5-recipes.json` | 千关逐关证据与可复现配方 |
 | `assets/` | PNG 图集、历史素材与生成提示词 |
 | `tests/`、`scripts/` | 自动测试、开发服务和生成脚本 |
 | `cocos/` | Cocos Creator 棋盘及 UI 适配示例 |
@@ -118,6 +138,12 @@ Cocos 示例复用规则、碰撞、渲染命令和图集；HTML 控件、文件
 
 [Hex Video Lab](labs/hex-video/index.html) 是基于 `examples/hex.mp4` 的独立 UI / 特效复刻，可切换地图、棋盘和领奖场景，支持自动试玩、单片翻转、彩纸、金币飞入、慢速播放及参考帧对照。棋子按本项目要求保留单片薄侧边，不使用视频中的多片堆叠。运行 `npm run dev` 后访问 `/labs/hex-video/index.html`；详见 [复刻笔记](labs/hex-video/README.md)。
 
+## 环路车场 Lab
+
+[打开环路车场实验](http://localhost:4173/labs/car-loop/index.html)：对照六角与方格道路，点击方块小车发车，经固定引道汇入顺时针环路，驶向右上方终点。提供多弯路网、旋转、路线提示、三组样本和自动演示。独立实验不影响主线；详见 [Lab 说明](labs/car-loop/README.md)。
+
+转盘发车玩法于 2026-09-10 暂缓研发，保留可运行版本；详见 [研发记录与阶段结论](docs/car-loop-research.md)。
+
 ## 玩法变种 Lab
 
 [打开独立实验室](http://localhost:4173/labs/variants/index.html)：分色归站、机关换轨、接力停靠，各 5 个可解关卡，支持旋转、撤销、提示和重来。仅使用实验室数据，不写入主线存档。规则和验证范围见 [Lab 说明](labs/variants/README.md)。