麻将关卡编辑器 v4.0 · std 坐标（row=上下/纵, col=左右/横）

🗂 图层▼

🖌 画笔▼

🀫 普通

🂠 暗牌

⚙ 吐牌

🟣 圆盘

🎡 旋转

🎯 生成关卡▼

目标分数（单关和批量都匹配这个范围）

目标分数 ~

结构参数（单关和批量按分数/暗牌过滤；钩子难度由层数自动产生）

暗牌总数 10%

暗钩比例 100%

堆层数越多 → 牌埋得越深 → 钩子越难（看生成结果的"均深"）。钩子%不用手动设。

底座堆塔

堆层数

这是起始值：生成时会按目标分数自动加减层数来凑分（最终层数可能≠预设）

批量

模式

数量

就绪

生成参数说明

堆层数 & 自动调层（按目标分数）

你设的"堆层数"是起始值。生成时会按目标分数自动加减层数来凑分：目标分数低 → 自动降层（塔更"开"、可点率更高）；目标分数高 → 自动升层（牌埋更深、可点率更低）。所以最终层数可能 ≠ 你预设的层数，属正常，是"分数控制层数"。

钩子难度（已改为自动）

钩子 = 一对同花色里至少一张被埋(上压/左右夹)。堆层数越多 → 埋得越深 → 钩子越难。钩子%由底座深度自然决定，不用手动设，看生成结果的"均深"即可。

暗钩比例

钩子中有多少比例被标成暗牌。100% = 所有钩子都暗，0% = 没有暗钩。暗钩 = 钩子对里深埋的那张恰好是暗牌(看不到花色，难度更高)。

暗牌总数

暗牌占总牌数的比例。0% = 无暗牌（也不会有暗钩）。暗钩 = 这些暗牌里，标在钩子被埋牌上的那部分（由"暗钩比例"决定）。

难度分计算公式

难度分 =

          (1 - 可点率) × 30

          + 层数 × 8

          + min(钩子埋深加权 / 40, 1) × 30

          + min(暗钩埋深加权 / 40, 1) × 20

          + min((槽位压力 - 2) / 4, 1) × 30

          + 队列压力

          + 5

各项含义

可点率:开局时可点牌占总牌数比例。可点=上方无压牌且左右未被夹住。越低越难(大部分牌被压住)。满分 40 分,范围 0~40。
层数:最大层号(从 0 开始)。层越多牌越难到达。每层 +8 分,4 层封顶(32 分)。
钩子埋深加权:钩子 = 一对里至少一张被埋(上压/左右夹)。每对权重 = 埋得最深那张的埋深 + (双埋则再加另一张埋深)，再乘"所见伴侣加权"(同色露越多越好找 → 打折)。埋深 = 被多少层牌盖住。除以 40 拿满 30 分(浅层塔均深低、深层高，拉开难度)。
暗钩埋深加权:钩子对里深埋那张恰好是暗牌(看不到花色)的同规则加权。除以 40 拿满 20 分。
槽位压力:最优打法下卡槽最多同时占几个花色位(7 格上限)。值越高容错率越低——走错一步顺序就容易把槽堆满。2 槽起 0 分,每 +1 槽 +7.5 分,6 槽拿满 30 分。这是"消除顺序不对就死局"的核心指标。
吐牌机队列压力:只算"实际不可见/不可消"的队列牌贡献。从第 1 张往后找，找到第一张无法立即配对的牌（即它的配对被埋了），它及之后所有牌都算压力。公式:(0.5 + hiddenCount - 1) × 8。如果第 1 张就能立即配对，它就完全不算压力（出牌即消）。每张不可消的队列牌 ≈1 个暗钩贡献难度，第 1 张折半。
保底 5 分:确保最低难度也有基础分。

设计理由

分母 8 怎么定的:实测 80~110 张的标准关卡,钩子数观测 0~8,8 个封顶正好覆盖。
稀缺度加权:避免"1 种牌出 6 张(3 对钩子)"比"3 种牌各出 2 张(3 对钩子)"分数相同——后者实际更难(花色分散)。
槽位压力:模拟一个聪明玩家的贪心打法,统计卡槽中最大同时存在的花色数。值接近 7 时,玩家必须严格按正确顺序消除,否则槽位会被"存着等另一半"的牌堆满。
吐牌机队列压力:玩家看到第 1 张队列牌后才能意识到"接下来还有几张不知道的"，每一张都增加记忆负担 + 槽位占用风险。第 1 张可见所以折半，后面的全未知所以按完整暗钩算。
可点率只拍开局一瞬间,中盘难度不计入(但倒推法保证可解,不会真卡死)。

📜 变更日志

v4.10.6.5 · 2026-09-01

• 回滚 v4.10.6.4 浮点圆心 snap,改回整数 snap。用户反馈"不需要这样,像摆麻将一样按 1 个 cell 为单位的移动":disc hover 应在 cell 边界处跳 1 cell(离散步进,像 tile brush 一样),而不是连续浮点圆心。修正:pixelToCell 去掉 opts.float 分支,统一用 floor((wx-bx)/CELL + 1e-6) - OFFSET 整数 snap(与 tile/spitter/rotation 行为一致);mousemove 不再传 {float}。渲染侧 drawDiscAt 维持 +CELL/2(cell 中心,与 demo 对齐)。代价:cell 边界 click 会让 disc 跳到最近 cell 中心(典型 19 px 步进,跟 tile brush 的 2x2 footprint 跳格一致),用户接受这个 "1 cell 步进" 行为

