ColorBlock 关卡编辑器 0.20.2 · Windows x64 便携版 · 2026-10-20 r2

开始使用
1. 将 ZIP 完整解压到可写文件夹，不要在压缩软件内直接运行。
2. 双击“启动关卡编辑器.bat”或 StartEditor.bat，会使用包内运行环境打开浏览器。
3. 保留启动窗口；关闭窗口即停止服务。浏览器未自动打开时，复制窗口中的本地地址到 Edge / Chrome。
4. 无需另装 Node.js、npm 或 Cocos Creator；适用于 Windows 10/11 的 Intel/AMD 64 位电脑。

当前编辑功能
- 出块区域：新建与属性面板的宽、高分别选择 1～10，可组合 2×5、6×3、10×10 等尺寸；超出地图或重叠时拒绝并提示。
- 本包更新编辑器；主游戏其他出块尺寸的校验及门板显示适配尚未完成，游戏端仍以 2×2、3×3 为已支持尺寸。
- 方块：依次选择形状、颜色、特殊类型，然后放置。
- 激光门：门 → 特殊类型 → 激光门 → 新建激光组，依次放置发射门、接收门、可控制开关门。
- 发射门和接收门各占 1 格完整直墙，须共线相向；控制门长度为 1、2、3 格。
- 每组独立编号配对；激光色和控制门颜色独立，允许不同组使用同一激光色。
- 编辑器光束为完整静态示意，不模拟遮挡；缺件可以保存草稿，导出前须补全。
- 激光 JSON 使用 lasers / laserId 配对，控制门仍为 special:0，不需要改成 12。
- 当前求解、设计分析和查重尚不支持激光关卡；激光动态效果请在主游戏内验证。

文件与更新
- colorBlock-level-editor/drafts 是自己的草稿目录；更换版本前保留或复制此目录。
- game-data/assets/custom/Json 是本次随包的 2041 个游戏关卡快照，以当前主项目实际文件为准。
- 整包移动仍可用，不要只复制启动文件；不包含个人配置、已有草稿、Git 或完整 Cocos 工程。
- 关卡快照不会自动更新，可导入其他 JSON；导出游戏 JSON 后再放入主项目。
- runtime/LICENSE 和 runtime/SOURCE.json 记录运行环境许可证及来源；PACKAGE_MANIFEST.json 记录文件校验。

以下为历史功能说明，其中版本、快照数量及实测记录仅对应当时发行包：

0.14.0 新增：固定木板识别（开局图+揭盖图+露门图）；草稿可永久删除、不备份；右侧可选择导出文件夹并记住位置，同名文件自动加序号。详见 colorBlock-level-editor/docs/WOOD_DRAFTS_EXPORT_0140.md。

0.13.2：恢复花瓣独立1～6色，与方块颜色无关。点色板添加一瓣，点已有花瓣删除，显示已收/还差数量。花盆先选接收色，再点“设为还差1瓣”快捷创建；清空花盆已有花瓣可移除。无需填写数字串。
说明见 colorBlock-level-editor/docs/PETAL_EDITOR_0132.md。下方0.13.1统一色号方案已撤回，旧关卡JSON无需迁移。

0.13.1：花盆与花瓣配置统一为普通方块色号：红10、黄8、青5、浅绿3、紫2、橙6；所有色板同步。点颜色添加，点序列色号删除；手填用空格或逗号分隔，10算一瓣，最多六瓣。旧关卡自动转换，游戏JSON保持兼容。说明见 colorBlock-level-editor/docs/FLOWER_COLORS_0131.md。

0.13.0：修复第19关顶门混入网格、跨行2×2冻结块与10、相邻冰门20/24、0/8数字、红色HUD和截图ICC解码。蓝紫对应色号2、紫红对应9。直接粘贴或选文件均可。完整图文说明：双击 colorBlock-level-editor/docs/SCREENSHOT_RECOGNITION_EXPLAINED.html。原图识别6×9、27块、8门；缺解冻补图只留底色未知，低清或陌生皮肤仍需校正。保留旧drafts后再使用新版。

0.12.1：可以直接粘贴截图。打开“截图还原”，复制截图后按⌘V（Mac）或Ctrl+V（Windows）；也可点击粘贴区域后粘贴，连续添加开局图与补图，最多6张。文字粘贴保持正常。图片仍在本地处理。

