借助 AI 修改游戏时,改动应当便于检查、应用和回滚。“只发送有变更的文件”可以作为交接规则,但仍需保留完整项目。源代码通常依赖场景、素材、设置和引擎生成的数据,这些内容必须与项目基线保持一致。

本文以一款虚构的酒店经营游戏为例,其中的延迟退房规则需要做一点调整。这是一个假设场景,未对任何项目应用补丁,也未进行导出或测试。下面的流程可以帮助你提出范围明确的修改请求,并准备其他开发者可以审查的交接材料。
明确项目基线和修改要求
动手前,确认准确的项目版本、引擎版本、工作分支或副本,以及负责相关行为的文件。写清楚哪些行为需要调整,哪些需要保留。以酒店游戏为例,延迟退房可以影响客房清洁人员的可用时段,同时保持房价、客人抵达规则和每日工资发放安排不变。
先给 AI 助手提供完成任务所需的最少上下文,包括相关脚本、调用代码、数据结构和项目约定。如果助手需要更多文件来理解依赖,就把相关文件提供给它,避免让它猜测。先让助手给出修改方案,再要求它提供补丁,列出所有新增、修改或删除的文件,以及涉及的场景、素材、设置或迁移依赖。
在本地保留干净的基线。版本控制可以提供稳定的对照基准,一次性实验也可以使用独立副本。避免把补丁和无关编辑混在一起。起点越干净,越容易看清助手具体改了什么。
审查文件列表和实际差异
先用版本控制工具查看变更范围,再逐行检查改动。Git 文档介绍了 name-only 和 name-status 等可用于列出变更路径的 diff 视图。这些视图可以回答“改了哪些文件”,但无法判断补丁是否正确、能否编译,或改动是否仅限于预期行为。
对照修改要求检查每个有变更的文件。确认逻辑改动是否集中在目标范围内,并留意新增依赖、代码删除、默认值变更,以及对共享系统的修改。仔细阅读新增文件,审查标准应与修改过的文件一致。检查场景是否引用了已重命名的脚本、数据字段是否需要默认值,以及排程调整是否会影响存档或其他系统。
请助手简要说明每个文件的修改原因。如果某个源文件有配套的生成文件或引擎导入产物,确认项目是否会重新生成它。即使变更列表很短,也要仔细检查是否存在大范围重写。仅修改一个管理器,就可能改变整个游戏的行为。
区分源代码交接和游戏导出
源代码补丁是一组需要应用到匹配项目中的变更。它可能包含一个脚本和一个数据文件,却不包含场景、精灵图、配置或引擎元数据。把补丁应用到指定的完整项目,再按该项目的常规流程使用编辑器、导入资源、构建和导出。仅包含部分源代码的文件夹未必能独立运行。
有些引擎支持专门的补丁包。Godot 稳定版的命令行文档介绍了用于导出变更文件的 export-patch 选项,以及 patches 选项。文档还说明,导出命令依赖已配置的导出预设,并且需要考虑相应的基础导出。这是 Godot 特有的打包功能。仅包含变更源文件的 ZIP 压缩包不一定与之等效,同一机制也未必适用于 Unity 或其他引擎。

如果交付物是供他人审查的补丁,请附上变更文件、易读的差异、依赖说明、项目和引擎版本,以及具体的应用步骤。如果交付物是面向某个平台的构建包或引擎补丁,请通过引擎支持的导出流程生成,并测试实际交付的产物。交接时明确说明提供的是哪一种。
让 AI 提供其他开发者能看懂的补丁
可以这样限定修改范围。只调整延迟退房的排程规则,保留客房分配、定价、客人抵达规则和工资发放安排,不修改无关场景。列出修改和新增的文件,说明所需依赖,并附上回滚步骤。请助手基于明确指定的基线提供 unified diff(统一差异),或提供一个仅包含变更文件的目录。
把补丁复制到正在使用的项目之前,先仔细审查。确认文件路径相对于项目根目录、文件名正确、没有包含密钥等敏感信息或本地缓存文件,并且新增代码遵循项目约定。如果补丁包含用于整文件替换的版本,就把它与基线逐一比对,以免丢失无关内容。
应用补丁后,用版本控制工具查看工作区状态。如果助手说只改了两个文件,而 diff 显示有十个文件发生变更,先停下来查清原因。引擎导入资源时可能会更新生成文件。将这些变更与预期的源代码改动区分开,并遵循项目现有的仓库管理规则。
应用补丁、构建并验证游戏行为
先把补丁应用到项目副本或干净的分支,再用项目所需的引擎版本打开完整项目。解决导入和构建错误后,再检查所要求的行为。在酒店游戏示例中,验证延迟退房日期、客房可用情况、客人抵达情况和客房清洁排班,同时确认无关的价格和工资发放安排保持不变。
记录修改前后的情况,包括项目版本、变更文件、操作步骤、预期结果和实际结果。测试正常流程和边界情况。如果改动涉及持久化数据,还要测试保存和重新加载。最后再测试回滚。如果产物是可下载的构建包,就在目标平台上测试该构建包,不能只看编辑器预览。

有针对性地回滚补丁
应用任何改动前,先保留一个干净的检查点。如果补丁有问题,只还原它改动过的文件,或撤销单独提交的补丁。Git 的 restore 命令可以还原指定路径,但也会丢弃该路径在当前工作树中的改动,操作前要先确认其中是否有无关工作。
回滚也需要验证。重新打开项目,确认原有行为已经恢复,并检查未提交的改动是否仍然保留。如果助手生成的补丁和其他本地改动混在一起,避免使用影响范围过大的重置或清理命令。
常见问题
可以只把有变更的游戏源文件发给 AI 助手吗?
可以,前提是同时提供相关的上下文代码、项目约定和约束。在本地保留完整项目基线,要求助手提供 diff,并检查交接材料是否列出了变更文件所需的依赖。在交接说明中写清楚文件路径和版本信息。
只包含变更文件的包能构成完整的游戏构建包吗?
不能。源文件可能依赖包里没有包含的场景、素材、设置、生成文件或引擎导入数据。将补丁应用到匹配的完整项目,再按项目的常规流程构建或导出。审查者需要知道应使用哪一个完整项目基线。
怎样用 Git 只列出有改动的文件?
针对指定基线使用 name-only 或 name-status 等 Git diff 视图,然后再查看实际差异。文件列表只能显示变更范围,无法判断代码是否正确或安全。确认工作树足够干净,以便准确解读 diff。
Godot 能只导出有变更的文件吗?
Godot 稳定版的命令行教程介绍了用于导出变更文件的 export-patch 选项,也说明了如何使用补丁列表。该功能依赖导出预设和兼容的基础导出,生成的补丁不能等同于普通的源代码文件夹 ZIP 压缩包,也不是独立的构建包。请遵循该引擎版本文档中对导出预设和基础导出的要求。
如何回滚 AI 生成的游戏代码补丁?
应用改动前,保留项目基线或干净的版本控制检查点。只还原已经审查过的文件,或撤销补丁,然后重新构建并确认原有行为。存在未提交的工作时,避免使用影响范围过大的清理命令。确认还原后的项目可以构建,并且原有行为已经恢复。
写清楚交接内容
以完整项目为准。交付范围小、便于审查的补丁,注明依赖和基线,然后按项目的常规流程构建和测试。这样,其他开发者就能拿到需要的变更文件,也清楚这些文件本身并不是一个成品游戏。
如果你有另一个适合在浏览器里试玩的原型点子,可以试试 SEELE AI Game Maker。这是单独制作原型的方式,不提供为现有项目打代码补丁或导出项目的功能。


