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 · Mac 便携版 · 2026-10-15

开始使用
1. 把整个 ZIP 发给对方。完整解压到可写文件夹，例如“文稿”；不要只取出启动文件。
2. 双击“启动关卡编辑器.command”（StartEditor.command 是相同的英文入口）。
3. 浏览器自动打开编辑器。使用期间保留终端窗口，停止时在终端按 Control+C。
4. 无需安装 Node.js、Homebrew 或 Cocos，无需联网。

适用电脑
- macOS 11 或以上，Apple 芯片与 Intel 均有对应运行环境，启动时自动选择。
- 内置 Node.js 22.23.3 官方二进制，未依赖制作者电脑的 Homebrew 或系统 node。
- 此为本地网页工具便携包，不是已签名公证的 .app 安装程序。
- 如 macOS 阻止打开，先确认文件来源，再按系统自身的安全提示决定是否允许；本包不会自动修改系统安全设置。

编辑操作
- 左侧先选形状、特殊类型和颜色，再点击空位或拖入添加；门也用同样方式添加。
- 已有方块与门直接拖动；拖到下方垃圾桶删除，Command+Z 撤销。
- 纸箱、花瓣位于“覆盖功能”，可与特殊类型叠加；颜色可点击色板。
- 序列按点色顺序追加；点预览色块删除该位，也可删末位或清空。右侧修改后点“应用属性”。
- 花瓣用独立6色；门换色编码0～9对应颜色1～10，色板自动换算。
- 出块地块显示5代表5批，一次开门生成该批全部成员。新增批次后在紫色区域连续放多个方块，即属于同一批；顶栏与列表分别显示批数和块数。
- 跳跃门是挡板沿游戏门序跳格；可选初始挡板所在格、方向并查看下一跳预览。
- 保存草稿后从“我的编辑草稿”重开；导出JSON会下载到浏览器的下载位置。

数据与迁移
- colorBlock-level-editor/drafts：你的草稿，换版本前保留此文件夹。
- game-data/assets/custom/Json：打包时2020关游戏快照；原关只读使用。
- levels 和 colorBlock-similarity-checker/levels：各1920关参考/查重库。
- colorBlock/assets/custom/Json：1836份生成参考文件；其中历史色号非法的2001会如实报错并跳过，有效索引1835。
- 本包不包含制作者的测试草稿、个人设置、完整游戏工程或项目会话记录。
- 移动工具时移动整个文件夹。默认端口4488已占用会顺延，以启动窗口显示的地址为准。

配套工具与边界
编辑器0.7.0，生成/求解分析0.21.0，查重1.1.3。
左侧可打开生成、求解与设计分析、关卡查重；安装到Cocos需另备完整游戏工程并设置目标。
完整动态出块/地形求解仍未支持，静态检查与初态查重不等于可解性证明；生成器最高难度稳定交付仍是历史待办。
本轮在Apple芯片Mac上使用包内运行环境进行独立目录启动、保存及三个工作台检查；Intel实体Mac与收件人下载后的首次安全提示未实测，Cocos回放未执行。

运行环境来源与许可证
https://nodejs.org/en/blog/release/v22.23.3
https://github.com/nodejs/node/blob/v22.23.3/BUILDING.md
两种运行环境的官方压缩包SHA-256、二进制指纹及许可证见runtime各目录；全包文件清单见PACKAGE_MANIFEST.json。

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实机验证或最优性证明。完整地形/出块队列的截图自动还原尚未实现，需在编辑器补充。
