AI 调试工具箱

AI 出问题时，工具比经验重要。UE 提供一套完整的 AI 可视化诊断。

AI Debug 视图（按 ' 或 Shift+F9）

打开后会显示当前观察的 AI 的：

• 行为树状态：当前节点高亮、装饰器值；
• 黑板：所有键值（这是排查"AI 为什么不动"的第一手段）
• 感知：视野锥、听到的事件、当前目标；
• EQS：上次查询的候选点与得分；
• 导航路径：当前正在走的路径。

操作：按 ' 循环切换观察的 AI（数字键选具体 Pawn）。

Visual Logger（可视化日志）

AI Debug 是"现在看一眼"，Visual Logger 是"事后回放"。它把 AI 的状态、事件、自定义打点按时间线录下来，事后按帧回放：

• 每个时点的感知结果、黑板值、决策原因；
• 自定义打点（在自定义任务里写一条日志，回放时显示）；
• 按时间筛选、按 AI 筛选。

适用场景：QA 报"AI 在第三关卡住了"，回放最后 30 秒，看到它某帧 EQS 查询全失败。

调试命令

调试的工作流建议

1. 先定位层次：是移动（导航）、感知（感知）、还是决策（行为树）？用 AI Debug 一眼分层；
2. 再定位时序：是偶发还是必现？必现用断点 / AI Debug；偶发用 Visual Logger 录制；
3. 最后定位环境：只有打包出现？先查资产引用与烘焙数据。

AI Debug 与 Visual Logger 的详细用法见官方 AI调试 文档。把这两个工具用熟，AI 开发效率会有质变。