uebox

虚幻盒子（UE Box）是一款开源桌面应用，定位为直接操作虚幻编辑器的 AI Agent。用户配置模型服务商后，它通过 UnrealAgentLink 插件连接正在运行的虚幻编辑器，借助一百多个引擎工具和 25 个内置技能执行任务：放置 Actor、修改蓝图、连接材质、编译 C++ 等。常规操作直接执行，风险操作会暂停等待用户确认；任务完成后 Agent 会用只读工具回引擎核实改动，并逐条回应查出的问题。 覆盖范围除关卡、蓝图、材质、资产、C++ 外，还包括动画重定向、UMG、Sequencer 镜头、PIE 运行验证、几何体编辑和工程体检。产品主体是 Agent，项目库、资产库、蓝图库与材质库、笔记与知识库各有独立界面，也可单独使用，但在产品结构中服务于 Agent：登记作用目标、提供素材、承接产出。 本仓库为社区核心版：不需要账号，不依赖官方服务器，可完全自行构建。 上手流程：从 GitHub Releases 或官网下载安装（Windows），在设置中添加模型服务商并填入自己的 API Key，将默认对话模型指向它；模型需支持工具调用。支持本机推理（Ollama、LM Studio、llama.cpp）和自建网关（LiteLLM、One API）。随后在项目库导入 .uproject，连接插件会自动安装到工程的 Plugins/UnrealAgentLink/ 目录，可关闭或移除。打开项目后插件自动连接，可在侧边栏 AI 会话中先用只读问题（如关卡光源数量）确认连接。 已使用 Codex、Claude Code 或 Cursor 的用户可打开 MCP 开关，把虚幻盒子作为工具服务接入，从而获得一百多个 UE 工具；MCP 仅本机可连，需要令牌，默认可写。 网络与数据方面：不使用账号，密钥加密存储在本机，请求直达用户配置的服务商，不经过项目方服务器。默认只检查更新、不下载；自行打包且未填更新源的构建不会发出网络请求。AI、联网检索、生图、网盘等功能按需连接，使用本机模型时 AI 数据不出机器。 平台支持：Windows 提供安装包，支持引擎发现和预编译 UnrealAgentLink 插件，是主力平台；macOS 需源码构建，可扫描常见共享安装目录中的引擎，也可手动添加引擎目录或编辑器 .app，并能检测运行中的 UE4/UE5 编辑器及其工程路径，预编译插件的构建与发布验收尚未完成；Linux 需源码构建，引擎发现尚未适配。 技术栈为 Electron + Vue 3 + TypeScript，支持 Unreal Engine 5.0 至 5.8。从源码运行使用 pnpm install 与 pnpm dev；提交前运行 pnpm verify，一条命令执行密钥扫描、lint、改动行 lint、类型检查与单元测试，且可在应用运行时执行。仓库提供面向 AI 编码助手的 AGENTS.md 规范与验收门禁，用户可用自然语言描述需求，让 AI 助手读架构、改代码、补测试并跑通验证。 许可：应用采用 Apache License 2.0，UnrealAgentLink 插件源码位于 plugin/UnrealAgentLink，采用独立的 MIT 许可证。Unreal Engine 是 Epic Games, Inc. 的商标，本项目与 Epic Games 无隶属关系。