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 项目时，这些规则文件会被自动添加到项目中并启用。

通用使用流程

第一步：在 Unity 项目中安装 TRAE Editor for Unity

1. 在 Unity 编辑器中打开你的项目。
2. 在上方菜单栏中，选择 Windows > Package Manager。
3. 在 Package Manager 窗口左上角，点击 + > Add package from git URL。
4. 在 Git 地址输入框中，输入 https://github.com/Pico-Developer/TRAE-Editor-Unity.git，然后点击右侧的 Add 按钮。
   

第二步：将 TRAE CN 设置为外部脚本编辑器

1. 在 Unity 编辑器中，打开 Preference 窗口，路径如下：

   • macOS：前往 Edit > Settings。
   • Windows：前往 Edit > Preference。

2. 在窗口的左侧导航栏中，选择 External Tools。

3. 在 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 区域会显示以下选项：

选项	描述
Auto copy project rules	勾选该选项后，在 TRAE IDE 中打开 Unity 工程时，会自动在 .trae/rules/ 目录中添加以下规则文件：  · CodeStyleGuide.md：基于 C# Code Style Guide (Unity 6 edition)  的规则。  · UnityCodeStyleInstructions.md：针对 Unity C# 开发的代码风格与命名规范指南，涵盖代码格式化、生命周期方法的使用要求以及通用编程最佳实践。  · UnityDebuggingInstructions.md：提供系统性的 Unity 项目调试指南，包含从控制台报错分析到内存、物理、动画及 UI 等各子系统问题的具体排查方法。  · UnityDesignPatternsInstructions.md：详细说明 SOLID 面向对象原则以及观察者、状态、对象池等经典设计模式在 Unity 工程中的具体应用方式与代码示例。  · UnityPerformanceOptimizationInstructions.md：全面的 Unity 性能优化手册，重点指导如何通过优化 Update 循环、内存分配、物理查询和渲染系统来消除常见的性能瓶颈。  · UnityProjectConfigurationInstructions.md：总结了一系列 Unity 编辑器和项目工程的配置最佳实践（如播放模式选项、资产导入预设和 Burst 编译器设置），旨在提升开发迭代速度。  · UnityUIToolkitInstructions.md：针对 Unity 6 编写的 UI Toolkit 综合开发手册，深入讲解 Flexbox 布局、USS 样式、UXML 元素构建、运行时数据绑定以及 MVP 架构的实现细节。
Include external packages	在 Unity 编辑器的 Package Manager 窗口中，若你先前通过 “Add package from disk” 的方式将外部包添加至当前 Unity 项目，则勾选该选项后，这些包会被自动添加至 TRAE IDE 当前工作区的根目录，从而确保这些包可被 TRAE IDE 索引和导航。
Show Library folder	勾选该选项后，当前 Unity 项目目录下的 /library 文件夹将被加入到 TRAE IDE 当前的工作区中。

第三步：在 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 开发的一系列工具，涵盖调试、代码分析与重构、语法高亮以及智能代码补全等功能，从而提升开发效率与编码体验。

安装这两个扩展的步骤如下：

1. 在浏览器中输入以下 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

   浏览器将自动下载扩展，等待下载完成。

2. 返回 TRAE IDE 并打开扩展市场。
3. 将下载的 .vsix 文件拖拽至 扩展 面板中。

TRAE IDE 会自动安装该扩展。安装完成后，该扩展会出现在 已安装 列表中。

第四步：使用 TRAE IDE 编写脚本

1. 在 Unity 编辑器中，点击一个需要编辑的脚本。例如，下图中的 NewMonoBehaviourScript.cs。

   Unity 编辑器会唤起 TRAE IDE，并在 TRAE IDE 中打开该脚本。

   

   💡提示
   
   推荐在 TRAE IDE 中使用 SOLO 模式和 SOLO Agent 智能体来编写代码。
   
   - SOLO 模式以 AI 为主导，自动规划并执行从需求理解、代码生成、测试，到成果预览的全流程。详情参考 SOLO 模式概览。
   
   - SOLO Agent 是一个面向复杂项目开发的智能体。它能够助力你高效完成从需求迭代到架构重构的全流程开发工作。通过智能任务规划与精准执行机制，SOLO Agent 可在确认计划后自动推进开发进度。详情参考 SOLO Agent。

2. 在对话输入框中，输入你的指令。例如，下图中的 “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 会根据你的指令开始编写代码。

   

3. 检查 SOLO Agent 编写的代码，根据实际情况接受或拒绝变更，然后保存文件。

第五步：在 Unity 编辑器中预览效果

1. 返回 Unity 编辑器。

2. 点击顶部的播放按钮。

   Hierarchy 窗口中会出现 SOLO Agent 根据你的指令构建的对象（本示例中为 Cube），该对象同步显示在 Scene 和 Game 视图中。

   

3. 在 Game 视图中预览效果。
   SOLO Agent 遵循上述示例指令所构建产物的预览效果如下：

   

进阶配置：Unity MCP Server

若你使用的是 Unity 6.0 及以上版本，则可以使用 Unity AI 提供的 Unity MCP Server 来进一步辅助开发。

第一步：安装 Unity AI

1. 在 Unity 编辑器顶部菜单的下方，点击 AI。
2. 在弹出的面板中，点击 Agree and install Unity AI。 等待 Unity AI 安装完成。

第二步： 完成 Untiy MCP Server 配置

1. 前往 Edit > Project Settings > AI > Unity MCP Server。
2. 确保 Unity Bridge 处于 “Running” 状态。
3. 在 Tools 区域，勾选你所需的工具。若想了解某个工具的详情，点击其右侧的 Show Details。
4. 在 Integrations 区域，复制 Example Configuration 处的 MCP Server 配置。

第三步：将 Unity MCP Server 添加至 TRAE IDE

1. 打开 TRAE IDE。
2. 前往 设置 > MCP。 你将进入 MCP 管理面板。
3. 点击 添加 > 手动添加。 界面上会出现 手动配置 弹窗。
4. 在弹窗中，粘贴先前复制的 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 中的工具，会自动完成调用。