作者:
Jiaqi,TRAE 技术文档工程师
Yangel,PICO Engine SDK 研发工程师
TRAE Editor for Unity 是一款专为 TRAE IDE 开发的,并内嵌于 Unity 编辑器的插件。它打通了 TRAE IDE 与 Unity 编辑器之间的协作链路,将 TRAE IDE 的基础功能、AI 辅助编码能力以及对 Unity 项目的深度理解融为一体,让你能够通过 Unity 编辑器直接唤起 TRAE IDE 编写代码,并便捷地回到 Unity 编辑器进行预览与调试。
核心优势
- 无缝继承 TRAE IDE 的核心能力
TRAE Editor for Unity 完整承载了 TRAE IDE 的全部功能,因此你所熟悉的代码高亮、智能提示和调试体验都得以完整保留。
- 支持解析从本地磁盘导入的外部包
在处理与 Unity 主工程分离的外部包时,TRAE Editor for Unity 会根据当前打开的脚本路径,将此包所在目录作为独立工作区加载。这确保了代码补全、定义跳转以及依赖项分析等功能均可在完整的项目上下文中正确运行。
- 内置项目级规则
TRAE Editor For Unity 插件内置了 一系列用于 Unity 项目开发的规则。当你通过该插件在 TRAE IDE 打开 Unity 项目时,这些规则文件会被自动添加到项目中并启用。
使用 TRAE Editor for Unity 插件
第一步:在 Unity 项目中安装 TRAE Editor for Unity 插件
-
在 Unity 编辑器中打开你的项目。
-
在上方菜单栏中,选择Windows >Package Manager 。
-
在 Package Manager 窗口左上角,点击 + > Add package from git URL 。
-
在 Git 地址输入框中,输入 https://github.com/Pico-Developer/TRAE-Editor-Unity.git ,然后点击右侧的 Add 按钮。
第二步:将 TRAE CN 设置为外部脚本编辑器
- 在 Unity 编辑器中,打开 Preference 窗口,路径如下:
▫ macOS:前往 Edit >Settings 。
▫ Windows:前往Edit >Preference 。 2. 在窗口的左侧导航栏中,选择 External Tools 。
-
在 External Tools 面板中,检查 External Script Editor 是否已被设置为 Trae CN 。
提示
一般情况下,若你已在本地安装 TRAE CN,则在项目中导入TRAE Editor for Unity 插件后,External Script Editor 会被自动设置为 Trae CN。
若自动设置未完成,你需要展开下拉菜单,点击 Browse ,然后根据你的操作系统选择本地已安装的 TRAE CN:
-
macOS:前往 “应用程序” 目录,选择 TRAE CN。
-
Windows:前往 Trae CN.exe 文件的安装目录,然后选择该文件。
导入 TRAE Editor for Unity 插件后,External Tools 面板会显示 TRAE 区域以及以下选项:
第三步:在 TRAE IDE 中安装所需扩展
为了让 TRAE IDE 能够编辑 Unity 工程中的文件,你需要前往 TRAE IDE 的扩展市场,然后安装以下两个扩展:
-
C# Dev Kit: C# Dev Kit 是一款基于 C# 扩展构建的增强工具,为 TRAE IDE 提供更完善的 C# 开发体验。它通过解决方案资源管理器和内置的单元测试,帮助开发者高效管理项目与验证代码,并借助一系列工具,提升代码编写、调试和维护的效率。
-
Unity: Unity 扩展为 C# 开发者在 TRAE IDE 中带来轻量、流畅的 Unity 开发体验。它基于 C# Dev Kit 和 C# 扩展提供的能力构建,提供面向 Unity 开发的一系列工具,涵盖调试、代码分析与重构、语法高亮以及智能代码补全等功能,从而提升开发效率与编码体验。
安装这两个扩展的步骤如下:
- 在浏览器中输入以下 URL,然后按下回车键。
C# Dev Kit:
https://marketplace.visualstudio.com/\_apis/public/gallery/publishers/ms-dotnettools/vsextensions/csdevkit/3.13.205/vspackage
Unity:
https://marketplace.visualstudio.com/\_apis/public/gallery/publishers/VisualStudioToolsForUnity/vsextensions/vstuc/1.2.1/vspackage
浏览器将自动下载扩展,等待下载完成。
- 返回 TRAE IDE 并打开扩展市场。
- 将下载的 .vsix 文件拖拽至 扩展 面板中。
TRAE IDE 会自动安装该扩展。安装完成后,该扩展会出现在 已安装 列表中。
第四步:使用 TRAE IDE 编写脚本
-
在 Unity 编辑器中,点击一个需要编辑的脚本。例如,下图中的 NewMonoBehaviourScript.cs。
Unity 编辑器会唤起 TRAE IDE,并在 TRAE IDE 中打开该脚本。
推荐在 TRAE IDE 中使用 SOLO 模式和 SOLO Agent 智能体来编写代码。
-
SOLO 模式以 AI 为主导,自动规划并执行从需求理解、代码生成、测试,到成果预览的全流程。详情参考《SOLO 模式概览 》。
-
SOLO Agent 是一个面向复杂项目开发的智能体。它能够助力你高效完成从需求迭代到架构重构的全流程开发工作。通过智能任务规划与精准执行机制,SOLO Agent 可在确认计划后自动推进开发进度。详情参考《SOLO Agent 》。
-
在对话输入框中,输入你的指令。例如,下图中的 “Please use code to generate a primitive Cube and set its position to the center (0, 0, 0). Make this Cube rotate continuously at a constant speed along its X and Y axes”。
接收到指令后,SOLO Agent 会根据你的指令开始编写代码。
-
检查 SOLO Agent 编写的代码,根据实际情况接受或拒绝变更,然后保存文件。
第五步:在 Unity 编辑器中预览效果
- 返回 Unity 编辑器。
- 点击顶部中央的播放按钮。
Hierarchy 窗口中会出现 SOLO Agent 根据你的指令构建的对象(本示例中为 Cube ),该对象同步显示在 Scene 和 Game 视图中。
- 在 Game 视图中预览效果。
SOLO Agent 遵循上述示例指令所构建产物的预览效果如下:
进阶配置:Unity MCP Server
若你使用的是 Unity 6.0 及以上版本,则可以使用 Unity AI 提供的 Unity MCP Server 来进一步辅助开发。
第一步:安装 Unity AI
-
在 Unity 编辑器顶部菜单的下方,点击 AI 。
-
在弹出的面板中,点击 Agree and install Unity AI 。
等待 Unity AI 安装完成。
第二步:完成 Untiy MCP Server 配置
-
前往 Edit >Project Settings >AI >Unity MCP Server 。
-
确保 Unity Bridge 处于 “Running” 状态。
-
在 Tools 区域,勾选你所需的工具。若想了解某个工具的详情,点击其右侧的 Show Details 。
-
在 Integrations 区域,复制 Example Configuration 处的 MCP Server 配置。
第三步:将 Unity MCP Server 添加至 TRAE IDE
- 打开 TRAE IDE。
- 前往 设置 >MCP 。
你将进入 MCP 管理面板。 3. 点击 添加 >手动添加 。
界面上会出现 手动配置 弹窗。
- 在弹窗中,粘贴先前复制的 Unity MCP Server 配置,然后点击 确认 按钮。
系统将验证你所添加的 Unity MCP Server 配置。验证通过后,已配置的 MCP Servers 列表中将出现 unityMCP,且默认处于启用状态。
此时,在 Unity 编辑器的 Project Settings >Unity MCP Server 面板中,Connected Clients 列表中会出现 “Trae Trae CN.exe”。
第四步:在 TRAE IDE 中调用 Unity MCP Server
添加并启用 Unity MCP Server 后,智能体在执行任务的过程中,若需要调用 Unity MCP Server 中的工具,会自动完成调用。
以上就是如何在 Unity 开发工作流中如何将 TRAE IDE 的 AI 能力丝滑融入的配置方式,相信可以帮助到你的日常开发中~