v4.10.6.4 · 2026-09-01

• 修复 v4.10.6.3 引入的"圆盘放不到正中间,偏上偏左"bug。v4.10.6.3 把 disc 渲染改为 cell-center(+CELL/2)与 demo 对齐,但 pixelToCell 仍是 floor 整数 — 用户点田字中心(w=86,h=104 这种 cell 边界位置)时返回 col=-4(下界 cell),圆盘画在 cell -4 中心(w=66,h=84),偏离点击位置 19 px 偏上偏左。修法:pixelToCell 加 opts.float 参数,圆盘画笔下返回浮点子格坐标 (wx-bx)/CELL - 0.5 - OFFSET — 与 drawDiscAt 的 +CELL/2 公式对齐后,任意 click 位置 round-trip 精确到 0(浮点精度内)。验证:田字中心 click (86,104) → hoverCell (-3.5,-6.5) → drawDiscAt at (86,104) 误差 0 ✓;编辑器-demo 公式对比 8 种 col(整数/半整数)全部对齐 ✓;普通画笔/tile/spitter/rotation 仍用 floor 整数起点(2x2 麻将 footprint 行为不变) ✓

v4.10.6.3 · 2026-09-01

• 修复编辑器圆盘位置与 demo 不一致(相差半格):编辑器 drawDiscAt 用 BOARD_PAD + (col+OFFSET_COL)*CELL(cell 起点)画圆心,而 demo renderDiscs 用 offX + (col-minCol)*cellPx + cellPx/2(cell 中心),两者错位半个 cell。用户在编辑器画一个 disc 走「按当前形状生成」加载 demo,会发现圆盘视觉位置偏半格(尤其水平方向最明显)。修正:编辑器 drawDiscAt 与 drawDiscPreview 圆心统一加 + CELL/2(与 demo cell-center 公式一致);pixelToCell 同步去掉 disc 画笔专用的 + 0.5 偏移——hover 用 cell 起点,渲染用 cell 中心,两者公式天然对齐(同一像素落在哪一格 floor 结果不变)。验证:示例_圆盘.json(5 disc 全 col=-4)实测 editor backing pixel x 中心 142.65(= view 变换后 cx=66),与 demo SVG cx 176.14(= cell 中心公式)在各自画布上视觉位置完全对应 ✓

v4.10.6.2 · 2026-08-31

• 修复 v4.10.6.1 圆盘 z-index 方向错误:v4.10.6.1 用单个 SVG z-index=50000 永远在最上层,导致 L(N+1) tile 被圆盘压在下面(视觉上"L1 tile 从圆盘后面凸出来")。修正:renderDiscs 改为按 gapLayer 分组、每组一个 SVG,各自 z-index = (gapLayer+1)*1000(tile 用 layer*1000+id,所以 L(N+1) tile 的 z 总 ≥ (N+1)*1000+1 > disc 的 z=(N+1)*1000;L(N) tile 的 z ≤ N*1000 < (N+1)*1000)。新方案:L(N+1) tile 视觉上压着 disc(tile z > disc z),L(N) tile 视觉上被 disc 覆盖(disc z > tile z),符合"圆盘是两层之间的盖子"语义。同时 disc 半径从 v4.10.6.1 的 2.5 cell 回到 2 cell——因为现在 L(N+1) tile 自然压在 disc 上方,disc 不需要再加大以完全覆盖 L(N+1) tile。验证:DOM 实测 tile z=1~20(L0 tile id 1~20,均 < 1000 → 在 disc 下),tile z=1021~1026(L1 tile,均 > 1000 → 在 disc 上),disc-layer z=1000 ✓

v4.10.6.1 · 2026-08-31

• 修复 v4.10.6 圆盘半径不够大导致 L(N+1) tile 4 角凸出 disc 圆外的 bug。根因:disc 半径 2 * cellPx(=2 cell),L(N+1) tile 边长 2 cell 半对角 ≈1.41 cell,加上 layerOffset 让 L(N+1) tile 中心偏离 disc 圆心 sqrt(0.2²+0.2²) = 0.28 cell,L(N+1) tile 边缘最远 ≈1.69 cell > 2 cell 半径 → tile 4 角凸出 disc 圆外约 12.8 px,视觉上"L1 tile 从圆盘下面凸出来"。修正:disc 半径 2 * cellPx → 2.5 * cellPx(覆盖 L(N+1) tile 完全 + 7.2 px 安全边距)。实测 6 个 L1 tile × 5 个 disc 共 30 个距离中,所有配对 disc 上方的 L(N+1) tile overlap 从 +12.8 px → -7.2 px(负数=完全在圆内),L1 tile 4 角不再凸出 disc 圆外 ✓

v4.10.6 · 2026-08-31