0.12.0：修正清晰截图的网格偏斜、黄色长条粘连及冰冻门数字与方块粘连；第7关桌面两图自动识别6×8、27块、4门，冻结24/10/17。
点选格子后按“选中格组成新方块”，可从误识别大块中独立取出所选格；剩余不支持形状拆成单格，可继续组合。结果和失败原因在按钮旁显示，并可撤销上次校正。改网格后执行选格操作会先重识别，重识别会替换此前分块校正。低清未知数字仍需核对。

0.11.1：右侧选择冻结等机制后立即显示次数输入框，填好后一次应用。切换类型保留本次输入；冻结/锁门同步修复。

0.11.0：修正L形/H形棋盘完整边界、同色长块分割与冰冻门合并。不能载入时，按钮旁列出缺失色号/计数/时间或非法形状；可删除误识别门。低清数字不猜，请按提示补填。
叠加块显示“叠加3”代表上层3号颜色，下层仍显示“色号X”。
ColorBlock 关卡编辑器 0.10.0：画布显示色号/功能计数，截图读取Level关号

普通方块显示色号3等；冻结块显示冰冻10及底色色号；锁/问号/炸弹/纸箱分别显示真实初值。内部方块ID保留在JSON中，画布不再显示。
截图识别自动读取左上角Level下方关卡编号，可修改；无法辨认时留空，请填写后载入。保存仍为独立新草稿，不覆盖原游戏同编号关卡。

以下为之前功能和启动说明：

ColorBlock 关卡编辑器 0.9.0：冻结方块、双色绿与自动选开局

添加同一关的截图后直接点击本地识别，默认选顶部时间最大的一张；缩略图显示时间，可手动覆盖。
亮绿色映射3号浅绿，深绿色映射7号深绿。冻结块保留开局位置和计数，按时间顺序寻找同位置露出的底色。移动/替换过的块请核对或点选补图取色。
第17关五图已校准并回归：24块、7冻结块、5门；第18关原示例也已修正绿色。样本参与字体校准，不是独立测试集准确率。
叠加样式是初态候选，变形等后续行为仍须核对；纸箱和花瓣仍需新样本。

以下为之前功能与使用说明：

ColorBlock 关卡编辑器 0.8.0：本地截图识别

顶部“截图还原”→添加开局图与补图→“本地识别截图”。无需API密钥，无需联网，图片在浏览器内存处理。
自动测量网格、色块、普通/冰冻门与部分数字；可拖网格四角、合并/拆分方块、设空格/缺口/障碍，补图点选取色。
纸箱/花瓣等复杂功能需在对象中补选，数字不确定时必须手填。相近色号、初始时间和编号请核对；不是所有游戏截图都能自动准确识别。
本次两张第18关图用于开发和字体校准，不代表独立样本准确率。小图、模糊图可能漏识；建议使用原始截图。
网格改动后重新识别；重新识别会替换当前识别草稿内的手工校正。确认后载入可撤销，保存为新草稿。
“联网AI”仅为可选项，展开并主动点击时才使用自己的API。

以下为已有功能与启动说明（历史版本说明仍适用）：

ColorBlock 关卡编辑器 0.7.0 · Windows x64 便携版

开始使用
1. 将 ZIP 完整解压到普通可写文件夹（例如桌面）。不要在压缩软件里面直接运行。
2. 双击 StartEditor.bat，或“启动关卡编辑器.bat”。
3. 编辑器会在默认浏览器打开。运行期间保留黑色启动窗口，关闭它即停止服务。
4. 如果浏览器没有自动打开，复制启动窗口里的 http://127.0.0.1:端口 地址到 Edge / Chrome。

不需要安装 Node.js、npm 或 Cocos Creator，不需要管理员权限。运行文件已随包提供。
适用目标：Windows 10 / 11，Intel 或 AMD 64 位电脑（x64）。不是32位或ARM64原生包。
本包在Mac进行了移出原项目后的服务/保存/分析/查重验证，尚未在Windows实机双击验收。

操作
- 覆盖功能：左侧“方块”下直接配置纸箱和花瓣，再放置；选中方块后右侧同样可改。纸箱名称保留，分固定/可移动，配置次数、分组和计数颜色。
- 花瓣色号独立为1～6；“初始已有序列”不是目标序列，已有5瓣表示还差1瓣，填满6瓣不会在载入时自动揭盖。发送和接收可同时设置。其他开关锁/方向/换色字段在“其他组合属性”。
- 跳格门：左侧选择初始挡板第几格；放置后右侧勾选具体门格，或点“在画布点选挡板格”。选择全关方向，最后点“应用属性”。画布箭头和文字标出下一跳。
- 跳的是门上的挡板，沿游戏门序逐格循环，可跨门；没有任意选择棋盘目标格的机制。取消挡板会移除字段，不能用false代替。该预览不等于动态试玩或求解证明。
- 在左侧先选方块形状、特殊类型、颜色及计数，再点空格或拖预览卡添加。
- 门也在左侧配置宽度、特殊类型和颜色，再点边缘或拖入添加。
- 已有方块和门随时可拖动，不需要先切换“选择”。门会吸附到合法边缘。
- 拖到下方垃圾桶删除；Ctrl+Z撤销，Ctrl+Shift+Z重做。
- 保存草稿后，可以在“我的编辑草稿”中再次打开；导出JSON到浏览器下载目录。

