跳到主要内容

审查 AI 代码:从规则到帧耗时

AI 写出的代码需要像任何外部贡献一样审查。能运行只说明覆盖了一条执行路径;类型通过也不能证明碰撞、时序、平台条件和资源回收正确。先明确要证明的行为,再从入口追踪到最终效果。

先审实现是否进入真实入口​

检查脚本是否挂到场景、组件是否启用、节点层级和引用是否正确、构建是否包含该场景。一个写得很完整但未引用的 CombatSystem 不会产生任何玩家可见结果。运行时日志也要区分编辑器预览、旧Web产物和本次微信构建。

接着沿调用链检查输入、规则和表现。若扣血只改了Label字符串,真正生命值未变化,就是表现与规则分裂。若攻击动画结束后才扣血,而规格要求有效阶段命中,就算截图看起来正常也不符合需求。

五个高风险检查面​

检查面具体追问典型失败
时间与状态dt单位?暂停是否冻结?旧回调是否失效?恢复后瞬移、死后重新进入Idle
空间与数值坐标空间?角度单位?距离定义?相机变化后点击错位、对角加速
生命周期谁订阅与取消?资源归谁?对象池是否重置?重复监听、复用旧冷却、异步加载到销毁节点
权威与异常谁决定奖励?失败是否可恢复?客户端改余额、重复回调重复到账
热路径成本每帧创建什么?遍历规模?资源何时加载?GC抖动、每帧查资源、无界粒子增长

用小段代码说明问题​

// 问题:重复enable会重复订阅,destroy前异步回调仍可能修改节点。
onEnable() {
input.on(Input.EventType.TOUCH_START, this.onTouch, this);
}
onDisable() {
input.off(Input.EventType.TOUCH_START, this.onTouch, this);
}

这段配对只解决订阅生命周期;仍要检查 onTouch 的异步工作是否会在组件停用后返回。可以用请求版本号、明确取消机制或有效性检查处理,选择与现有代码一致的最简单方案。

审查对象池时,列出全部临时状态:生命、朝向、动画进度、碰撞分组、目标引用、伤害去重表、计时器、监听和特效。只把位置归零远远不够。用“死亡回收 → 再生成 → 首次受击”的行为测试能发现很多问题。

避免测试只复述实现​

如果测试仅断言 update 调用了某个内部函数,就算功能错误也可能通过。优先证明玩家可见规则:同一攻击不能对同一目标重复扣血;被墙隔开不命中;暂停后模拟时间不变;收到重复奖励请求余额只增加一次。

表现需要浏览器或引擎环境验证,资源与平台能力需要相应目标。把纯规则抽成函数有助于快速测试,但不能代替节点层级、相机、输入和素材加载的集成检查。

给 AI 的审查工作单​

请审查当前diff与实际入口,围绕以下验收:<粘贴行为场景>。
先追踪调用链,不先提出重构。
每个问题请给:具体文件与位置、触发步骤、错误结果、影响、最小修正。
检查时间单位、坐标空间、状态转换、异步返回、订阅清理、对象池复用、热路径分配。
区分已证实缺陷、需要复现的风险和个人风格偏好。
修正后运行对应检查,报告实际命令、结果与未覆盖环境。

最终再看差异是否超出本轮范围。无关重命名、批量格式化和新框架会增加审查成本。复用现有能力,保持变更可解释;如果确需结构调整,把它要解决的具体问题和回归方式写清楚。

来源与版本​

本章审查清单为本手册的工程建议,基线Creator3.8.8。核查日期:2026-11-17。