• 修复工作台预览"每次打开都要等好久才出麻将"问题。closePreview() 原本会 frame.removeAttribute('src') 卸载 demo iframe 并把 demoReady=false,导致每次"关闭→重开"预览都要重新加载整个 /demo/index.html(HTML+CSS+JS 全重),体验非常卡。修正:closePreview 仅隐藏 modal,保留 iframe 与 demoReady 状态;后续预览走 previewLevel 的 else 分支 if (demoReady) sendLevelToDemo(level),直接 postMessage 发关卡,二次预览实测 0ms 秒开。后台循环 CPU 开销 <1%,换取预览秒开
• 修复编辑器生成关卡"圆盘数据丢失"问题。buildEditorShape() 已正确返回 discs 数组,但 tryGen / generateStackFromCurrent / batchGenerate 三处调用都只解构了 { tiles, specialTiles }、漏了 discs,传给 fillEditorShape / generateStackFromShape 时也没传 discs;生成器内部也未读取/写出 discs。后果:用户用编辑器画了圆盘,点"按当前形状生成"或"按堆塔生成"或"批量生成",输出的关卡 JSON 完全不含 discs 字段——demo 加载后看不到圆盘,圆盘机制完全失效。修正:三处解构均加 discs;生成器三个函数 (fillEditorShape / generateAndFill / generateStackFromShape) 都新增 options.discs 解析并写入返回 level 的 discs 字段,与手画导出链路(level = { ..., discs })保持一致。验证:画 2 disc 走 fillEditorShape 实测返回 level.discs.length===2 ✓
• 修复圆盘机制三个 demo 端 bug:①空圆盘不消失。loadLevel 末尾未调 sweepDiscsToFade(),导致用户画了 disc 但上方未放 tile 的关卡加载后,圆盘一直显示不消失(原 sweep 只在消除一张牌后才触发)。修正:loadLevel 末尾调一次 sweep,空 disc 立即开始淡出。②圆盘视觉被上层 tile 盖住。zOffset = (gapLayer+0.5)*0.3*cell*1.5 在 gapLayer=0 时仅向上偏 9px,而 L1 tile 的 layerOffset 是 12px——L1 tile 视觉位置更高,看起来"压在圆盘上"。修正:zOffset = (gapLayer+1)*0.3*cell*1.5,gapLayer=0 时偏 18px,大于 L1 tile 的 12px,圆盘视觉在最上层 tile 之上,符合"盖子"语义。③render 时 board 未 layout 导致 cell 负数。loadLevel 同步调 render,若此时 board.parentElement.clientWidth===0 则 cell 算成负数,SVG circle radius 负数 → 不渲染;tile div width 负数 → CSS fallback 视觉错位。修正:render 顶部若 boardW===0 则 requestAnimationFrame(render) 等下一帧 layout 完成再画。验证:reload 示例关卡 cellPx 从 -7.22 → 40,圆盘 r 从 -14.45 → 80 ✓
• 修复圆盘 disc 上方最后一张 tile 进卡槽后该 disc 仍不淡出的 bug。单张 tile 进槽没配对时,checkMatch 不会进入 MATCHED 分支、也就不会调 sweepDiscsToFade,导致该 tile 上方的 disc 永远卡在场上不消失(典型场景:9 张 L0 九宫格 + 1 disc 居中 + 1 张 L1 tile 盖 disc,点 L1 进卡槽)。修正:在 checkMatch() 开头加一次 sweepDiscsToFade(),无论是否配对都先扫一遍 disc——单张进槽让上方最后一张 tile 从 active 移除的场景也能正确触发 disc 淡出。验证:用户场景下点 L1 tile 后 disc alpha 从 0 → 0.13(瞬间)→ 0.29(1.5s 后),确认淡出动画启动 ✓

v4.10.5 · 2026-08-30

• 修复工作台预览试玩"消除一对直接获胜"bug。checkWin 的通关条件原为"麻将全消 OR 圆盘全消"(任一即胜利),消除一对后场上无牌 → allTilesCleared=true → 立刻通关,完全不看 disc 是否还在。修正为"麻将全消 AND 圆盘全消失"(两个必须同时满足),有 disc 的关卡必须等 disc 淡出完成才能通关;同时保留 currentDiscs.length===0 兜底(避免空 disc 关卡卡住)。Preview 实测:mini 关卡(2 牌 + 1 disc)消除一对后 msg 不显示,等 disc 淡出完成才通关 ✓

v4.10.4 · 2026-08-30

• 修复 v4.10.2 引入的"圆盘画在棋盘外"bug:v4.10.2 把 disc.col 从麻将位改为子格坐标时,drawDiscAt 用了 BOARD_PAD + disc.col*CELL,漏了 +DISPLAY_OFFSET_COL。结果 hoverCell.col=5 圆盘画在 cx=6+5*40=206(棋盘外左),而 tile col=5 画在 cx=6+(5+5)*40=406(棋盘右),两者错位 200px=5 子格 — 鼠标在棋盘右下方时圆盘显示在棋盘外左上,看起来像"圆盘在鼠标左上方"。修正:与 tile 渲染一致,圆心 = BOARD_PAD + (disc.col+DISPLAY_OFFSET_COL)*CELL;drawDiscPreview 虚线圆环同步修正

v4.10.3 · 2026-08-30

