AI 协作:让 AI 读写你的 Verse

一、你没法把一张节点图粘进对话框

先还原一个所有蓝图作者都经历过的场面。你卡在一个 bug 上,想找人问问——同事、论坛,或者一个 AI 助手。你的标准动作是:截图。

然后你就开始丢东西。截图里没有引脚的类型,没有变量的默认值,没有 Details 面板上那几个决定成败的勾选项,没有被 Collapse 折叠进去的三张子图,也没有另外两个明明参与了这段逻辑、却不在这一屏里的资产。对面拿到的是一张画,得靠猜把它还原成逻辑。你多半还要补一句「哦对了,那个 Delay 是 5 秒」——补了三句,还是有第四句忘了补。

反方向更难。就算对面想通了,它也交不回来:没有人能给你生成一份 .uasset。它只能用文字告诉你「在 Branch 的 True 那一路后面加一个 Set 节点,把 Bool 变量置为 true」,然后由你打开编辑器,手动找位置、手动连线、手动确认自己没连错。一次求助,两头都在做有损转换。

Verse 把这条链路的两头同时打通了。注意原因:不是 AI 变强了——能读懂代码这件事,AI 早就会了。变的是你的逻辑的存在形式。它从一张只能被眼睛读的图,变成了一份能被完整粘贴、能被逐行引用、能被原样交还的文本。

这就是本课的技术前提,只有一句话:Verse 是文本代码。接下来五节讲的每一件事,都是这一句话的推论。

二、文本解锁的四件事

「变成文本」听起来像个格式问题,其实是一次能力跃迁。它一次性解锁了四件在节点图世界里做不到、或者做起来极其别扭的事。

第一件:粘贴与提问。你可以把整个 .verse 文件粘进对话框,一个字符都不丢:类型标注在、specifier 在、缩进层级在、你写的注释也在。AI 看到的东西,和编译器看到的是同一份。而蓝图这边,你能给出的最高保真度就是一张截图加一段口述——信息在传递的第一步就已经缺斤少两了。

第二件:diff 与 code review。文本的改动能以「行」为单位呈现:红色删掉 3 行、绿色加上 5 行。评审的人只需要看这 8 行,不必重读整个文件;而且这 8 行本身也是文本,能贴进聊天、能被逐行评论、能被 AI 读。.uasset 是二进制资产,版本控制工具只能告诉你「这个文件变了」;变在哪,得用 Blueprint Diff 工具把两份资产并排打开,用眼睛比——比出来的结论留不下痕迹,也粘不进任何地方。

第三件:版本控制里的合并。两个人同时改一个 .verse 文件的不同函数,Git 能自动把两份改动合到一起;改到同一行才叫冲突,而冲突也是逐行摆在你面前的,你可以两边各留一半。两个人同时改一个 .uasset,团队里的标准做法是独占签出(签出即锁文件):谁先锁谁改,后面的人等着。真撞上了,基本只能二选一——有一个人的一整个下午会被丢掉。这一条是团队协作里最实的差别,和 AI 无关,但和你的项目寿命有关。

第四件:让 AI 批量改。「把这 12 个设备里所有的 Print 调用换成我们自己的日志函数」,在文本世界里是一次查找替换,或者一次「AI 交回 12 份改好的文件、你逐份 diff 验收」。在节点图世界里,这是打开 12 个资产、在每张图里找到 Print String 节点、手工换掉再把引脚重连一遍——没有工具能替你做,因为没有一份稳定的文本表示可供操作。

这四件事有一个共同的名字:可被机器处理。版本控制、自动化脚本、代码评审工具、AI 助手——所有能替你干活的东西,认的都是「行」。节点图没有行,所以它们全都帮不上忙。

三、UE6 编辑器里的 AI:已公布的部分

这一节的每一条都会带一个状态标签。AI 相关的消息更新得比引擎版本还快,分清「已发布」「已宣布」「尚未公布」比记住细节更重要。

已发布(标注为实验性)。Unreal Engine 5.8 随引擎提供了一个叫 Unreal MCP 的插件,官方文档在页首明确写着 Experimental:可以学着用,但拿它上线要谨慎。它做的事是在 Unreal Editor 进程里内嵌一个 MCP 服务器,让任何兼容 MCP 的 AI 客户端——官方文档点名了 Claude Code、Cursor、VS Code、Gemini 和 MCP Inspector——通过本机的 HTTP 连接来驱动编辑器,调用「生成 Actor、配置灯光、创建材质实例、检查 Slate 控件、跑自动化测试」这一类工具。官方同时把限制写得很直白:默认只监听回环地址且没有认证层,很多功能不完整,API 与数据格式随时可能变。

