更新技术美术明亮教具室版:字体、指路、教学与庆祝效果

This commit is contained in:
toshiocn
2026-10-22 16:37:43 +08:00
parent 2d5a9e9553
commit 66b3ca4ea0
113 changed files with 7363 additions and 150 deletions
@@ -0,0 +1,44 @@
# 明亮教具室 · 参考图圆润版修订
日期: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)。截图不进入游戏包。
本次完成程序材质与浏览器视觉核对,未执行微信手机的帧耗时、内存和像素一致实测,也没有宣称整张概念图逐像素一致。手机上应使用新包检查初次生成材质、连续滑动、字体和前后台恢复。