虚幻盒子 UE Box

---

功能

• 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 查看器、知识库，不连引擎也能用

完整能力与限制：能力与边界

工具调用	本轮改动
审查	项目库

快速开始

1. 从 Releases 下载安装（Windows）
2. 设置 → 模型 → 添加服务商，填 API 密钥；默认模型 → 对话 选它（模型需支持工具调用）
3. 项目库 → 导入项目，选 .uproject，在弹出的询问里点 安装 UnrealAgentLink 插件，再点 打开项目
4. 侧边栏 → 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 无隶属关系。