Aura Autopilot最新版

Aura Autopilot 是一款持续学习的实时通用游戏测试系统。该系统能够自主学习游戏逻辑、探索关卡设计，并在多次运行中持续优化其测试策略与游戏玩法。目前，该系统已支持 Windows 和 macOS 平台下的 Unreal Engine 5、Unity 6 以及 Godot 4。

• 官网：https://www.tryaura.dev/autopilot
• GitHub：https://github.com/ramenvr/autopilot

以下为完整的安装、配置及使用说明。安装与卸载流程同样适用于通过 Claude Code 和 Codex 使用 Autopilot MCP 的场景。

核心安装指南

正确的环境配置是系统正常运行的前提。请根据你使用的游戏引擎，严格按以下步骤执行。

步骤 1：下载构建版本

访问 tryaura.dev/autopilot，根据你的游戏引擎和操作系统下载最新的 Autopilot 构建版本。

• 高级用户注意：对于 Windows 平台上的 Unreal Engine 高级用户，系统支持从源码安装 Autopilot，并针对自定义的 Unreal Engine 源码构建进行编译。若选择此方式，请在下载页面选择“Unreal 源码构建”选项，并直接跳转至“步骤 3：入门”。

步骤 2A：集成至 Unreal Engine 项目

适用对象：使用 Epic Games 启动器安装的官方 Unreal Engine 版本的用户。

Autopilot 提供针对 UE 5.4、5.5、5.6、5.7 和 5.8 的专属构建。

1. 解压下载的 Autopilot-Unreal5.x-Win64.zip（Windows）或挂载 Autopilot-Unreal5.x-Mac.dmg（macOS）。内部包含一个 Autopilot/ 文件夹。
2. 将该 Autopilot/ 文件夹移动至你项目的 Plugins/ 目录下。若项目中不存在该目录，请手动创建。
3. 路径校验：确保最终路径结构为 <YourProject>/Plugins/Autopilot/Autopilot.uplugin。
4. 校验无误后，可安全删除下载的压缩包或弹出磁盘映像并删除 dmg 文件。

步骤 2B：集成至 Unity 项目

适用对象：使用 Unity 6 (v6000.0 或更新版本) 的用户。

1. 解压下载的 Autopilot-Unity.zip，提取出 com.ramenvr.autopilot-<version>.tgz 文件。
2. 在 Unity 编辑器中打开目标项目。
3. 导航至 Window > Package Management > Package Manager。
4. 点击窗口左上角的 + 图标。
5. 选择 Install package from tarball...，并定位选择上一步提取的 .tgz 文件进行安装。

步骤 2C：集成至 Godot 项目

适用对象：使用 Godot 4 (v4.7 或更新版本) 的用户。

1. 解压下载的 Autopilot-Godot.zip，提取出 addons/autopilot/ 文件夹。
2. 将该 autopilot/ 文件夹移动至你项目的 addons/ 目录下。若不存在该目录，请手动创建，或直接将 addons/autopilot/ 放置于项目根目录。
3. 路径校验：确保最终路径结构为 <YourProject>/addons/autopilot/...。
4. 校验无误后，可安全删除下载的压缩包。
5. 在 Godot 编辑器中打开项目，导航至 Project > Project Settings > Plugins，找到 Autopilot 并将其状态切换为启用 (Enable)。

步骤 3：系统初始化与入门

完成插件集成后，需配置代理服务与模型环境。

