AI接入游戏引擎与建模工具的安全落地指南

一、先明确范围与风险

策划想快速验证玩法，美术要把模型导入引擎并设置碰撞体和材质，程序要搭建基础逻辑。这些工作分散在不同工具之间，重复且容易出错。Agent工作流可以代为执行其中重复的步骤。但Agent能写入工程文件，所以接入前要先写清楚它能做什么、不能做什么。

动手前，建议团队用一页纸回答三个问题：

1. 这次任务允许修改哪些目录和文件？
2. 出错后由谁检查，如何恢复？
3. 模型服务会接收哪些数据，是否符合项目的保密要求？

任何一个问题没有答案时，先不要接入。

二、适合与不适合的场景

适合的场景通常有三类：

• 玩法原型验证：在独立测试工程中组合已有规则，观察玩法是否有趣。
• 重复性资产处理：批量导出模型、统一导入参数、挂载碰撞体。
• 基础脚本编写：UI交互框架、数值表读取等输入和输出都清楚的代码。

以下情况不建议直接交给Agent操作，除非先满足对应条件：

• 大型存量工程：核心逻辑有自动化测试覆盖。没有测试时，至少要有一份可以逐项手工验证的清单。
• 有合规或保密要求的项目：已确认模型服务的数据保存期限、训练使用条款和数据存放地域。
• 没有版本控制的工程：工程已纳入Git或其他版本系统，并有可用的基线提交。
• 需要人工判断效果的环节：美术风格、手感和节奏。Agent可以生成候选结果，最终判断由人完成。

反面案例很常见。在没有版本控制的主工程里直接运行Agent，一次错误改动可能与同事的提交混在一起，回滚时只能手工逐个文件比对，耗时远超原本的手工操作。

三、把玩法构思改写成任务单

Agent只能按明确条件执行，无法判断体验好坏。因此，策划口中的“好玩”要先拆成可以检查的条件。

任务单建议包含以下字段：

任务名称：
目标：（一句话说明要验证或实现什么）
输入：（场景名、预制体名、数值表路径、模型文件路径）
输出：（新增或修改的文件列表、导出的模型格式）
验收标准：（可运行的检查项）
允许修改的目录：（例如 Assets/Prototype/）
禁止操作：（例如不修改 Assets/Core/，不删除文件，不提交到主分支）
失败处理：（失败后回到哪个提交，由谁复核）

以三消玩法为例。原始需求是“消除手感要好”，这无法验收。改写后可以是：“点击相邻两个方块后，若存在三个及以上同色连续方块，则消除并播放时长约0.3秒的消除动画；若不存在，则两个方块回弹到原位。”Agent可以据此实现，测试人员也能逐条验证。手感是否舒适仍由策划试玩判断，任务单只保证规则正确。

四、准备环境与版本

1. 模型与Agent平台

在平台申请API调用权限。密钥保存在环境变量或密钥管理服务中，不写入工程、脚本、配置文件或日志。例如在本地终端中设置：

export MODEL_API_KEY="<从密钥管理服务获取>"

提交代码前，检查 .gitignore，确认本地配置文件不会进入版本库。

2. 引擎与建模软件

确认版本号。Blender可在终端执行 blender --version 查看。Unity和Unreal的版本号在编辑器的关于页面中查看。插件要求的引擎版本以插件文档为准。版本不一致时，先升级或更换插件，不要强行运行。

3. 通信验证

插件启动后，在Agent平台发送一条只读请求，例如“列出当前场景中的对象名称”。同时满足两个条件，才算通信正常：返回了正确的对象列表，并且插件日志中出现连接成功的记录。若请求超时，先检查端口是否被占用，以及防火墙是否阻止了本地连接。

4. 版本基线

在工程根目录执行：

git status
git rev-parse --short HEAD
git switch -c ai-experiment/prototype-01

第一条命令确认没有未提交的改动。第二条记录基线提交号，回滚时需要它。第三条创建实验分支。

5. 测试工程

使用工程副本或实验分支，不直接改动主工程。

五、插件配置与权限收敛

Agent能做什么，取决于插件开放的接口。收敛权限的原则是：只开放本次任务需要的操作。

• 只允许读写白名单目录，例如 Assets/Prototype/。
• 默认禁止删除文件、修改项目设置和提交代码。删除与提交由人工执行。
• 禁止访问系统目录、用户主目录下的密钥文件，以及其他项目。
• 关闭自动执行外部命令的选项，或只允许白名单中的命令。
• 操作日志记录时间、操作类型、目标路径和结果。日志中不记录密钥，也不记录模型返回的敏感内容。

各工具的脚本入口不同。Unity使用Editor脚本接收指令，Unreal使用Python编辑器脚本，Blender使用其内置的Python接口。安装插件前，先阅读官方说明中的权限设置。

agent-">六、Agent修改脚本与导入资产

修改脚本

Agent每次只处理一个任务单。流程如下：读取任务单，列出计划修改的文件，修改代码，运行编译，再运行测试。编译或测试失败时，Agent应停止并输出错误信息，不应继续尝