本目录把改动路径映射到 package 与检查,是 GT6CE 的验收入口。检查命令均在仓库根目录执行。
| 路径 | 用途 |
|---|---|
| routes.yaml | 改动路径到 package 与检查的路由 |
| checks/ | 各检查的验证方式、注意事项与运行命令 |
overrides/ |
少数路径的特例,出现时创建 |
checks/ 目前包含 junit、api-contracts、gametest、compile、assemble、format 与 manual-ingame。package 的验收章节在 docs/architecture/packages/<package>.md(入口见包索引),本目录不重复。
修改代码、资源或构建脚本后按以下流程选择检查。package 的 ## 验收 与检查文档的 ## 注意事项 必须逐条满足;## 运行命令 必须通过,任一命令失败即停止后续检查。
- 列出改动文件:
git status --short或git diff --name-only。 - 运行
python tools/validation/route.py route --changed <路径>...,得到命中的 package 与检查;安装、输出字段与check用法见工具文档。 - 读取并遵守命中的
docs/architecture/packages/<package>.md验收章节,逐条核对其中要求。 - 按命中的
checks/<id>.md逐条核对并满足## 注意事项,再执行## 运行命令;任一命令失败时立即停止。 - 按下述格式报告结果。
纯文档改动检查相对链接、标题锚点、术语和命令一致性,无需编译或启动游戏。可先运行 python tools/validation/route.py check 检查路由与检查文档;它不检查全仓链接或标题锚点,详见工具说明。
交付时分别列出“执行且通过”“执行但失败或阻塞”“尚未执行”,写明实际命令、失败原因与未覆盖的平台或场景。编译、打包、自动测试和游戏行为分别判定,不能相互代替。
长期兼容审计结论按场景使用“未验证 / 部分验证 / 在下述范围验证通过 / 已知失败”,记录源码状态、环境版本、操作、预期与实际结果。使用兼容报告模板保存跨模组可复现结论;其余材料的归属见文件与产物归属。
verify 运行 :api:check :core:check :buildtools:check :minecraft:spotlessCheck;build 对两个节点运行 assemble、compileTestJava 与 spotlessCheck。GameTest 不在 CI 或 check 内,需要本地用两个节点的 runGameTestServer 单独运行。