• 修复 v4.10.2 圆盘画笔圆心偏向鼠标左上方:pixelToCell 在 disc 画笔下从 cell 起点(floor+1e-6)改为 cell 中心(floor+0.5),圆心 hoverCell 落在最近子格中心,鼠标怎么移圆盘都跟着。普通画笔仍用 cell 起点(2x2 麻将 footprint 从起点铺开)

v4.10.2 · 2026-08-30

• 圆盘坐标语义重定义:disc.row/col 改为"子格坐标(任意整数)"而非"麻将位坐标(仅偶数)"。圆心可以落在 4 张麻将交界(田字中心),圆刚好盖住 4 张麻将的各一角
• 编辑器:mousemove 取消 snap 到偶数;边界拓宽(col -6..6, row -9..7,支持子格负向偏移);drawDiscAt/drawDiscPreview 圆心直接用 col*CELL 不再 +1
• 圆盘间重叠判定从 3x3 box 任意子格交集(过严)改为欧氏距离≤2 子格(临界相切允许放),支持田字中心位旁并列多个 disc
• demo:renderDiscs 圆心改用 (d.col-minCol)*cellPx+cellPx/2(子格中心),discOverlapsTile ≤2(配合 3x3 占地区)
• 示例_圆盘.json 圆心坐标同步迁移到新语义(麻将位 (col=-5)→ 子格中心 col=-4)

v4.10.1 · 2026-08-30

• 圆盘半径加大：r = 2 子格 = 1 张麻将边长(原 r = 1 子格太小,直径只有麻将一半),demo SVG 同步。圆心仍对齐麻将位中心
• 编辑器圆盘画笔 snap hoverCell 到偶数(麻将位坐标):原 mousemove 直接传子格坐标,鼠标在子格奇数位置时圆心会偏离麻将位。snap 后圆心严格落在麻将位中心

v4.10.0 · 2026-08-30

• 新增圆盘机制：圆盘插入在两层麻将之间（如 L0/L1 之间），半径 = 1 张麻将长度，半透明紫色圆+中心白点+L 标签显示。①圆盘覆盖麻将 → 该麻将不可点；②圆盘被麻将覆盖 → 该麻将被消除时圆盘淡出消失；③所有圆盘消失 → 通关（与「麻将全清」任一即可）。手动放置，不通过生成器；不参与配对计算、不占层编号
• 编辑器圆盘画笔：画笔面板新增「🟣 圆盘」按钮；选择后弹出"插入到第 N/N+1 层之间"下拉（L0/L1 ~ L4/L5 五档）；选哪个缝哪个缝以上的层半透明显示预览；点画布 = 放置，再点同位置 = 删除；不支持跨层悬空（与所在层麻将重叠时画笔拒绝放置）；圆盘作为独立数组 discs 与 layers 并列存入 JSON
• Demo 渲染：新增 demo/示例关卡/示例_圆盘.json（5 圆盘示例关）；URL 加 ?sample=disc 直接加载；圆盘用 SVG 单节点批量绘制（避免 N 个 div），定位与牌的 3D 偏移同步；点击消除上方麻将后 setInterval 链触发淡出动画；淡出完成自动 checkWin
• 工作台后端：GET/POST 关卡接口新增 discs 字段透传；保存到工作台时随 discs 一起写；列表元数据不含 discs（仅关卡 JSON 持有，不影响列表展示）

v4.9.13 · 2026-08-28

• 修复 v4.9.12 引入的「支撑限制未通过」悬空报错：该版本把生成端支撑放宽为"看所有下层"（桥式搭放），但编辑器悬空判定只看正下方一层，隔层桥牌回到编辑器全被判悬空。已回退桥式，生成端支撑统一回"只看正下方一层"；并把最终兜底校验 levelHasFullSupport 也收紧为同口径（原宽松口径会放过偶化删牌后的悬空）
• 边列覆盖修复效果不受影响（靠选位公平化+边列保底实现）：实测满6×8底座×50次边列第二层视觉覆盖仍 100%，且 0 关含悬空

v4.9.12 · 2026-08-28

• 修复按底座堆塔时边列(最左/最右列)上层常年没牌盖的问题:①选位顺序先随机再排序,不再固定从左往右(旧逻辑边列永远最后被考虑,~13 张配额经常轮不到);②第一层加"边列保底"先占 1 张再铺其余;③上层支撑从"只看正下方一层"放宽为"看所有下层"(桥式搭放,与最终校验对齐)
• 实测(满6×8底座×50次):边列第二层覆盖 26%→100%,边列第三层+有牌 2%→100%,中间列不受影响,四种底座形状生成成功率 30/30

v4.9.11 · 2026-08-28

• 编辑器「保存到工作台」序号框从单独第二行挪到第一行末尾，和口令、关卡名并列（一行式布局更紧凑）

v4.9.10 · 2026-08-28

• 修复工作台删除后「越刷越多」：①「连接 / 刷新」按钮和页面初次加载走 connect()，之前没过滤本端已删 key（只在 refresh 过滤）→ 陈旧缓存把刚删的关显示回来，计数 58 变 59；② 索引 _index.json 是读-改-写维护，两人并发（一人删/一人存）时旧快照覆盖会把已删条目写回索引成幽灵关。后端现在每次读/写索引前对账 git trees（1 子请求，文件清单=真值）：索引有文件无→剔幽灵；文件有索引无→补回丢失的保存。刚存 10 分钟内宽限不剔，防树读取陈旧错杀新关

