# 明亮教具室 · 参考图圆润版修订

日期：2026-10-21。版本：reference-cushion-v2。

本次以用户补充的效果图为视觉依据，覆盖此前报告中“薄描边、轻倒角、较深紫色”的生产建议。保持真实200关几何和玩法，重做棋块、底座、按钮及其色彩、厚度、受光和投影。

## 视觉修正

| 项目 | 此版实现 |
|---|---|
| 配色 | 从参考图局部采样：紫面约RGB(129,120,244)，奶油块面约RGB(249,237,213)，舞台约RGB(250,238,214)；黄底改为金黄渐变 |
| 圆润材质 | 按轮廓距离生成软倒角，叠加上缘亮部、下缘暗部、实体底沿与柔和投影；几何外形决定材质，不加载图片 |
| 多余线框 | 移除固定条件方框、当前位置四角框、双色已走内框、常驻块体描边和完成时轮廓扫线 |
| 桥接 | 由原来宽条改为细短圆润连接件，具有自身倒角和深度，仍连接真实共边 |
| 比例 | 简单盘面的棋块按可用舞台放大，减少先前大量空白；复杂盘面仍受真实包围盒和文字空间约束 |
| 按钮 | 增大圆角和厚度；重开用珊瑚实体回转符，撤销用暖黄实体箭头，指路用黄色灯泡；操作保持重开／撤销／指路 |
| 底座与状态 | 奶油软边底座、珊瑚关号标签、奶油计数胶囊；继续显示实际访问步数和剩余块数 |

必要的数字、奇偶、通道、墙门和类别形状保留。双色关保留蓝橙身份；小节距普通紫块采用较深紫面，保持小号数字清楚。此版没有替换或伪造真实关卡构图。

## 实现

新增 `wechat-campaign-200-r2/src/bright-classroom/cushion.mjs`：圆角矩形使用解析距离，异形和内孔使用原轮廓的贝塞尔采样距离；由距离和方向场计算亮暗、透明度及极轻静态颗粒。生成的Canvas只作为运行时缓存，字段缓存与材质缓存分别设10MiB、20MiB预算，按最近使用顺序淘汰。

参数集中于 `docs/design/bright-classroom/tokens.json` 的 `referenceMatch`。旧 `color` 与原报告保留为历史规范；原色对审计不作为新浅紫材质的验证结论。主要代码在 `theme.mjs`、`ui.mjs`、`geometry.mjs` 和 `board-renderer.mjs`。

仍未修改上游四份来源快照、关卡顺序、规则、存档key及音频；仅更新构建适配版本说明。Canvas的像素生成能力不可用时保留程序矢量回退。

## 验证与交付

| 证据 | 结果 | 对应结论与路径 |
|---|---|---|
| `node --test bright-classroom.test.mjs hints.test.mjs lessons.test.mjs audio-copy.test.mjs` | 30/30通过；新增软倒角像素的内孔透明、上亮下暗、不修改几何检查 | 材质生成与逻辑几何分离 |
| `node smoke.mjs` | 200/200唯一解与模拟微信触摸通关，四种屏幕、教学隔离、提示、撤销、存档及减少动态通过 | 全关卡行为保持 |
| 浏览器 `qa/hints.html` | 200/200已走格采样像素在开启提示及撤销重画前后相同 | 新缓存材质仍被提示层正确避让 |
| 实际浏览器观察 | 基础大块、双色奇偶、320×568的36块密集盘 | 取消线框后继续检查读盘与布局 |

试玩：[明亮教具室](http://127.0.0.1:17859/qa/bright-classroom.html)。

导入包：[参考图圆润版](../releases/NumberSwipe-campaign-200-r2-明亮教具室-参考图圆润版-20261021.zip)。SHA-256：`80EE3B573414A4A295497014916E401D3F27973B88815D2ABB62C904E1B6E628`。解压后导入微信开发者工具，重新编译并生成新预览；旧包保留。

实际运行截图：[基础大块](../wechat-campaign-200-r2/qa/bright-classroom-reference-v2.png)、[320宽密集盘](../wechat-campaign-200-r2/qa/bright-classroom-reference-v2-dense.png)、[200关像素检查](../wechat-campaign-200-r2/qa/bright-classroom-reference-v2-pixels.png)。截图不进入游戏包。

本次完成程序材质与浏览器视觉核对，未执行微信手机的帧耗时、内存和像素一致实测，也没有宣称整张概念图逐像素一致。手机上应使用新包检查初次生成材质、连续滑动、字体和前后台恢复。