出块批次与颜色（0.7.0）
- 地块显示5表示5批，不是5个方块；一次开门生成整批成员，区域清空后再开启下一批。
- 放置出块区域后点“新增一批并摆放方块”，在紫色范围内连续添加多个方块，即属于同一批。
- 顶栏显示当前批次、本批块数，可切换前后批次或返回列表；列表分别显示批数和合计方块数。
- 同批成员不可重叠，须完整放进区域；不同批可以占同一位置，空批要补成员才能正式导出。
- 纸箱计数色、花瓣序列和接收色、叠加上层、门换色/旋转/按钮颜色均可点色板。
- 序列按点击顺序追加，点预览色块删除该位，也可删末位/清空。右侧修改后点“应用属性”。
- 花瓣使用独立6色；变色编码0代表颜色1、9代表颜色10，色板自动换算。数字框保留兼容原数据。

数据位置
- colorBlock-level-editor/drafts：你的编辑草稿。迁移或更新版本前保留此文件夹。
- game-data/assets/custom/Json：随包的2020关MatchMaster快照，只读使用。
- levels：1920关参考库。colorBlock-similarity-checker/levels：查重库。
- colorBlock/assets/custom/Json：生成工作台的既有参考资源，不是完整Cocos游戏项目。
- 随包关卡为2026-10-15打包时的快照，不会自动联网拉取。可通过导入JSON打开其他新关。
- 原关不会因画布编辑被覆盖。将整个文件夹移动到另一位置仍可使用，不可只复制bat或node.exe。

配套功能
左侧保留生成、求解与设计分析、查重入口。所有运行均在本机，无需联网。
“安装进Cocos”需要另外准备你自己的完整Cocos工程并设置目标，本包没有包含游戏引擎工程。
复杂机关有明确的模型限制；静态检查不等于可解性证明，求解结果不等于Cocos实机验证。
关卡快照可能包含重复ID等历史静态问题，导出前按提示修复草稿，不要误以为打包已修全部关卡。

故障排查
- 找不到runtime/node.exe：重新完整解压；不要只取出启动文件。
- 默认4488端口已占用：程序会自动换下一个可用端口，看启动窗口实际地址。
- 保存失败：确认所在文件夹可写，不要放在Program Files或只读共享目录。
- 关闭启动窗口后网页断开：重新双击启动文件，使用新打开的页面。

第三方运行环境
Node.js v22.23.3，Windows x64，许可证见runtime/LICENSE。
下载来源与官方SHA-256核对记录见runtime/SOURCE.json；包内文件清单见PACKAGE_MANIFEST.json。
无需安装或改变系统PATH。

0.7.0 门旁标注
门旁常驻显示功能、计数和色号，例如“冰冻5 / 色号3”“锁门4 / 色号2”；不必点选。修改后点应用属性，标注随之更新；撤销、移动、重开关卡也同步。
伸缩长度显示“伸3格”，与计数区分。组合颜色与序列也可见；同门各格值不同时分别标注。数字是当前编辑初值，不是运行时自动倒计时。

0.7.0 截图还原
顶部“截图还原”：添加1～6张PNG/JPEG/WebP图，指定开局图；后续图仅补隐藏颜色。填自己的OpenAI API密钥和支持图片的模型，点击开始识别。图片和说明会发送到OpenAI，按你自己的API账户计费。密钥仅在当前页面，不写入包、文件或浏览器存储。
对照预览检查待确认项，颜色/计数/编号/时间可直接改；几何和覆盖字段可在完整识别JSON修正。确认后载入画布，支持撤销；再保存草稿或导出游戏JSON。
没有密钥也可查看本次第18关人工核图示例，或导入对话助手返回的识别JSON。缺颜色/计数/非法形状会阻止载入，不悄悄补默认值。
本轮未使用真实API密钥发起付费识别，真实识别准确率与账户模型权限需使用者首次运行确认；截图还原不等于Cocos实机验证或最优性证明。完整地形/出块队列的截图自动还原尚未实现，需在编辑器补充。