v4.9.9 · 2026-08-26

• 修复工作台「已删除」toast 出现但列表残留：实测后端 DELETE 其实成功（GitHub 真删了，git origin/main 的 _index.json 已不含该 key），但 Cloudflare 函数读 raw _index.json 被边缘缓存陈旧，refresh /levels 仍返回旧快照含被删 key
• 前端加乐观移除（成功后立刻从 levels 数组删）+ localStorage 记被删 key，以后每次 refresh 过滤掉；等缓存过期这条 filter 自动失效、无副作用。底层彻底解仍需 LEVELS KV 绑定

v4.9.8 · 2026-08-26

• 修复旋转画笔「放上去拿不掉」：旋转面板加「❌ 取消旋转」按钮，一键重置中心行/列/半径到默认无旋转态、清 state.sentRotation（之前设了中心后没有任何 UI 能清掉）
• 修复「🗑 清空」不清旋转：clearAll 同步重置旋转输入框 + state.sentRotation，否则旋转配置会跟着导出的关卡走

v4.9.7 · 2026-08-25

• 修复工作台「点击删除显示删除失败」：列表兜底路径读 raw 索引偶发陈旧，会显示「幽灵关」——其文件其实已被删（比如协作者删过）。旧逻辑删文件 404 就直接报失败。
• 改为幂等删除：文件在→删除；文件已不存在→仅清索引条目；两者都返回成功，幽灵项随手清掉、不再误报「删除失败」

v4.9.6 · 2026-08-25

• 工作台「保存后看不到新关」根治（你和你同学都中招）：实测真根因是 Cloudflare Worker 单次调用最多 50 个 fetch 子请求，旧实现列表逐个读关卡文件（69 关=70 次）超限被砍剩 47，最新存档永远不进列表。之前的缓存/破缓存修复都在治错症。
• 改成 _index.json 存全量列表元数据：列列表=1 次读取不再超限；保存/改名/排序/删除都会同步索引，保存后立刻实时可见

v4.9.5 · 2026-08-25

• 工作台「已保存关看不到」根治：实测定案是 Pages Functions 对 api.github.com 子请求做边缘缓存(cache:no-store 压不住固定 URL)，导致列表永远停在旧快照、保存/单关读取却实时。
• 列表改读 raw.githubusercontent.com（不同主机 + 每次 _t 时间戳破缓存），保存后刷新工作台立刻能看到新关

v4.9.4 · 2026-08-25

• 「生成关卡」问号里新增说明：堆层数是起始值，生成会按目标分数自动调层(低→降层/高→升层)，最终层数可能≠预设。堆层数输入下方也加了同款提示

v4.9.3 · 2026-08-25

• 工作台列表改用 _index.json 索引：函数对 GitHub 列目录(/contents、/git/trees)拿到的都是旧快照(最新存的关看不到)，而"按精确路径读单个文件"实时。改为维护一份关卡索引文件，存关时追加 key、列表读它 —— 永远实时

v4.9.2 · 2026-08-25

• 工作台列表仍漏掉最新存的关：/contents 目录列表接口对同 URL 返回陈旧快照(新存的高分关看不到)，cache:no-store 和 URL 时间戳都治不了(是 GitHub 侧问题)。改用一个新端点枚举：git trees API(基于 commit tree 实时反映)列文件，内容仍逐文件精确读取

v4.9.1 · 2026-08-25

• 工作台新存的关列表看不到：GitHub「目录列表」接口(contents?ref=main)对同一 URL 返回陈旧缓存，单关读取实时、唯独列表旧(cache:no-store 对它无效)。给目录列表请求 URL 加时间戳破缓存参数(&_t=now)，每次新 URL→必然未命中→拉到最新

v4.9.0 · 2026-08-25

• 导入支持「形状 + Type ID」：导入 JSON 时保留每张普通牌的 typeId(牌面)，不再只导空壳形状 • 新增工具条「🀫 牌面ID」开关，显示每张牌的 Type ID • 按当前形状生成：完整导入的关卡(每张牌都有 typeId 且可解)直接保留原花色复现同一关；不完整/不可解才重新填色 • 导出也写回普通牌的 typeId

v4.8.5 · 2026-08-25

• 工作台列表仍显示旧关数：根因是 Function 对 GitHub 「目录列表」子请求被 Cloudflare 缓存(单关读取是实时的,唯独列表停在旧快照)。给 Function 的 GitHub 子请求加请求侧 cache:'no-store',列表每次实时拉。

v4.8.4 · 2026-08-25

• 修复"保存到工作台后刷新看不到新关"：工作台 API 响应被 Cloudflare 边缘缓存(GET /levels 一直返回旧列表)，新存进 GitHub 的关列表读不到。给 API 加 Cache-Control: no-store，列表实时反映。

v4.8.3 · 2026-08-25

• 修复"保存到工作台后在工作台刷新看不到"：口令原来存 sessionStorage（每标签独立，编辑器与工作台跨标签不共享）→ 工作台 getPass 为空就静默不加载。改为 localStorage 跨标签共享，编辑器存的关拿到工作台任意标签自动带出。

v4.8.2 · 2026-08-24