已宣布,形态尚未公布。Epic 在 State of Unreal 2026 上宣布 UE6 会把生成式 AI 助手做进编辑器,并强调接口是开放的:你可以接 Claude、接 Gemini,也可以接自己的模型。Epic 的公开表态是,AI 的定位是创造力与生产力的放大器,而不是替代品——它不会替代编辑器,也不会自己造出一整个游戏;要不要用、怎么接进自己的管线,决定权在开发者手里。至于 UE6 编辑器里这个助手最终长什么样、什么时候能用,尚未公布。

尚未公布。UEFN 是否会支持 Unreal MCP,Epic 尚未公布。Verse 的可视化脚本层(社区称之为 Visual Verse)的形态,同样尚未公布。所以今天在 UEFN 里和 AI 协作,主流方式仍然是最朴素的那一种:把 .verse 文件的内容粘进对话框,把 AI 给的代码粘回编辑器。

而这恰恰是本课的重点:这条路不需要等任何新功能,它今天就通。编辑器内建的助手会让它更顺手,但不会改变它的原理——原理就是第一节那句话,你的逻辑是文本。

四、怎么问才有用

同一个人、同一个模型,提问方式换一下,答案质量能差出一个数量级。下面三组对照,差别不在措辞礼貌不礼貌,而在你给没给出对方判断所需的信息。

把三组对照的共同点抽出来,就是五条:

• ▢ 贴真实代码与真实报错原文,不要转述、不要「大概是说找不到什么东西」。报错原文里的每个词都是线索。
• ▢ 说清运行环境:UEFN 还是 Unreal Editor、引擎版本、你 using 了哪些模块。同一段 Verse 在不同环境下能用的 API 并不一样。
• ▢ 说你要的行为,不是你要的写法。「玩家中途退出时分数不能丢」是行为,「用 weak_map 写」是写法——先说前者。
• ▢ 一次只问一件事。混着问,你会收到一份四不像的大杂烩,而且出错时没法定位是哪一段的锅。
• ▢ 要求它解释,不只是给代码。看不懂的代码你没法验收,也没法维护——那不是你的代码,只是暂时住在你项目里的代码。

五、必须由你把关:四步验收法

好消息讲完了,讲坏消息。AI 在 Verse 上翻的车,有三类特别典型,而且都不是「它偷懒」,是结构性的。

它会编出不存在的 API。原因不神秘:模型见过的 Python、C++、C# 代码以亿行计,见过的 Verse 代码少得多——Verse 从 2023 年才开始在 UEFN 生产环境跑,API 面比主流语言小得多,公开语料也薄得多。语料越薄,模型越容易「按别的语言的样子」补出一个听上去合情合理、但在 Verse 里根本不存在的函数名。它不是在骗你,它是在你没给足上下文时按概率填空。

它会给出过时写法。Verse 自 2023 年起一直在演进,模型的语料里混着各个时期的写法。一段两年前完全正确的代码,今天可能已经换了名字或换了签名。

它会忽略失败上下文与并发语义。这两样恰好是 Verse 最不像别的语言的地方,也正是模型最容易「按常识」抹平的地方:该包 if 的地方直接写、该标 <suspends> 的函数当成同步函数调、race 与 sync 的取消语义随手忽略。

看一个典型的翻车现场。你要的是「给玩家加分,分数按玩家分账」,AI 交回来这个:

using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }

var PlayerScores:weak_map(player, int) = map{}

score_device := class(creative_device):

    # 读和写都没过一道 Branch —— 编译不通过
    AddScore(Player:player, Delta:int):void =
        Old := PlayerScores[Player]
        set PlayerScores[Player] = Old + Delta
        Print("新分数:{Old + Delta}")

结构对、命名对、注释也像模像样,唯独两处抄了近路:从 weak_map 取值可能取不到、往 weak_map 写值也可能写不进,这两处都必须待在「允许走不通的地方」。这正是第 12 课失败上下文那一套——而它是模型最容易忽略的一套,因为别的语言里没有它。下面是修好的版本,点「运行下一步」,看那两道被 AI 省掉的 Branch 各自在做什么。

