虚幻盒子 · UE Box
直接操作虚幻编辑器的开源 AI Agent
官网 · 下载 · 使用手册 · 更新日志 · English
功能
- 100+ 引擎工具：关卡、蓝图（含动画蓝图）、材质（含 Substrate）、C++、资产、数据表、UMG、Sequencer、几何体、地形、PCG
- 编译与运行验证：蓝图 / C++ 编译报错自动修；PIE 运行取日志和截图；试玩机器人自动按键测试（实验性）
- 改动可核对：工具调用全程可见；每轮列出新建 / 修改 / 删除；一键回引擎重读比对
- 目标模式
/goal：按需求清单逐条验收，未通过继续改 - 团队模式
/team：多个队员分工，每人可用不同模型 - 27 个内置技能 + 按工程积累的报错经验
- 80+ 模型服务商：Claude、GPT、DeepSeek、Ollama、LM Studio 等；支持 ChatGPT Plus / Kimi 会员登录
- 审批：风险操作需确认，可设「以后均允许」
- MCP / CLI：给 Codex、Claude Code、Cursor 和脚本用
- 素材管理：项目库、资产库、蓝图库、材质库、3D 查看器、知识库，不连引擎也能用
| | |
| -------------------------------------------------------------- | ---------------------------------------------------------------- |
| !工具调用
工具调用 | !本轮改动
本轮改动 |
| !审查
审查 | !项目库
项目库 |
快速开始
- 从 Releases 下载安装（Windows）
- 设置 → 模型 → 添加服务商，填 API 密钥；默认模型 → 对话 选它（模型需支持工具调用）
- 项目库 → 导入项目，选
.uproject，在弹出的询问里点 安装 UnrealAgentLink 插件，再点 打开项目 - 侧边栏 → AI 对话，输入「这个关卡里有多少个光源？」验证连接
接入外部 Agent
| 方式 | 用途 | 默认 | 文档 |
| ---- | ------------------------------------------ | ---- | ------------------------------------ |
| MCP | Codex / Claude Code / Cursor 调引擎工具 | 可写 | MCP |
| CLI | 脚本、CI：uebox tools call / uebox ask | 只读 | 命令行 |
仅本机可连，需令牌。
隐私
- 无账号，无官方服务器；密钥加密存本机，请求直连你配的服务商
- 默认只检查更新；未配置更新源的自行构建不发任何请求（updateFeed.ts）
- 用本机模型时 AI 请求不出本机
平台
| | 安装包 | 引擎发现 | 预编译插件 | | ------- | -------- | ------------------ | ---------- | | Windows | ✅ | ✅ | ✅ | | macOS | 源码构建 | ✅ 常见目录 + 手动 | 未完成验收 | | Linux | 源码构建 | 未适配 | — |
UE 5.0–5.8。Windows 为主力平台。插件源码：plugin/UnrealAgentLink（MIT）。
开发
pnpm install
pnpm dev
pnpm verify:changed # 提交前，只查改动（约 30 秒）
pnpm verify # push / PR 前，完整门禁- 用 AI 编码助手开发：先读 AGENTS.md，指南见 用 AI 加功能
- 贡献：CONTRIBUTING.zh-CN.md · 垂直切片 · 测试
- 打包与发版：packaging.zh-CN.md
- 其他文档：
docs/· UI 设计标准 · CHANGELOG · SECURITY · 第三方声明
许可
应用 Apache-2.0 · 插件 MIT
Unreal Engine 是 Epic Games, Inc. 的商标，本项目与 Epic Games 无隶属关系。