1. 打开面板：Unreal 和 Godot 用户点击编辑器中的 Autopilot 图标（橙色控制器）；Unity 用户点击 Window > Autopilot。
2. 账户认证：建议使用 Aura 账户登录，以便在集中平台追踪使用情况。若无账户，点击 Create Account；已有账户则点击 Sign in。系统也支持 BYOK（自带密钥）模式。
3. 服务启动：等待 Autopilot 完成设置并启动代理服务。完成后，界面将自动重定向至注册/登录页面。
4. 完成验证：新用户需确认电子邮件后返回面板登录。成功认证后，面板将显示“Signed in as ”，点击 Continue。
5. 状态确认：当面板显示“Agent service ready”时，表示代理服务已就绪，点击 Continue。
6. 数据共享选项：系统会询问是否允许分享运行数据以改进 Autopilot 模型，请根据个人意愿选择后点击 Finish。
7. 记忆填充（可选）：若为项目首次使用或已清空项目记忆，系统会提示是否运行一次 10 分钟的探索任务来填充 Autopilot 项目记忆。跳过此步骤直接输入自定义提示词也是完全安全的。

工作流机制与提示词指南

Autopilot 的核心运作机制是：接收提示词后，自动启动 PIE (Play In Editor) 窗口，读取项目源代码并探测 PIE 环境，随后根据提示词开始执行游戏测试。系统通过 LLM 编码智能体，基于对游戏的理解构建测试装置 (Test Harness)，并在运行过程中向决策模型请求具体的动作选择。任务完成后，PIE 窗口自动关闭，系统生成结构化测试报告。

支持的 4 种提示词类型：

1. 探索 (Explore)：例如，“Explore the crafting system in Lvl_Main.”（探索主关卡中的制作系统。）
2. 测试 (Test)：例如，“Go through the currently open level and tell me everything that looks wrong.”（遍历当前打开的关卡，并指出所有异常之处。）
3. 验证 (Verify)：例如，“Verify that the tree shakes when you hit it with an axe.”（验证用斧头砍树时树木是否会产生摇晃动画。）
4. 目标 (Objective)：例如，“Kill the boss while keeping your health above 20% of its maximum value.”（在保持生命值高于最大值 20% 的前提下击败 Boss。）

持续学习特性说明：

在最初的几次运行中，Autopilot 处于构建项目记忆的阶段，测试装置的尝试可能会出现次优行为。随着运行次数的增加，系统对项目记忆的不断填充，其决策模型的执行效率与行为逻辑将呈现显著优化。后续测试将表现出更智能的行为特征，例如更精准的闪避时机、更合理的装备选择、更优化的战术策略以及更准确的瞄准。

高级集成：使用编码智能体 (MCP)

开发者可以通过 MCP 服务器，将 Autopilot 直接接入 Claude Code 或 Codex 环境中。

1. 前提条件：完成上述所有安装步骤。使用 Aura 账户登录可使此功能开箱即用。
   • 计费逻辑说明：Aura 仅计算决策模型的使用量。你的 LLM 使用量将计入你自身的 Claude 和/或 ChatGPT 订阅额度中，不会消耗 Aura 额度。若选择 BYOK 模式，则需提供 TypeSafe API 密钥。
2. 一次性连接设置：
   • 针对 Claude Code，在终端运行：autopilot connect claude
   • 针对 Codex，在终端运行：autopilot connect codex
3. 执行任务：打开 Claude Code 或 Codex 界面，直接输入提示词，例如：“Use Autopilot to verify the collision box of the player character.”（使用 Autopilot 验证玩家角色的碰撞箱。）

卸载与清理流程

若需从项目中彻底移除 Autopilot，请执行以下标准化卸载步骤，以避免残留文件影响项目编译。

1. 系统级卸载：在 Autopilot 面板中，导航至 Settings 并点击 Uninstall。
   • 注意：默认情况下，Autopilot 会保留你项目的记忆数据。若需彻底清除，可在此步骤选择删除记忆（此为破坏性操作，不可逆）。
2. 引擎级插件移除：
   • Unreal Engine：关闭编辑器，直接在文件管理器中删除 <YourProject>/Plugins/Autopilot/ 文件夹。
   • Unity：打开 Package Manager，找到 Autopilot 包并点击 Remove。
   • Godot：导航至 Project > Project Settings > Plugins，禁用 Autopilot，随后在文件管理器中删除 <YourProject>/addons/autopilot/ 文件夹。

完成上述步骤后，重启对应的游戏引擎，Autopilot 即被完全移除。