当前源码版本 0.21.0（2026-10-22）：新增初始脏污与洗澡地形编辑。
- 方块预设或选中方块属性中勾选「初始整块全脏」，使用独立
dirty:true；普通/特殊块、灰色/单色地块及出块批次成员均可使用。叠加type:1/10和固定障碍block:23不可带脏污；残留stacking不会使普通块误判为叠加。初始部分脏污不在配置范围。 - 选择「洗澡格」点击普通地面，可在可移动块下放置；在机关列表选中后修改坐标或删除。使用
LEVEL_INFO[0].washCells:[{x,y}]，坐标包含边墙、可玩区从(1,1)开始，与risefall相同。洗澡地形永久保留，拒绝越界、重复、缺口、升降/按钮/藤蔓、出块区域和固定障碍同格；失败保留原配置与撤销历史。 - 复制、批次编辑、保存、导入导出及撤销重做保留这些字段。盖板/冰冻/问号保护、按局部格清洗、门和道具等动态规则由游戏验证；编辑器只显示初始状态，不把清洗后的状态写回配置。
- 含脏污或洗澡格（包括未来出块批次）的关卡，编辑器及独立生成/求解分析/查重入口明确报不支持，不能得到可解性、最优性或相似度结论。截图自动识别不在本次范围。
- 画布通过资源服务读取同级 MatchMaster 工程的原始
assets/UI/prop/niba/xizao.png与niba1..4.png，不复制或改图。保存旧页后重启根目录 4-关卡编辑器.bat 加载新源码；现有 0.20.2 r2 便携包不含本次功能，本轮未重建发行包。
以下为历史维护记录。
历史版本 0.20.2（2026-10-20）：方块模式颜色区移到「形状」下、「特殊类型」上，门模式位置保持；激光门菜单不加 12。
源码更新（2026-10-20）：出块区域的新建与属性面板均可分别选择宽、高 1～10，支持 2×5、6×3、10×10 等矩形。点击区域左下角放置；超出地图或与另一出块区域重叠时拒绝创建并提示，修改失败保留原区域和批次。JSON 继续保存独立 width、height。保存草稿后重新运行根目录启动器，以加载新的服务端校验；下方 Windows r2 便携包已包含此更新。
游戏端边界：主游戏调试校验和门板图片仍只完整支持 2×2、3×3。本次仅完成编辑器；其他尺寸的游戏端校验及显示适配尚待确认，不能把编辑器导出成功当作 Cocos 实机通过。
Windows 便携包：下载 0.20.2 r2 ZIP（约 43 MB，42,950,296 字节）。完整解压后双击“启动关卡编辑器.bat”，内置运行环境，无需另装 Node.js。已在项目外中文空格路径使用包内 Windows 运行环境完成 23 项验收，包括矩形出块区域带批次保存/导出和越界拒绝；7908 份来源文件与包清单校验一致。未人工双击启动器或验证浏览器自动打开。更新前保留旧 drafts。
使用根目录 4-关卡编辑器.bat 启动。若旧服务正在运行，先保存草稿，再关闭其服务窗口并重新启动；仅刷新旧页面不足以加载新增服务路由。
- 左侧选择「门」，在「特殊类型」中选择「激光门」，点击「新建激光组」，选择该组的激光色。
- 依次选择「发射门」「接收门」「可控制开关门」，点击墙面门槽放置。两个头固定占 1 格完整直墙，控制门可选 1、2、3 格；接缝或拐角不可放置。
- 发射和接收必须共线相向，每组对应一扇控制门。不同组可以同色；控制门颜色使用普通颜色板，独立于激光色。选中部件可在右侧修改组编号、颜色、门槽及控制门长度，也可直接拖动，支持撤销/重做。
- 光束是忽略方块和地形遮挡的完整静态示意。不完整组允许保存草稿，导出会弹窗列出缺项或配对错误。
- 游戏 JSON 使用
LEVEL_INFO[0].lasers配对头、WALL_INFO[0][].laserId关联控制门，沿用此前 level9001 的格式；未改动字段及其他关卡组保留。当前主项目已无 level9001，本包按实际文件收录 2041 个游戏关卡快照。
当前求解和查重模型尚不支持激光；编辑器入口会明确拒绝此类分析，避免将激光门当普通门给出结果。请导出后在主游戏验证动态行为。本轮只重建 Windows 便携包，未扩展生成/分析/查重算法或主游戏的新尺寸支持。
本次 0.20.2 验证：浏览器确认「形状 → 颜色 → 特殊类型」顺序、选色及预设更新、切换普通门/激光门后色板返回原位置、回方块保留所选颜色；控制台无错误，app.js 语法检查通过。仅移动现有色板节点，未修改样式和配置数据。
前次 0.20.1 验证：浏览器从「门 → 特殊类型 → 激光门」完成三部件放置，切回普通门恢复原宽度及参数，切换方块后回到门保留激光配置；JSON 配对字段保持。语法检查及激光相关 17 项回归通过。
前次 0.20.0 验证：激光模型 9 项、静态渲染 7 项、HTTP 保存/导出/边界 1 项通过；编辑器全量 165 项中 162 项通过。3 个旧环境用例受旧 Mac 绝对路径或 Windows 符号链接权限影响，未改动。浏览器完成新建、三部件放置、改色/组名/宽度、拖动、撤销、删除恢复、草稿保存及下载操作；主项目 9001 无损往返及当前游戏纯校验逻辑通过，不代表新增关卡已做 Cocos 实机回放。
以下为历史记录。
最新0.13.2：恢复花瓣独立1～6颜色，点选六槽花瓣制作，显示已收/还差瓣数，花盆一键设为还差1瓣。0.13.1统一色号方案已撤回，旧游戏JSON无需迁移。
Mac入口 · 花瓣制作说明 · Mac包 · Windows包
以下为历史记录。
最新（2026-10-15 / 交接1.63.0）：编辑器0.13.1统一花盆/花瓣色号与色板，六色为10/8/5/3/2/6，序列按瓣数处理10，读写自动转换旧编码。联合343项及真实浏览器导出通过。
Mac入口 · 色号说明 · Mac 0.13.1包 · Windows 0.13.1包。完整解压，保留旧草稿。以下为历史记录。
最新（2026-10-15 / 交接1.62.0）：编辑器0.13.0修正第19关顶门侵入网格、跨行2×2冰块数字、相邻冰门合并、0/8孔洞歧义、红HUD过滤与浏览器ICC色彩转换。用户确认蓝紫2/紫红9，旧18关示例同步。原始三图自动6×9/27块/8门，两冻结块10/10与底色7/2，六冰门20/24/12/12/8/20；仅两图只缺冻结块底色。联合339项和真实浏览器载入导出通过。独立搬迁验证Mac20项、Windows文件/服务层18项，每包114文件SHA一致；Windows/Intel实体机未测。
Mac入口 · 完整图文说明 · Markdown原文 · Mac 0.13.0包 · Windows 0.13.0包。原图优先，旧草稿请保留；不是独立准确率或Cocos实机声明。以下为历史记录。
最新（2026-10-15 / 交接1.61.1）：编辑器0.12.1支持直接粘贴图片：截图还原内提供可聚焦粘贴区域，⌘V/Ctrl+V连续添加开局/补图；也支持主画布非输入区粘贴图片自动打开截图还原。只处理用户paste事件中的图片，普通文字粘贴、其他对话框和主页面输入框不拦截。沿用PNG/JPEG/WebP、单图5MB/总20MB/最多6张限制，读取期间防止重复添加与识别竞态。
Mac入口 · Mac 0.12.1包 · Windows 0.12.1包。打开截图还原后复制图片，点击粘贴区域按快捷键，再点击本地识别。浏览器两图连续粘贴及文字粘贴通过；原生Windows快捷键未实测。以下为历史记录。
最新（2026-10-15 / 交接1.61.0）：编辑器0.12.0修正桌面清晰第7关的列起点/透视偏斜、低饱和深绿漏识别和补图同尺寸错位；网格恢复6×8、15缺口、27块（三根黄1×3）、4门。冰冻数字先定位浅蓝内部再核对描边，避免与邻块粘连，自动读24/10/17，时间110、关号7。选中格可从误合并大块中独立组成新块，残余按连通形状拆分，不能表示的残余拆单格；网格脏时先重识别再操作，就近提示/撤销。新增6项客观回归，联合331/331，浏览器实际选格/撤销/改网格后自动重识别/载入/导出通过。
Mac入口 · Mac 0.12.0包 · Windows 0.12.0包。完整解压；使用原始截图；保留旧drafts。选格按钮现在是“选中格组成新方块”。原理与操作见修复说明。独立Mac19/Windows服务层17项验收通过，112源文件一致；见项目记忆5.87，原生Windows/Intel/Cocos未测。以下为历史记录。
最新（2026-10-15 / 交接1.60.1）：编辑器0.11.1：右侧选择冻结/锁块/问号/炸弹/叠加等计数类型立即显示对应输入，切换返回保留本次填写；只刷新计数区，不提前提交模型，最后一次应用和一次撤销。冻结门/锁门同步即时显示，修复新填次数被默认3覆盖。新增3项回归，联合325/325，浏览器普通块→冻结10→一次应用/撤销及普通门→冻结12→一次应用/撤销通过。
Mac入口 · Mac 0.11.1包 · Windows 0.11.1包。选择冻结就能直接填次数，最后点一次应用。完整解压，保留旧drafts。Mac18/Windows服务层16项独立验收通过，Windows原生/Intel/Cocos未测。以下为历史记录。
最新（2026-10-15 / 交接1.60.0）：编辑器0.11.0修复L/H形棋盘网格漏顶、透视格数、同色黄长条粘连、黄色竖2格误拆和冰冻门碎片。Downloads原图7.1/7.2识别6×8/27块/4门，8.1/8.2识别6×8/20个竖2格块/5门；手动调整网格重识别回归通过。未知时间不再默填180，按钮旁常驻缺项/几何/待确认原因，校对门可删除。第7关低清时间和3个冻结数仍需手填110/24/10/17，实际填后载入、保存、导出成功；第8关实际调网格重识别后导出成功。联合322/322、Mac18/Windows包服务层16通过；Windows/Intel/Cocos实机未测。生成分析0.21.0/查重1.1.3算法不变；理念1.35/EDIT-27、28/feedback78（86历史）及三台矩阵同步。
Mac入口 · Mac完整ZIP · Windows完整ZIP · 修复说明。完整解压，保留旧drafts。以下为历史记录。
最新（2026-10-15 / 交接1.59.0）：编辑器0.10.0将画布内部方块ID换为完整“色号3”“冰冻10”等功能与计数标注，JSON ID保留；Level下方关号自动读取、可修改，读不清留空。第17/18关七图回归通过，新增保留数字孔洞的关号识别及4个校准字形。联合317/317、实际浏览器识别17/载入/修改/撤销/保存通过，Mac17/Windows服务层15项分发检查通过；Windows/Intel/Cocos实机未测，校准样本不代表独立准确率。生成分析0.21.0/查重1.1.3算法不变；理念1.34/EDIT-25、26/feedback77（85历史）与三台矩阵同步。
本轮追加偏好（2026-10-15）：叠加块用“叠加3”表示上层3号颜色，下层仍显示“色号X”；已同步标注模块、回归和双平台分发，三台数据协议无需修改。 Mac入口 · Mac完整ZIP · Windows完整ZIP · 使用与验证说明。完整解压使用，保留旧drafts。以下为历史记录。
最新（2026-10-15 / 交接1.58.0）：编辑器0.9.0新增最大时间自动开局（可手动覆盖）、亮绿3/深绿7映射、数字锚点分离冻结块及按时间顺序补底色，保留初态计数/位置；四组叠加外观作为待核对候选。第17关五图实测6×8/24块/7冻结块/5门；第18关示例及缩放回归同步。联合312/312与真实浏览器乱序上传/载入/保存/撤销重做通过；Mac16/Windows服务层14项独立分发检查通过，Windows/Intel实体及Cocos未测。原图参与字形校准，不能宣称独立准确率。生成分析0.21.0/查重1.1.3算法未改，理念1.33/EDIT-23、24/feedback76（84历史）/交接1.58.0及三台矩阵同步。 Mac入口 · Mac完整ZIP · Windows完整ZIP · 操作、原理与后续样本。完整解压双击启动，保留旧drafts。以下为历史记录。
最新（2026-10-15 / 交接1.57.0）：编辑器0.8.0默认本地截图识别，无需API或联网。自动网格/色块/普通冰冻门/部分字形，提供网格与分块校正、补图点选取色和纸箱花瓣补选。校准样图还原18块6门；独立准确率、所有盖板/皮肤不作保证。 Mac入口 · Mac完整ZIP · Windows完整ZIP · 原理、操作与限制。内置运行环境与字形掩模，不含原截图、密钥或测试草稿。完整解压，保留旧drafts。以下为历史记录。
最新（2026-10-15 / 交接1.56.0）：编辑器0.7.0新增“截图还原”。上传开局/补充图，填自己的OpenAI API密钥，识别后校对并可撤销载入。内含第18关人工核图示例；真实付费AI准确率未测，凹边界门仍不支持求解。 Mac入口 · Mac完整ZIP · Windows完整ZIP · 使用说明。包不含密钥/截图/测试草稿，更新前保留旧drafts。以下为历史记录。
最新（2026-10-14 / 编辑器0.6.0 / 交接1.55.0）：门旁常驻显示功能、计数和色号，例如“冰冻5 / 色号3”“锁门4 / 色号2”，伸缩显示“伸3格”。修改后应用属性、撤销、重开和拖动均同步；数字为编辑初值，不是运行时自动倒计时。无需点选，旧关加载后自动显示。 Mac编辑器入口 · Mac 0.6.0便携ZIP · Windows 0.6.0便携ZIP。完整解压，Mac双击启动关卡编辑器.command，Windows双击StartEditor.bat；更新前保留旧drafts。三台随包0.21.0/1.1.3，以下为历史记录。
Mac分发（2026-10-14）：可发送的Mac完整ZIP，内含Apple芯片/Intel双运行环境，解压双击“启动关卡编辑器.command”。无需安装Node/Homebrew；当前编辑器0.5.0、配套生成分析0.21.0。使用时保留终端窗口，换版本先保留drafts。原有Mac工程入口继续可用，旧Windows包未改。
当前版本0.5.0（2026-10-13）：一批多个方块的连续放置、批数与块数独立显示；覆盖/门/叠加颜色可点色板，序列可视追加与删除。见新功能说明。
Mac入口 · Windows 0.5.0 ZIP。完整解压后运行StartEditor.bat，更新前保留旧drafts。以下为历史记录。
历史版本0.4.0（2026-10-13）：纸箱/花瓣“覆盖功能”直接可见，跳跃挡板逐格选择与下一跳提示。操作与源码边界见说明。
Mac入口 · Windows新版便携包。完整解压后运行StartEditor.bat；旧版本说明见下。
ColorBlock 关卡编辑器 0.3.0
独立本地可视化编辑器。Mac 双击根目录 4-关卡编辑器.command，Windows 双击 4-关卡编辑器.bat。需要 Node.js 20 或以上；不需要安装依赖或 Cocos Creator。默认地址为 http://127.0.0.1:4488，端口占用时自动顺延。不要直接打开 web/index.html。
使用
- 从左侧选择 MatchMaster 本机关卡、交接关卡库或我的编辑草稿；也可以导入/拖入 Cocos JSON。
- 左侧选「方块」，先选形状、特殊类型、计数与颜色，再点棋盘空位添加，或拖动下方预览卡放入棋盘。已有方块随时可以直接拖动，不需切换「选择」工具；方向键微调，⌘/Ctrl+D 复制。
- 左侧选「门」，先选宽度、特殊类型、计数与颜色，点击边缘或把预览卡拖到边缘添加。已有门可直接整组拖动，跨边自动转向吸附；无效位置回退。方块/门拖到棋盘下方垃圾桶即删除，⌘/Ctrl+Z 可恢复；Delete 仍可用。缺口工具保留物理门位，无法保留则整次拒绝。
- 右侧调整尺寸、时间、机制和计数。组合属性在折叠面板编辑；左侧可绘制升降、按钮、藤蔓和出块区域。选出块机关后进入批次画布，沿用方块操作。高级 JSON 仍保留。
- ⌘/Ctrl+Z 撤销，⌘/Ctrl+Shift+Z 重做。撤销覆盖整关数据，包括门、地图和高级字段，最多 100 次。
- 保存草稿写入本项目
drafts/，每次建立唯一新文件，可从「我的编辑草稿」再次打开；不会覆盖游戏关卡。导出游戏 JSON 发起浏览器下载，红色静态问题须先修复。草稿保存允许不完整设计。 - 下方可对提交时的关卡快照求解、停止求解、比较历史相似关。修改画布不会改变已经提交的快照，结果显示过期提示。左侧可打开已有生成、分析和查重工作台。
数据与校验边界
- 原始 Cocos JSON 是编辑源；没有通过求解器格式往返重建。无修改导出保持 JSON 语义一致，空格、换行不保证逐字节一致。
- 所有顶层/嵌套未知字段和额外关卡组保留，画布只操作第一组。已有非格点坐标不会自动取整。
- 新方块/门 ID 单调分配；复制和撤销后继续添加不复用 ID。叠加块上层保留
id+1空间。 - 初始粘合跟随块允许
adhesiveTime=1；spawnGates 批次成员按当前游戏源码检查至少 2。固定障碍 block23 不解释历史残留计数。 - spawnGates 已有区域/批次/成员画布，检查批次占格、区域、互补变色与 ID；risefall 已有升降/按钮/藤蔓路径画布。完整动态生成、配对动画与空间释放全过程仍须 Cocos 验收。
- 当前初始布局检查要求整块不重叠。type22 游戏运行中的同色穿透，不等于任意初态重叠均被编辑器接受。
- 门可直接拖动，也可在右侧改门槽/宽度及附加机关，保留其他属性。点选旧对象优先于添加，不会误新增。出块批次只编辑当前批次成员，门仍属于初始棋盘。
- 求解复用现有 cocos-behavior-v2 模型和有限预算，不是游戏模拟器。spawnGates 明确拒绝求解；升降、其他未支持机制由现有模型拒绝。超时/资源中止是未知，不是无解。
- 查重默认 90%，比较初始布局；包含出块机关时明确提示不比较其区域或后续队列，不代表完整玩法等价，也不证明可解性。
- 最优拖动数、已找到路线、人工难度/趣味评价分别报告。没有进行 Cocos 实机回放和 Windows 实机测试。
本机关卡目录
默认 MatchMaster 目录为 ~/Documents/MatchMaster/MatchMaster/assets/custom/Json。可通过 COLORBLOCK_GAME_LEVELS 环境变量指定。目录不存在时可选交接库或导入文件。没有 Git fetch/pull、自动安装进游戏或覆盖原关的行为。
验证
运行 npm test。核心回归包含 1,920 个交接关卡的无损往返，ID、非法拖动原子回滚、缺口/门位、尺寸、撤销、出块支持边界，以及真实本地保存/求解/查重和三个工作台的连接。
0.2.0 额外只读核验最新 MatchMaster 的 2,020 个 JSON 全部可无损往返。历史数据仍可能有重复 ID、错位、重叠等静态问题；导入成功不表示关卡有效。详见 docs/game-corpus-audit-020.json 与 docs/MATCHMASTER_020_UPDATE.md。
UI 验收草稿 level990001 是测试放置/拖动/保存的最小样本，不是正式设计交付关卡。
0.2.0：游戏库最大号之后建议新编号；B组加时仅预览不写回基础time；重复ID按钮只修当前草稿且可撤销。990002是本轮藤蔓/出块UI验收草稿，不是正式设计。
0.3.0：直接拖动、垃圾桶删除、左侧预设与点击/拖入添加均已实现；非法落点回滚，每次有效操作只占一步撤销。Esc 取消拖动/放置；触控取消或窗口失焦不提交。详见 docs/INTERACTION_030.md。990003为本轮交互验收草稿，非正式设计。
发给 Windows 使用者
便携发行包：根目录outputs/windows-editor-20261013/ColorBlockEditor-Windows-x64-0.3.0-20261013.zip。整包发送、完整解压、双击StartEditor.bat，内置Node22.23.3，不需安装Node/npm/Cocos。Windows10/11 x64（Intel/AMD）目标，启动与保存均使用包内相对路径。无需把整个开发工作区发给对方。
打包脚本scripts/package-editor-windows.py核对官网SHA-256/PE架构并保留许可证；scripts/verify-windows-editor.mjs在移出原项目后的目录检查包内服务。已进行Mac上的搬迁验证，Windows双击/浏览器自动打开未实机测试。详细说明和源指纹在ZIP内。