33 lines
2.1 KiB
Markdown
33 lines
2.1 KiB
Markdown
# 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 实机回放或所有关卡最优性证明。
|