• 修复"点击推塔生成后右侧预览不出现"：预览起始对 demo 的 HEAD 探测会把"超大文件 HEAD 被取消(ERR_ABORTED)"误判为"demo 缺失"→ 直接禁用整场预览。改为只有确认 404 才禁用，其余照常加载。

v4.8.1 · 2026-08-24

• 修复"探测本底座可出分数"按钮无反应：初始状态行残留对已删变量 N 的引用(N 未声明 → 抛 ReferenceError，函数未真正运行)

v4.8.0 · 2026-08-24

• 目标分数 → 可点率反向驱动：按目标分数自动调节堆塔层数(塔形密度跟随目标)
• 目标低 → 自动降层(塔更"开" → 可点率↑)；目标高 → 自动升层(埋更多 → 可点率↓)
• 堆塔单关/批量生成都支持自动调层，从用户设定层数起步，够不到目标时才调
• 探测分数范围改为扫描层数2~7，报出底座真正可达区间
• 结果状态显示可点%，未命中时兜底取"分数离目标最近"而不是第一个

v4.7.0 · 2026-08-24

• 吐牌机交互重做：spitter 画笔下"再次点击已放置的吐牌机 → 直接消除"(对齐普通牌点已存在即擦除,不再依赖双击)
• 修复吐牌机放置左右不对称：去掉镜像位置重叠检查(spitter 本就不对称放置)
• 非当前层吐牌机半透明淡出(alpha 0.4),俯视编辑当前层时不再抢眼
• 同层禁止把吐牌机塞进两张普通牌中间的缝(与普通牌放置规则一致)
• 吐牌机输出目标位也做支撑校验：目标位下方无支撑则禁止放置
• 工作台新增"预览"按钮：内嵌 demo iframe 弹层即时试玩该关

v4.6.41 · 2026-08-22

• 新增吐牌机队列压力维度:只算"实际不可见/不可消"的队列牌贡献
• 从第1张往后找，找到第一张无法立即配对的牌，它及之后所有牌都算压力
• 如果第1张就能立即配对，它就完全不算压力(出牌即消)
• 公式:(0.5 + hiddenCount - 1) × 8,第1张折半
• 目标分数问号:补充吐牌机队列压力说明 + 设计理由

v4.6.40 · 2026-08-22

• L0吐牌机跳过支撑校验:地面就是支撑,无需校验
• 只有L1+吐牌机才需要检查target位置是否有下层牌托住

v4.6.20 · 2026-08-21

• demo支持吐牌机渲染(橙色⚙图标)+队列牌隐藏

v4.6.19 · 2026-08-21

• 队列牌用独立typeId池(避免和普通牌重复,防止同花色三张)
• 吐牌机放置时检查目标位置是否被覆盖(被覆盖则拒绝放置)

v4.6.15 · 2026-08-21

• 按底座生成也排除吐牌机参与配对+填色

v4.6.14 · 2026-08-21

• 修复吐牌机导致生成卡住(排除吐牌机参与backwardFill配对)

v4.6.13 · 2026-08-21

• 吐牌机tile保留type字段(不再显示为普通麻将)
• 吐牌机不参与填色+偶数校验排除吐牌机

v4.6.12 · 2026-08-21

• 吐牌机偶数校验+支撑验证(按形状生成和按底座生成都校验)

v4.6.11 · 2026-08-21

• 吐牌机编辑器支持:堆叠队列+支撑验证+导入导出
• 吐牌机画笔自动在指向位置堆N张队列牌

v4.6.10 · 2026-08-21

• 按底座堆塔时保留编辑器已有的层(不再丢弃L1+)

v4.6.9 · 2026-08-18

• 填色用随机起始seed(每次点生成结果不同)

v4.6.8 · 2026-08-18

• 修复吐牌机被当作普通麻将填色(fillEditorShape追踪spitter)

v4.6.7 · 2026-08-18

• 修复版本检测bug(version字段用commit hash匹配APP_VERSION)

v4.6.6 · 2026-08-18

• 删除主页试玩Demo卡片
• 修复version.json嵌套引号(清理changelog)

v4.6.5 · 2026-08-18

• 修复保存按钮bug(id不匹配wbNewOrder/wbSaveOrder)
• 保存失败用alert弹窗

v4.6.4 · 2026-08-18

• Tab双模式(参数模式+难度模式)
• 难度模式下不严格匹配(参数自动分配)

v4.6.3 · 2026-08-18

• 切换难度模式时同步滑轮值(避免两个Tab显示不一致)

v4.6.2 · 2026-08-18

• 难度10的分数范围从140~170改为122~151(匹配实际可达范围)

v4.6.1 · 2026-08-18

• 难度模式下不严格匹配(参数自动分配,直接接受)
• 修复偏差说明不一致(用best.score而非最后一次score)

v4.6.0 · 2026-08-18

• 新增难度模式Tab:1-10滑轮,自动映射分数/钩子/暗牌比例
• 参数模式Tab保留原有详细滑轮
• 未命中时展示最接近的关卡+偏差说明

v4.5.13 · 2026-08-18

