AgentCraft
AgentCraft
个人开发展示 · 非经营性
面向 Unreal Engine 编辑器的 AI 智能体系统
以自然语言意图驱动——智能体自主规划、从 300+ 原生工具中择取、 于运行中的编辑器会话内以事务方式执行，并自资产注册表读回结果完成对账。
了解系统架构 ↓
AgentCraft 是一款纯 Slate 架构的 UE5 编辑器插件，将 Claude Code、Gemini CLI、
DeepSeek、通义千问、GLM 等大语言模型智能体接入 Unreal Engine 工作流，
经由统一的 kaiwu_* 原生工具集完成材质、蓝图、光照等创作任务。
工具调用不止于返回状态——每次写入均包裹于事务，落地后自资产注册表读回组件、参数与路径，与预期逐项对账，以可验证的证据取代状态声明。
统一底座驱动多个创作域——材质、光照、蓝图可在单一意图内协同执行，消除彼此割裂的工具孤岛。
数据驱动的配方装配确保确定性复现，支持规模化产出、迭代与版本化管理。
DeepSeek、通义千问（DashScope）、GLM（BigModel）与 Claude、OpenRouter 并列为一等接入，无需额外网络代理。
支持以自有 API Key 直连，或经 agentcraft-mcp 驱动 CLI 订阅；不转售、不代理、凭据不经手。
零 UMG / CEF 依赖，可在任意 UE5 构建环境下运行；UE 5.7 为基线，5.8 兼容。
名称取自《天工开物》——成书于十七世纪的造物典籍，寓意将系统化的造物精神经由人工智能引入 Unreal Engine。
自然语言意图 → 智能体规划 → 事务执行 → 写入 · 读回 · 对账；由统一底座驱动，跨创作域保持一致。
ICraftAgentProvider 将 UI 与工具层同底层 AI 传输解耦：Stdio 家族（Claude Code / Gemini CLI / Codex）与 HTTP 家族（DeepSeek / 通义千问 / GLM / OpenRouter）遵循同一异步契约。
模型将自然语言意图转译为对结构化 kaiwu_* 工具的调用；面板按创作域组织并收窄可用工具集，使模型聚焦于当前领域。
每次写入均包裹于事务，在运行中的编辑器会话内落地——区别于离线批处理。
执行后自资产注册表读回真实结果（组件 / 参数 / 路径）并与预期对账，而非仅依赖状态返回。
对外提供 MCP 服务（端口 9316）暴露工具注册表，可接入 MCP Inspector、Claude Desktop、VS Code 等客户端；与 Epic 官方 5.8 内置 MCP 互补，在对账、跨域与配方复现上具备更高一致性。
分域范围明确界定——面板按创作域组织，清晰区分已验证域与预览域。v1 完整支持以下三域：
配方化材质图装配、Material Instance、贴图指派、PBR 参数调校，以及外部材质库的扫描与预览。
基于预设脚手架的蓝图生成、图节点编辑与连线、组件与变量管理、自动编译与读回验证。
三点棚布光、灯光摆放与参数调校、视口取景。
各已支持域均由自动化测试套件把关，发布前连续通过五轮完整回归。
统一底座设计为向更多创作域延伸——相关工具链已具备调用能力，但尚未通过 v1 质量门，故标记为预览 / 规划中：
此处呈现发展方向，不代表当前出货范围。
代表性示例随插件零外部依赖附带；具体内容正在甄选整理，确定后于此公布。
示例内容确定后于此展示。
示例内容确定后于此展示。
示例内容确定后于此展示。
示例覆盖各 v1 支持域，随插件零外部依赖附带；成品渲染图与演示短片将随创作域成熟陆续补充。
agentcraft-mcp。本项目为持续迭代中的个人开发实践，记录系统化造物的过程。