using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }

# 模块级 weak_map:一名玩家一格
var PlayerScores:weak_map(player, int) = map{}

score_device := class(creative_device):

    AddScore(Player:player, Delta:int):void =
        var NewScore:int = Delta
        if (Old := PlayerScores[Player]):
            set NewScore = Old + Delta
        if (set PlayerScores[Player] = NewScore):
            Print("新分数:{NewScore}")

所以,收到任何一段 AI 给的 Verse,固定走四步:

• ▢ ① 编译。先让编译器说话。它对「不存在的 API」这一类幻觉的命中率是 100%,零成本,先跑它。
• ▢ ② 逐行读懂。每一行你都要能说出它在干什么。读不懂的行,要么问到懂,要么删掉重写——不要留在项目里。
• ▢ ③ 检查失败上下文。凡是可能「走不通」的操作——查 map、取 option、用 [] 取下标、调 <decides> 函数——有没有老实待在 if 里?这是 AI 最爱抄近路的地方。
• ▢ ④ 跑一遍边界情况。空数组、玩家中途退出、同一帧连按两次、计时器没跑完就重复触发。AI 给的代码通常在「一切正常」那条路径上表现良好。

注意这四步里没有一步叫「相信它」,也没有一步叫「怀疑它」。你不是在检查对方诚不诚实,你是在检查它有没有理解你的项目——而它没有你的项目,它只有你给它的那几百行。信息是你给的,验收当然也得你来。

蓝图对照

同样四件事——求助、评审、合并、批量改——在两个世界里的做法完全不同。差异那一列是重点。

这张表里所有的差异只有一个根:节点图是画给人看的,文本是同时写给人和机器看的。蓝图当年选择「画」,换来的是零门槛的直观;Verse 选择「写」,换来的是整个软件工程工具链——版本控制、评审、自动化、AI——全部可用。两种取舍各有代价,只是今天能替你干活的那一类工具,恰好全都长在文本这一侧。

要补一句状态:Actor 与 Blueprint 在 UE6 Early Access(Epic 官方路线图目标为 2027 年底)及早期版本中完整支持,弃用要等 Scene Graph 足够成熟,时间未定;Epic 已承诺在弃用前提供转换工具,但尚未发布。所以这两个世界会长期并存。也正因为并存,「哪些逻辑值得优先搬进 Verse」有了一个很实际的判断标准:最需要被评审、被合并、被批量修改的那些。

六、毕业:你学的是语言

30 课到这里走完了。回头看一眼这条路:第一章问的是那个真正让你点进来的问题——你的蓝图技能会不会作废;第二章把蓝图的每一个名词翻译成了 Verse,把节点图翻译成了缩进块;第三到第六章,变量、流程、容器、函数与类型,一件件从面板搬进了代码;第七章讲时间与并发,那些在蓝图里要靠 Delay、Timeline 和一堆布尔标志拼出来的东西,在 Verse 里有了名字;第八章进了 Scene Graph 的新世界,Actor 变成 entity,继承树变成组件;第九章你把一整张蓝图完整翻译成了 Verse,然后是这一课——学会让 AI 一起干活。

引擎会换版本。框架会换名字:Actor 之后是 entity,蓝图之后有 Scene Graph,Scene Graph 之后还会有别的东西。今天最好的 AI,明年就是基线。这些都会变,而且变得比你换一次项目还快。

但你这 30 课学到的东西不在那个更新队列里。你学的是一门语言——类型是什么、作用域怎么划、失败为什么值得单独有一套上下文、并发的取消语义为什么必须显式、为什么组合优于继承。这些概念在 Verse 出现之前就存在于别的语言里,在下一个引擎、下一个框架里还会存在。它们不是 Epic 的发明,Epic 只是把它们摆进了游戏开发的正中央。

至于 AI:它会写得越来越快,也会越来越少犯低级错。但它永远不会替你决定这段代码该不该进你的项目、这个取舍值不值、这个 bug 是修一行还是重构一层。做这些判断需要读得懂代码——而这正是你刚刚花 30 课换来的能力。

框架会换,AI 会更强,读得懂代码的人始终是那个做决定的人。这就是这门课真正交到你手上的东西。

关卡挑战

最后三道关。答对拿星星 ★,答错可以一直重试,零惩罚。

拓展阅读