• 修复钩子百分比超过100%的bug(effHooks按对子加权)
• 撤销随机seed偏移,恢复确定性生成(同底座每次结果一样)
• 失败时永远返回最接近的关卡+显示客观偏差(不再报错)
• 堆塔失败显示具体错误(不再笼统说底座无法填色)
• 目标分数范围挪到顶部,单关生成也匹配分数范围
• 状态框高度固定64px,不自适应变化

v4.5.0 · 2026-08-18

• 加槽位压力维度minSlots(第一个中盘指标,捕捉"点错顺序就死局")
• 钩子定义修正:一对里两张都埋才算钩(修复A1+B1被架空的bug)
• 钩子加权改为可见伴侣加权(同色露越多→越不难记)
• 结果行钩子%从raw改为加权(不再"骗人"显示95%)

v4.6.36 · 2026-08-21

• 修堆塔路径 spitter 本体丢失(generateStackFromShape 漏 push spitter 本体)
• 修校验信息:把"normalCount"显示为"用户画的普通牌数"(减 spitterOrder 牌)

v4.6.36 · 2026-08-21

• 修 spitter 校验:普通牌必须偶数 + spitter.count 必须偶数(2/4)
• 修 backwardFill 支持占位牌(自动从普通牌池赋 typeId)
• 修堆塔路径 spitter 本体 typeId 保持 null(不再被填花色)

v4.6.38 · 2026-08-22

• 队列牌点直接消除(不进卡槽):消除队列牌 + spitter 本体 + target 牌
• 卡槽保持干净,不会出现消除不掉的牌

v4.6.37 · 2026-08-22

• 队列牌 layer 排序改为 spitterOrder=1 在最上层(玩家先点最上面先释放)
• 之前 spitterOrder=2 layer 最高,挡住 1;改成 1 在最上面

v4.6.36 · 2026-08-22

• 队列牌初始全部可见(堆叠在 target 上方),不再逐步释放
• 点队列牌:这张牌 + 吐牌机本体 + target 牌一起消失(不等配对)
• 队列牌不受 isClickable 限制(即使被压住也能点)

v4.6.35 · 2026-08-21

• 堆塔凑偶循环改为 while(原来只删 1 对,实际可能需要删 2/4 张才能凑齐奇偶性)
• 移除堆塔路径的冗余最终偶数校验(凑偶循环已保证)

v4.6.34 · 2026-08-21

• 堆塔路径不再强制底座普通牌偶数(堆塔算法会从顶层成对删凑偶数)
• 堆塔路径不再校验 spitter.count 奇偶(堆塔会凑)

v4.6.33 · 2026-08-21

• 堆塔生成时 spitter.count 不强制奇偶(堆塔可凑偶)
• demo 队列牌点击直接消除+触发释放下一张(不等配对,体验更顺畅)
• fillEditorShape 校验改为:普通牌奇数 + fillTiles 偶 + 总可消除偶(自动判断 count 是否合适)

v4.6.32 · 2026-08-21

• 重做 spitter 交互:画笔不再自动堆队列牌,生成器根据 spitter.count 自动生成队列牌(堆叠在 target 上方多层)
• 用户操作简化:画 1 个 spitter + 若干普通牌(target 摆或让生成器补)→ 一键生成
• 校验:普通牌必须奇数(target 包含在内),spitter.count 必须偶数(2/4),fillTiles 必须偶数
• 生成器自动在 target 空时补占位牌(也参与填色,确保关卡可解)
• spitter 本体不动 target 位置已有牌(target 由生成器从普通牌池赋 typeId)
• spitter 关联牌(target)不参与 backwardFill 填色,单独赋 typeId

v4.6.31 · 2026-08-21

• erase spitter 本体时清掉对应 stack(之前只删 layer.tiles 不清 stacks,导致 stack 残留但无 spitter tile,报"队列牌 0 张")
• 键盘 Delete/Backspace 删除 spitter 本体时同样清 stack
• fillEditorShape 报错时检测孤儿队列牌(其他位置),给出"撤销重画"提示

v4.6.30 · 2026-08-21

• 修复编辑器画笔逻辑重复声明 tKey 导致 SyntaxError,整个编辑器不渲染(画笔逻辑未生效)

v4.6.29 · 2026-08-21

• 画笔自动补支撑牌:摆 spitter 时在 target L0 自动放普通牌(作为队列牌支撑),不删除原牌
• buildEditorShape 展开 stacks 时 layer = layerIdx + order(队列牌堆叠在 target 上方多层,不再是同一层悬空)
• 队列牌数校验改为"必须是奇数"(指向位置 1 张 + N 张队列 = N+1 张需偶数 → N 必为奇数)
• fillEditorShape 错误信息区分"奇数"和"偶数",加数学推导说明

v4.6.28 · 2026-08-21

• generateStackFromShape 给 spitter/queue tile 重新分配 id(避免多 tile 共享 id=0,导致 demo 渲染混乱)
• count 与队列数不匹配的错误信息加修复提示

v4.6.27 · 2026-08-21

• 修复 buildEditorShape 写 spitter tile 时丢失 dir/count 字段(导致生成报 count=undefined)
• 修复 buildEditorShape 的 spitters 数组错存 target 位置(导致 generateStackFromShape 写出的 spitter tile 跑到 target 位置,视觉上"方向反了")
• spitters 数组改为存 spitter 本体位置 + dir/count,语义清晰

