为什么要做一个 AI 原生引擎

大多数游戏引擎的 API 是给人写的。当写代码的主力变成 AI，引擎就该换一种长法。

ForgeaX 的核心是：用户描述游戏，AI 来写引擎代码。这听起来只是"换个人写代码"，但真正做下去会发现，现成引擎对 AI 并不友好 —— 它们假设的读者是一个能看文档、能猜、能脑补上下文的人类。

我们的取舍很简单：AI 是引擎的第一用户。当"对 AI 友好"和"对人友好"冲突时，优先 AI。 下面是几个具体的做法。

一、单一可信源，其余派生

同一个事实只有一处定义，其他地方都从它派生。比如组件的字段定义内联在 schema 里，inspector、调试器、工具链直接读 schema，而不是去 grep 源码瞎猜。AI 不需要"记住"散落各处的约定，因为约定只有一处。

错误不是 throw 一句人话就完事。我们用闭包的错误码，每个错误自带"这是什么、为什么、怎么恢复"的结构化信息。AI 拿到错误，能直接知道下一步该改哪里，而不是把异常文本当成玄学。

渲染 bug 最难的地方在于"它在屏幕上看起来不对"。人可以盯着显示器调，AI 不行。所以引擎支持把一帧的渲染调用录下来 —— draw call、绑定、渲染目标、管线状态都能离线读取、重放、定位到第 N 次绘制时的完整状态。视觉问题被转成了 AI 能 Read 的数据。

渲染层有两套后端实现（WebGPU 与一套 wasm 实现），走同一套接口。它们同时出图：一旦 AI 把引擎 API 用错了，另一套后端会立刻表现出不一致，问题随即暴露。这比"等人来 review"快得多。

这些设计有一个共同的衡量标准：读者（无论人还是 AI）要装进脑子里的概念越少越好。 API 越自洽、越能就地索引，AI 写对的概率就越高，人来接手时也越省心。

AI 原生不是一句口号，而是一连串"为 AI 视角重做一遍"的具体决定。我们会在文档和后续更新里，把这些逐步展开。