一个 UE 编辑器插件，提供一对生命周期命令 /FreeUltraCodeBluePrintMode.BlueprintMode.Start 与 /FreeUltraCodeBluePrintMode.BlueprintMode.End，把"自然语言生成/编辑蓝图"框成一个显式模式。设计参考 Ludus AI 的自然语言蓝图编辑，落地通道为插件内直接调用 UE C++ API（UEdGraph / UK2Node_* / FBlueprintEditorUtils），并在本地无法完成时通过 MCP 桥接自动补全。
- 模式生命周期：
start进入蓝图编排模式，其后所有自然语言被解释为蓝图意图；end收尾提交或丢弃。 - 上下文分级加载：Overview / Header / Balanced / Full / Properties 五级，控制 token 与成本（对齐 Ludus 分层）。默认
balanced。 - AI 创建蓝图：目标蓝图不存在时，默认弹确认让用户选择是否创建（
--create-if-missing Ask）；也可--create自动创建或Never报错。 - 实时编排：通过结构化操作计划（
FFreeUltraCodeBluePrintModeOp）spawn 节点、连线、设属性，用户实时看到逻辑生长。 - checkpoint 回滚：
start建事务，end --discard回滚，每个操作可 Ctrl+Z 撤销。 - 校验：
end --verify --compile触发编译与静态校验，失败则留在模式内继续修。 - MCP 自动补全：本地 API 覆盖不到的执行性动作（放置 actor、改工程设置等）转发给 MCP server。
- 插件自检：模块启动时自动检测是否已启用、是否有新版本，发现更新弹通知附下载入口，全程非阻塞。
FreeUltraCodeBluePrintMode.BlueprintMode.Start [--target <名字>] [--context overview|header|balanced|full|properties]
[--agent lite|full] [--dry-run]
[--create] [--create-parent <类>] [--create-path <路径>]
[--create-if-missing Ask|Always|Never]
FreeUltraCodeBluePrintMode.BlueprintMode.End [--commit | --discard] [--verify] [--compile]
FreeUltraCodeBluePrintMode.BlueprintMode.Capabilities
--target：点名目标蓝图，缺省取当前聚焦的蓝图编辑器。--context：上下文加载等级，控制成本/深度主旋钮。--dry-run：只产计划与预览，不落盘。--create*：蓝图不存在时的创建策略。Capabilities：输出当前 UE 版本、模块、插件与 API 探测后的能力 JSON。
FreeUltraCodeBluePrintMode.uplugin 插件描述
Source/FreeUltraCodeBluePrintMode/
FreeUltraCodeBluePrintMode.Build.cs 模块依赖
Public/Private/
FreeUltraCodeBluePrintModeModule.* 模块入口，注册 start/end 控制台命令
FreeUltraCodeBluePrintModeTypes.h 枚举与结构（上下文等级、操作原语、参数）
FreeUltraCodeBluePrintModeCapabilityRegistry.* 运行时能力探测与自动启用策略
FreeUltraCodeBluePrintModeSubsystem.* 核心编排：生命周期、targeting、创建、回滚
FreeUltraCodeBluePrintModeContextLoader.* 按等级提取蓝图上下文为 JSON
FreeUltraCodeBluePrintModeOpExecutor.* 操作计划 -> UE 图表 API
FreeUltraCodeBluePrintModeMcpBridge.* MCP 桥接，本地无法完成时远程补全
FreeUltraCodeBluePrintModePluginUpdateChecker.* 安装/版本自检与更新通知
仓库地址：https://github.com/wellingfeng/ue-blueprint-mode
- 在 UE 项目里打开
项目设置 → 插件 → FreeUltraCode 蓝图模式。 - 保持
GitHub 仓库为https://github.com/wellingfeng/ue-blueprint-mode.git。 - 点击
一键安装（从 GitHub 下载）。 - 安装完成后重启编辑器，在
编辑 → 插件中启用 FreeUltraCode BluePrint Mode。
自动安装会把插件下载到当前 UE 工程的 Plugins/FreeUltraCodeBluePrintMode。如果 GitHub 下载失败，会尝试使用设置页里的本地源目录作为兜底。
- 下载或 clone 本仓库。
- 把仓库目录放到工程的
Plugins/FreeUltraCodeBluePrintMode下（或引擎Engine/Plugins/Marketplace/）。 - 重新生成工程文件并编译。
- 在
编辑 → 插件中启用 FreeUltraCode BluePrint Mode，重启编辑器。 - 启动后插件会自动自检安装状态与版本。
idle ──start──▶ Active ──end --commit──▶ Verifying ──ok──▶ idle
│ └─fail─▶ Active(继续修)
└──end --discard──▶ 回滚 ──▶ idle
当前采用“能力探测 + 可选后端”策略，不只按 UE 大版本硬判断。每项能力会返回：
supported：当前 UE 版本、模块、插件和关键类/API 是否存在。implemented：当前插件是否已有可执行实现。enabled：是否可直接向 UI/模型暴露并执行，通常等于supported && implemented。reason：ok/partial_k2_call_function/engine_too_old/plugin_missing/api_missing/not_implemented。backend：editor_plugin/optional_editor_plugin/unavailable。
能力矩阵：
| 能力 | 当前策略 |
|---|---|
Blueprint.BasicGraph |
已实现并自动启用：节点创建、连线、设 pin 默认值、变量、删除、断线 |
Blueprint.KeySpawn |
部分实现并自动启用：当前以 K2Node_CallFunction:Class.Function 为骨架 |
Blueprint.AutoLayout |
已实现并自动启用：按连接深度做基础列布局 |
Blueprint.NodeDiscovery |
探测 K2 action API，当前未实现完整 palette/action key 发现 |
Blueprint.Dispatcher |
探测 API，当前未实现执行器 |
Blueprint.Timeline |
探测 API，当前未实现执行器 |
UMG.WidgetTree |
作为可选编辑器后端探测，不作为核心自动启用 |
AnimGraph.Edit |
作为可选编辑器后端探测，不作为核心自动启用 |
StateTree.Edit |
UE5+ 且 StateTree 插件/API 存在时标记 supported，当前仍需可选后端 |
Niagara.StackEdit |
Niagara 插件/API 存在时标记 supported，当前仍需可选后端 |
这意味着低版本 UE 会返回 engine_too_old 或 api_missing，高版本如果插件/API 存在会返回 supported=true；但只有 enabled=true 的能力会被当作当前可直接执行，避免把尚未实现的深编辑误暴露给模型。
- 所有图操作在 game thread 执行；MCP/HTTP 回调通过
AsyncTask(GameThread)切回主线程。 FFreeUltraCodeBluePrintModeOpExecutor::DoSpawnNode当前以UK2Node_CallFunction为骨架示例，完整实现需按NodeType前缀分派到各UK2Node_*子类。FFreeUltraCodeBluePrintModeCapabilityRegistry不直接包含 UMG / AnimGraph / StateTree / Niagara 的编辑器头文件，避免低版本或未启用插件时编译失败。- MCP endpoint 默认
https://mcp.ludusengine.com/mcp，可在EditorPerProjectUserSettings的[FreeUltraCodeBluePrintMode.BlueprintMode] McpEndpoint覆盖；旧的[BlueprintMode]仍兼容读取。