v4.6.26 · 2026-08-21

• 修复吐牌机本体被显示成普通麻将图:加 .spitter-overlay 叠加层,用 ⤴ 箭头 + 方向 + ×剩余数标识
• 吐牌机本体不再调用 tileImgSrc(typeId),改用 SPITTER_BODY_IMAGE(纯白底 SVG)+ CSS 绘制
• 新增 spitterRemainingQueueCount(id) helper 显示剩余队列数

v4.6.25 · 2026-08-21

• 修复偶数校验冲突:移除 generateCurrentShape 中旧的总牌数偶数校验(line 2563),由 fillEditorShape 内部细粒度校验接管
• 7 普通 + 1 spitter + 2 队列时只报"普通牌 7 张为奇数",不再误报"牌数必须为偶数"

v4.6.24 · 2026-08-21

• 按当前形状生成:填色前校验普通牌数偶数、spitter count 合理性(1~6)、队列牌数匹配 count、队列牌数偶数
• 按堆塔生成:底座校验普通牌数偶数 + 队列牌总数偶数
• 堆塔凑偶逻辑改为考虑队列牌奇偶性(shape.tiles 与队列牌同奇偶,凑偶后总和偶数)
• 最终偶数校验同时排除 spitter 本体和队列牌

v4.6.23 · 2026-08-21

• 吐牌机游戏逻辑完整实现:指向位置牌消除时释放队列牌(淡入+缩放动画),队列用尽后吐牌机消失
• 吐牌机本体不再分配 typeId(不是麻将,不可参与配对)
• 队列牌 typeId 改为共享池(与普通牌共用,可重复,确保释放后可正常配对消除)
• 编辑器 buildEditorShape 写出 spitter 时保留 dir/count 字段

v4.4.0 · 2026-08-18

• 钩子定义扩展:任意埋牌(上压/左右夹)都算钩子,不仅层差≥2
• 分数公式封顶:钩子/暗钩 5→8,让分数波动更明显
• 批量生成0关提示:分数上限超过140时给出具体原因

v4.3.3 · 2026-08-18

• Demo修复:消除时立即释放卡槽,不再等动画
• Demo优化:飞入动画时长 0.35s→0.2s,使用 GPU 加速
• 修复:弹层点击空白处正确关闭(原检查误判 body 的 textContent)

v4.3.2 · 2026-08-18

• 编辑器:麻将3D效果增强(偏移30px+右侧面/底面阴影)
• 删除层标签L0/L1,视野更清爽
• 变更日志:强制刷新按钮移到标题旁边

v4.3.1 · 2026-08-18

• 弹框位置:智能避开视口边界,确保完全显示
• 编辑器:麻将层级偏移 10px→20px,状态框固定高度防跳动
• 探测分数:显示具体错误消息(如"填色无解")+添加奇数牌前置检查
• 生成参数:暗牌总数移到暗钩比例之前
• 新增变更日志按钮(工作台旁边)+强制刷新按钮
• 目标分数问号:补充维度详细说明(可点率/层数/钩子/暗钩/设计理由)

v4.3 · 2026-08-18

• 新增变更日志按钮(工作台旁边)
• 目标分数问号:补充维度详细说明(可点率/层数/钩子/暗钩/设计理由)
• Demo 修复:暗牌与卡槽同花色时添加 checkMatch()调用
• 编辑器:拖拽分隔条时禁用 iframe pointer-events,修复松手后继续拖拽

v4.2 · 2026-08-18

• Demo 动画系统:飞入卡槽、匹配消除、暗牌先翻后飞
• Demo 交互修复:牌不再残留、失败可重来、计时器重置
• 生成器冲突检查修正:相邻牌合法,只禁止完全重合
• 堆塔死形重搭:外层 30 次重搭新塔形
• 批量生成候选池:不再出 0 关
• 生成参数重构:删冗余暗钩目标,改为推导显示
• 帮助按钮优化:加大按钮 + 新增分数说明
• 预览面板修正:计时器误启动 + 默认隐藏开始遮罩

v4.1 · 2026-08-17

• 难度公式 v2:钩子稀缺度加权 + 目标改百分比
• 编辑器 v4 浅色重构
• 工作台独立成页
• 试玩计时闭环:按钮 + 最佳成绩
• Cloudflare 迁移完成

坐标 —

当前 L0

支撑 —

普通 0 · 暗 0 · 吐 0 · 共 0

缩放 100%

🧪 关卡预览 ⏱ 00:00 生成关卡后在此试玩

-- 张-- 对-- 分暗 --可点 --钩子 ---- 层

🎴

生成的关卡会直接在这里试玩

在左侧画形状 → 点「按当前形状生成」或「按当前底座搭建后生成」
批量生成的结果会列在上方「生成结果」里，点任意一行预览

⌨ 快捷键与鼠标

左键 拖拽绘制 / 替换

右键 拖拽擦除

Delete删除悬停的牌

滚轮 / Ctrl+滚轮缩放（以光标为中心）

空格 / 中键 拖拽平移画布

Ctrl+Z / Ctrl+Y撤销 / 重做

1 2 3普通 / 暗牌 / 吐牌

Q E切换层

S / A对称 / 显示全部层