# MatchMaster 关卡工具项目

当前工程：生成/分析 0.21.0、查重 1.1.3、编辑器 0.19.1。

安装 Node.js 20 或以上版本后，Mac 双击根目录的 `.command`，Windows 双击同名 `.bat`：

- `1-生成工作台`：生成与设计关卡。
- `2-求解与设计分析`：求解、判死与设计分析。
- `3-关卡查重器`：管理关卡库、比较相似度。
- `4-关卡编辑器`：手动编辑、截图还原与导出。

完整使用说明见 [工具使用说明.md](工具使用说明.md)，接手前必须阅读 [PROJECT_PROGRESS.md](PROJECT_PROGRESS.md) 和 [AGENTS.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 源码快照及关卡库。部分历史校准/审计脚本引用外部原图或游戏路径，不是工作台启动依赖。

## 验证

在仓库根目录运行：

```sh
node --test colorBlock-level-generator/test/*.test.js colorBlock-level-editor/test/*.test.js colorBlock-similarity-checker/test/*.test.js
```

服务测试需要本机回环端口。测试不等同于 Cocos 实机回放或所有关卡最优性证明。