用途:在 codesmith 生成 src/scenes/Game.js 之后、启动开发服务器之前做静态检查,也可在 refiner 修补后复跑以捕捉回归。
主要能力:扫描 Game.js 中作为动画键或纹理键使用的字符串字面量,与 manifest 比对。动画键检查 .play('KEY')、.play("KEY")、.chain('KEY')、.chain("KEY") 等模式,合法键由 manifest.sprites 推导:对每张 sheet 的每行 r 与每列 c,合法键为 ${r}-${c.toLowerCase()},例 KNIGHT-walk、SLIME-idle。纹理键检查 this.add.sprite、this.add.image、this.physics.add.sprite、this.textures.get、this.load.image、this.load.spritesheet 等模式;合法值包括各 s.textureKey(如 entities-1)、始终存在的 'tiles'、以及 manifest.bg 存在时的 'bg'。另检查 setFrame(N) 或 .frame = N 的帧索引是否超出 sheet 单元格数(rows.length * cols.length)。
使用方式:运行 scripts/audit_manifest.mjs <project-dir> 做静态分析;加 --fix 可就地应用最佳猜测修正。输出 JSON 含 ok、errors、warnings、total、issues,issues 项含 kind、key、line、suggestion、severity。退出码 0 为全部通过,5 为发现错误,3 为文件缺失。
流程与限制:如有错误,以 { "kind": "manifest-key-mismatch", "message": "..." } 形式交给 refiner 修复键字符串,再复跑,干净后进入 playtester。--fix 的修正为最佳猜测,需自行确认。