2.1 KiB
MatchMaster 关卡工具项目
当前工程：生成/分析 0.21.0、查重 1.1.3、编辑器 0.19.1。
安装 Node.js 20 或以上版本后，Mac 双击根目录的 .command，Windows 双击同名 .bat：
1-生成工作台：生成与设计关卡。2-求解与设计分析：求解、判死与设计分析。3-关卡查重器：管理关卡库、比较相似度。4-关卡编辑器：手动编辑、截图还原与导出。
完整使用说明见 工具使用说明.md，接手前必须阅读 PROJECT_PROGRESS.md 和 AGENTS.md。
仓库内容与本地产物
保存当前源码、Cocos 资源、关卡库、测试及像素样本、设计规则、反馈、说明和验证证据。
colorBlock/build-templates 是自定义构建模板，随源码提交。Cocos 的 library/temp/build/local 等缓存、个人导出路径、私有 IDE 配置和便携分发包不提交。
生成器 runs 是已有忽略规则下的运行结果，仍保留在本地；正式关卡和研究证据另存于 levels、examples、docs、feedback 与 outputs。
按 2026-10-16 用户要求，旧便携包、重复解压目录及 20261012 迁移包已清理；本地 outputs/releases 仅保留最新 0.19.1 Mac/Windows ZIP 与 SHA256。需要重建时运行 scripts 中的打包工具。历史文档提及的旧分发包路径不再有效，但对应验证记录保留。
Mac 编辑器的“游戏当前关卡”默认从 ~/Documents/MatchMaster/MatchMaster/assets/custom/Json 读取；可通过 COLORBLOCK_GAME_LEVELS 指向实际游戏目录。该外部游戏工程不属于本仓库，本仓库另带 colorBlock 源码快照及关卡库。部分历史校准/审计脚本引用外部原图或游戏路径，不是工作台启动依赖。
验证
在仓库根目录运行：
node --test colorBlock-level-generator/test/*.test.js colorBlock-level-editor/test/*.test.js colorBlock-similarity-checker/test/*.test.js
服务测试需要本机回环端口。测试不等同于 Cocos 实机回放或所有关卡最优性证明。