MCPBlueprint 使用文档

MCPBlueprint 通过 MCP 向 AI 客户端提供蓝图发现、图表编辑、成员、组件、资产生命周期、编译反馈和图表截图能力。当前编辑器会话中真实可用的工具名和参数始终以 tools/list 返回结果为准。

• Unreal Engine 5.2+ Editor，支持 Windows、macOS 和 Linux。
• 支持本机 HTTP 服务的 MCP 客户端。
• 插件包必须与 Unreal Engine 的小版本完全一致。

每个引擎只安装一次 MCPBlueprint：

<UE_5.x>/Engine/Plugins/Marketplace/MCPBlueprint/

MCPBlueprint 是跟随引擎安装的可选编辑器工具。.uplugin 使用 Installed=true 和 EnabledByDefault=true。不要把它重复复制进每个项目，也不要向用户项目的 .uproject 添加 MCPBlueprint。替换引擎中的插件包后，应重启对应版本的编辑器。

MCPBlueprint 会自动启用，并在编辑器启动时自动启动本机 MCP 服务。用户不需要在每个项目中手动启用插件，也不需要向项目 .uproject 添加插件声明。

让你使用的 AI 客户端按照自身的 MCP 配置流程接入 MCPBlueprint，并把插件工具栏显示的端点交给它即可。默认端点为 http://127.0.0.1:8766/mcp；配置端口被占用时，MCPBlueprint 最多尝试后续九个端口。不同 AI 客户端的配置格式不同，因此本文不规定某个客户端专用的 JSON 文件或手动端口配置步骤。

initialize 和 tools/list 通常由 MCP 客户端自动完成；ping 只用于排障，不是普通用户每次都要手动执行的步骤。

服务器只绑定本机。浏览器风格的 Origin 只允许 localhost、127.0.0.1 和 [::1]；普通非浏览器 MCP 客户端可以省略 Origin。

当前版本注册 69 个工具：

主要能力包括：

• 大型资产、成员、图表和 Pin 读取的稳定有界分页。
• 使用 Action Registry 返回的节点 ID，而不是编造节点类型。
• 单事务图表 Patch：创建、连接、断开、删除、移动、默认值和布局；失败时尝试自动回滚，恢复无法证明会明确报告。
• Balanced、Straight、Compact 三种确定性布局风格。
• 局部和全图布局中的原生 Comment Box 包围关系保护。
• 高风险修改的 dry-run 影响分析和显式批准门禁。
• 事务回滚，以及 Unreal 支持范围内的单步 Undo。
• 显式持久化：普通编辑工具只把资产标脏；SaveAsset 明确写盘，DeleteAsset 在更严格门禁后明确删除磁盘资产。
• 无需项目声明即可从引擎目录自动发现并加载。

下列对象在 UE 编辑器里常常相邻显示，但它们不是同一件事；选错工具可能得到“调用成功但效果不在预期位置”的结果。

普通编辑工具只标脏，不会静默保存；需要保留改动时使用 SaveAsset。下表说明每个工具的用途和用户需要注意的边界。

1. 用 BlueprintPath 调用 GetBlueprintOverview，找到由这个蓝图声明的变量及其 VarGuid。再调用 GetBlueprintDetails，传入 Target.Kind: "MemberVariable"、变量 Name，并可附带 VarGuid。CoverageComplete: false 表示目前返回已实现目标类型的声明属性，尚未覆盖全部蓝图 Details 功能。编辑前查看 Properties：Current 是当前值，IsSet 区分元数据键缺失与空字符串，Editable/Reason 或 Enable/Disable 说明可执行的更改。Enable/Disable 中，Allowed 表示操作可执行，NoChange 表示请求的状态已是当前状态，Reason 解释限制。Properties.NewName.Editable 只反映当前声明能否改名；拟用的新名称仍须通过校验。这里可以读取继承变量，但 ModifyVariable 只能修改目标蓝图自己声明的变量。
2. 调用 ModifyVariable，传入 BlueprintPath、现有的 VariableName，以及需要变化的字段。DefaultValue 修改 UE 文本格式的变量声明默认值；图节点 Pin 字面量用 SetPinDefaults，直接修改类默认值用 SetClassDefaults。它不会追溯覆盖已有实例的覆写值。Dirty 或刚创建的声明可以修改标记、默认值和元数据；改名、改类型要求已有成功编译基线。需要时编译蓝图；只有希望改动落盘时，才用 BlueprintPath 调用 SaveAsset。

以下均为完整工具参数。请把 /Game/Blueprints/BP_Player 和示例变量名换成自己项目中的蓝图路径和声明：

{"BlueprintPath":"/Game/Blueprints/BP_Player"}

把上面的参数传给 GetBlueprintOverview，再调用 GetBlueprintDetails：

{"BlueprintPath":"/Game/Blueprints/BP_Player","Target":{"Kind":"MemberVariable","Name":"Health"}}

若 Health 是 int32 声明，下面的 ModifyVariable 调用设置默认值、实例显示、分类和 SaveGame 归档标记：

{"BlueprintPath":"/Game/Blueprints/BP_Player","VariableName":"Health","DefaultValue":"100","bInstanceEditable":true,"bSaveGame":true,"Category":"Stats","Tooltip":"Current health"}

复制变更会编译声明蓝图、必要的派生蓝图，以及实际受影响的已加载 Setter 消费者；请求需传入 bApproveReferenceUpdates: true，并启用自动编译。未加载的依赖会阻止修改，继承声明只能读取。GetBlueprintDetails 的三个复制字段同时提供声明值 Current 和已编译值 Compiled；读取 Compiled 前检查 CompiledKnown。例如，为 Health 启用仅拥有者通知：

{"BlueprintPath":"/Game/Blueprints/BP_Player","VariableName":"Health","Replication":"RepNotify","ReplicationCondition":"COND_OwnerOnly","bApproveReferenceUpdates":true}

这里设置变量声明；网络运行仍需 Actor 复制及相应网络配置。已关联的通知函数不能直接改名、改签名或删除，须先通过 ModifyVariable 解除关联。需要保留普通复制时改为 Replicated；完全关闭时改为 None，已有通知函数体均保留。

数值变量的范围修改也是一次完整的 ModifyVariable 请求：

{"BlueprintPath":"/Game/Blueprints/BP_Player","VariableName":"Health","UIMin":"0","UIMax":"100","ClampMin":"0","ClampMax":"100"}

若 AbilityFlags 是标量 int32，可传 {"BlueprintPath":"/Game/Blueprints/BP_Player","VariableName":"AbilityFlags","bBitmask":true}。若增加 BitmaskEnum，必须提供自己项目中允许用于蓝图变量且带 Bitflags 元数据的 Enum 的实际对象路径。位掩码修改只重建受支持的本地 getter/setter 节点；外部引用、派生蓝图或不受支持的本地节点可能阻止修改。位掩码变更应与改名、改类型分开调用。

访问限制示例：先检查 Details 中的 Properties.bBlueprintReadOnly.Enable 和 Properties.bPrivate.Enable；如果两者均允许，再调用 ModifyVariable：

{"BlueprintPath":"/Game/Blueprints/BP_Player","VariableName":"Health","bBlueprintReadOnly":true,"bPrivate":true}

ReadOnly 保留蓝图读取，但阻止变量 Set 节点；它不是深度不可变保证。可变引用的使用者也可能阻止启用只读，而某些引擎版本中的容器操作仍可能带警告通过编译。启用 ReadOnly 会移除 MakeEditWidget 元数据。Private 限制声明蓝图之外的蓝图读写；现有外部引用会阻止启用私有。无法解析的引用或未加载的派生蓝图可能阻止任一访问限制。SearchGraphNodes 中缺少继承变量动作，并不能证明 Private 访问安全。要解除限制，使用 {"BlueprintPath":"/Game/Blueprints/BP_Player","VariableName":"Health","bBlueprintReadOnly":false,"bPrivate":false}。

设置 bDeprecated: true 之前，先把仍需保留的默认值迁移到替代变量：Unreal 不会序列化弃用属性的值，重新打开蓝图后该值可能重置。需要保留修改时，用 {"BlueprintPath":"/Game/Blueprints/BP_Player"} 调用 SaveAsset。

五个编辑器标记只接受 JSON true/false；省略字段保持原态，同值请求报告无变更且不创建事务。修改限于本蓝图声明的成员，继承或原生成员可查询。用 GetBlueprintDetails 查看方向是否允许：

{"BlueprintPath":"/Game/Blueprints/BP_Player","Target":{"Kind":"MemberVariable","Name":"Health"}}

Properties 中每个标记包含 Current（声明值）、IsSet（前四个标记与声明值一致；ExposeOnSpawn 表示元数据键是否存在）、Effective（当前编译产物中的效果，无法判断时为 null）、EffectiveReason、Editable，以及 Enable/Disable 的 Allowed、NoChange、Reason。GetBlueprintOverview 也返回五个声明布尔值。蓝图待编译或刚执行原生 Undo/Redo 时，Current 与 Effective 可能不同；Undo/Redo 不保证自动重编译。

若 HandleOffset 是 Vector，可在同一请求启用实例编辑与视口控件：

{"BlueprintPath":"/Game/Blueprints/BP_Player","VariableName":"HandleOffset","bInstanceEditable":true,"bMakeEditWidget":true}

设置 bInstanceEditable:false 或 bBlueprintReadOnly:true 会清除 MakeEditWidget，响应会列出这项隐式修改。先检查最终组合是否允许，再提交请求。

bExposeOnSpawn 控制生成节点上的变量输入。先预览，再批准影响到的消费者：

{"BlueprintPath":"/Game/Blueprints/BP_Player","VariableName":"Health","bExposeOnSpawn":true,"bInstanceEditable":true,"bDryRun":true}

查看 EditorPropertyImpact.Consumers 中的节点、Pin 变化和 Losses，移除 bDryRun 并传 bApproveReferenceUpdates:true 才执行消费者更新。删除有默认值或连接的 Pin、改变不兼容的类型时，还须传 bAllowPotentialDataLoss:true。兼容修改保留 Pin 标识、连接和显式默认值；批准丢弃不兼容默认值后，Pin 使用新类型的原生自动默认值。已加载派生类的默认值覆写不会被声明默认值修改替换。Actor／Object 生成节点通常还要求 Instance Editable；旧 AddComponent 节点按其原生规则处理。

对已暴露的变量使用 NewName 时，工具会列出 EditorPropertyImpact.RenameImpact 和构造节点的影响。候选名冲突、无法安全处理的引用、未加载的派生类或未知重命名处理器会阻止修改。先解决具体原因，再重新预览。

改名后撤销或重做，再正常编译，可保留已加载派生类的变量覆写；后续对派生类默认值的编辑不会被这次改名覆盖。此行为限于插件当前加载期间；重载插件后，已有撤销历史中的覆写恢复不作保证。 FieldNotify 修改涉及使用它的蓝图时，先预览影响。例如 Widget 中已有的 Health：

{"BlueprintPath":"/Game/UI/WBP_Player","VariableName":"Health","bFieldNotify":true,"bDryRun":true}

ModifyVariable 默认 bDryRun:false；预览不写入或编译。实际更新消费者须传 bApproveReferenceUpdates:true，删除通知依赖还须传 bAllowPotentialDataLoss:true。启用 bAutoCompileAfterModify 时，工具编译受影响蓝图；关闭时，声明与当前 Effective 可能不同，需要显式编译。工具不自动保存，需要持久保存时调用 SaveAsset。

UE 5.2 的 Widget 不允许对 ReadOnly 成员启用 FieldNotify；5.2 MVVM 还需要实际注册的专用编译器，仅加载模块或类型不足以支持生成。5.3 及以上按通知接口和当前编译产物判断。相关资产未加载或引用无法确认时，请求会返回具体阻塞。UE 5.8 相关 MVVM 转换仅支持已确认的静态原生 BlueprintPure Float 函数、前向 OneTime 绑定、单个 Manual 上下文与单属性输入路径；其他标量、实例/getter、拆分 Pin、Node 或多路径转换会返回限制原因。

使用 GetGraphDetail 找到函数图及 Entry/Result 的所需标识；不要用显示名称代替这些标识。选择一个操作：AddInput、AddOutput、RenamePin、RemovePin、ChangePinType、MovePin、SetPinFlags 或 SetPinDefault。默认 bDryRun=true；更新引用时必须设置 bApproveReferenceUpdates=true。删除参数、改参数类型或设置参数标志还须设置 bAllowPotentialDataLoss=true。工具会处理可安全更新的调用点，失败时尝试回滚；不会自动保存。

用 Operation="MovePin" 调整参数在输入组或输出组内的位置。从 GetGraphDetail 的函数 Entry 或 Result 取得参数 PinId，再指定 NewIndex，表示移动后在该组内从 0 开始的位置。例如输入为 [A, B, Depth]，把 A 移到 NewIndex=2 后得到 [B, Depth, A]。Exec 和 self Pin 不计入索引。ListBlueprintMembers 按名称显示参数，其中的 DeclarationIndex 表示参数在签名中的实际位置。

将蓝图路径、函数图 GUID 和声明 Pin ID 填入以下请求：

{
  "BlueprintPath": "/Game/Blueprints/BP_Example",
  "FunctionName": "Evaluate",
  "FunctionGraphGuid": "<函数图 GUID>",
  "Operation": "MovePin",
  "PinId": "<Entry 或 Result 的 Pin GUID>",
  "NewIndex": 2
}

查看默认 dry-run 返回的影响范围后，在同一请求中设置 bDryRun=false 和 bApproveReferenceUpdates=true 执行移动。移到当前位置不会产生变更。MovePin 不接受重命名、类型、默认值或参数标志修改，也不需要潜在数据丢失批准。移动保留参数身份、类型、默认值、标志和连线，并更新同蓝图普通调用、递归调用及支持的外部普通调用。输出参数会在所有匹配的 Result 声明中同步排序，各 Result 保留自己的字面量和 Pin 身份；Result 签名不一致时拒绝移动。可用正常 Undo/Redo 撤销或重做，完成后自行保存受影响资产。使用 MovePin 时，从原始基类的函数声明发起。支持已加载且编译完成的普通蓝图派生类，包括函数图覆写、仅继承函数的后代、普通调用和父函数调用。不支持直接编辑覆写图。目标函数或其任一覆写被 CreateDelegate 绑定时，会阻止移动；绑定到其他函数的稳定委托保留所选函数及连线。其他签名操作仍遵循原有的派生与覆写限制。

用 Operation="SetPinFlags" 修改参数声明的引用与 const 标志，必须同时提供 bIsReference 和 bIsConst 两个布尔值。用 Entry 的 PinId 选择输入，或用任一 Result 的 PinId 选择输出；输出会按参数名同步所有 Result，保留各自的 Pin 身份。

{
  "BlueprintPath": "/Game/Blueprints/BP_Calculator",
  "FunctionName": "Evaluate",
  "FunctionGraphGuid": "<函数图 GUID>",
  "Operation": "SetPinFlags",
  "PinId": "<Entry 或 Result 的 Pin GUID>",
  "bIsReference": true,
  "bIsConst": true
}

先查看默认 dry-run，再在同一请求中设置 bDryRun=false、bApproveReferenceUpdates=true 和 bAllowPotentialDataLoss=true。修改标志会清空所选参数的声明默认值。保存时，UE 可能将 Pin 当前的默认值同步回声明，例如整数输出的 0。两个标志都与当前值相同时，不清默认值，也不产生事务，Apply 仍需要上述批准。调用点的显式值和连线不会因批准而被清除。可写 ref 输入需要接到有效变量，单靠字面量无法通过编译；工具会拒绝或回滚不可编译的修改，不会替你补变量或改连线。原生声明若强制要求 const，与 bIsConst=false 冲突的请求会被拒绝。

SetPinFlags 不接受 PinName、TypeName、NewIndex 或 DefaultValue，其他操作也不接受这两个 flags 字段。数组即使声明的 bIsReference=false，仍可能隐式按引用传递；输出声明的 raw ref 也不保证编译后具有引用标志。修改成功后可正常 Undo/Redo，并自行保存受影响资产。

用 Operation="SetPinDefault" 修改函数输入参数的声明默认值。从 Entry 取得该参数的 PinId，并显式提供字符串 DefaultValue；允许空字符串。输出参数的各 Result 节点字面量使用 SetPinDefaults。

{
  "BlueprintPath": "/Game/Blueprints/BP_Example",
  "FunctionName": "Evaluate",
  "FunctionGraphGuid": "<GetGraphDetail 返回的 GraphGuid>",
  "Operation": "SetPinDefault",
  "PinId": "<Entry 中输入参数的 PinId>",
  "DefaultValue": "17"
}

先查看 dry-run，再加入 bDryRun=false 和 bApproveReferenceUpdates=true 执行；此操作不需要 bAllowPotentialDataLoss。声明字符串已相同且编译基线一致时，不产生事务。调用点原来继承声明默认值时会采用新值，显式覆盖值会保留；已连接参数保留连线，运行值仍由连线提供。成功后自行保存受影响资产，空值及结构体文本的具体表示以 Unreal 原生解析和保存后的读回为准。

此操作不接受 PinName、TypeName、NewIndex、bIsReference 或 bIsConst。只支持普通非引用输入；容器、编译后隐式引用、硬对象/Class/Interface、soft Actor 及 exec 参数会被拒绝。已加载的原生 CreateDelegate 绑定必须能只读证明其签名、选择器与连线稳定；会修正或清除绑定选择器的请求会在修改前拒绝。派生、覆写和其他不完整引用场景仍受原有安全检查限制。 修改前须有当前可验证的编译基线；Undo/Redo 后若相关蓝图显示待编译，先正常编译，再提交新的默认值编辑。

从 GetGraphDetail 取得目标节点标识，传入非空 PinDefaults 映射，例如 {\"Duration\": \"2.0\", \"InString\": \"Hello\"}。对象/Class Pin 需要完整对象路径。该工具不改变节点、连线或图结构；若输入 Pin 已连接，运行时会忽略它的默认值。结构变化请改用 ApplyGraphPatch。

先用 GetComponents 找到 ComponentName，用 GetComponentProperties 查看属性。把 Properties 作为“属性名 → UE 文本值”映射，例如 RelativeLocation: \"(X=0,Y=0,Z=50)\"。修改继承 SCS 组件时，还要复制成对的 DeclaringBlueprintPath 和 ComponentGuid。实际变化只在目标蓝图按需创建覆盖，祖先模板不是写入目标。

传入 ResetProperties 可从最近且已核验的父模板恢复指定属性，例如在继承组件身份参数中加入 "ResetProperties":["RelativeLocation"]。其他属性覆盖保留。恢复属性不等于要求删除整条覆盖记录；正常编译时，UE 可能剔除已经不再需要的记录。本地 SCS 模板不支持 Reset。

两个 setter 都支持 bDryRun:true，校验并预览 Changes，不创建事务、handler 或模板，不编译、不保存。Properties 与 ResetProperties 至少有一项非空；属性名不能重复，也不能同时出现在两处。原有只传 Properties 的调用仍可使用。继承编辑／Reset 路径不支持配置属性、实例化子对象、固定数组、原生默认子对象及不可继承编辑的模板。本地模板和 CDO 的 dry-run 也不支持配置属性与实例化子对象。ComponentTags 这类动态数组按一个完整属性使用 UE 文本值。

工具编辑目标默认值，不主动传播到已有后代默认值或已放置实例；UE 正常通知和编译仍可能产生编辑器自身的关联更新。关闭自动编译，或 Undo/Redo 使目标变脏后，应正常编译，再调用继承查询或编辑。工具不自动保存，需要落盘时另调 SaveAsset。

GetComponents 新增独立分页的 InheritedSCSComponents 列表。每行给出声明蓝图 DeclaringBlueprintPath、ComponentGuid、组件 Name、有效 TemplatePath 和来源蓝图 SourceBlueprintPath；TemplateSource 为 Declaration 或 Override。读取子蓝图时复制该声明身份：

{"BlueprintPath":"/Game/MyActorChild","ComponentName":"InheritedRoot","DeclaringBlueprintPath":"/Game/MyActorParent","ComponentGuid":"11111111-2222-3333-4444-555555555555"}

GUID 使用 GetComponents 实际返回的值。两个可选身份字段必须成对提供；不提供时仍读取本地 SCS 模板。继承读取要求已有编译成功的目标及一致的祖先链，返回最近已有覆盖或原始声明的有效值，并注明来源。缺少生成状态、GUID 歧义、owner／模板不一致时返回原因，需另行修复。查询不创建 CDO、handler 或覆盖模板。SetComponentProperties 使用相同的成对身份选择继承目标。

PropertyMetadata 返回有界的 ParentDefaultValue、bDiffersFromParent、bCanReset 和 Reset 不可用原因，ParentTemplatePath 标明比较来源。bHasLocalOverrideRecord 表示整条本地记录是否存在；属性值相等不能证明记录不存在。返回值不提供逐属性覆盖标记。

使用 GetClassDefaults 找到可编辑且大小写敏感的反射属性名及 UE 文本值。PropertyMetadata 给出父值、差异、Reset 可用性和拒绝原因，ParentDefaultPath 标明来源。SetClassDefaults 可传 Properties 修改值，也可传 ResetProperties 从当前 CDO 原型恢复继承属性。只在目标蓝图声明、父类没有对应属性的字段不能这样恢复；Reset 不支持配置属性和实例化子对象。

例如 {"BlueprintPath":"/Game/MyActorChild","ResetProperties":["InheritedNumber"],"bDryRun":true} 可预览继承整数的恢复结果，检查后去掉 bDryRun 执行。集合和预览规则与前述组件 setter 相同。CDO 修改为以后创建的目标类实例提供默认值，不主动更新已有后代默认值或已放置实例。修改后回读，按需编译，再单独保存。

ReparentBlueprint 改的是类继承：传 NewParentClassPath（原生完整路径、唯一已加载短名或 Blueprint 生成类）。先使用 bDryRun=true 查看风险；新父类不是旧父类的子类、旧父类缺失或接口冲突时，必须明确 bAllowPotentialDataLoss=true。它会刷新图；若操作失败会尝试 Undo 回滚。

ReparentComponent 改的是同一 Actor Blueprint 内本地 SceneComponent 的附着树：传组件名与新的 NewParentName。不能把节点挂到自身或子孙节点下；非 SceneComponent 不可改；实际本地根组件必须用 SetRootComponent。

涉及结构或数据变化的写操作可按以下顺序进行：

1. 定位 — 确定目标资产、图、Pin、成员或组件。
2. 搜索 — 通过 SearchGraphNodes 获取合法 SpawnerId。
3. 预览 — 工具支持时使用 bDryRun=true，检查受影响资产、规范化操作、限制和 blocker。
4. 应用 — 使用工具返回的标识，不编造 SpawnerId。
5. 保存 — 只有需要保留改动时才调用 SaveAsset。

Dry-run 不能展示所有生成 Pin、类型提升或最终布局。这是预览能力的限制，不代表工具会自动写入；写入前仍应使用当前搜索结果中的 SpawnerId。

下面的示例创建：

FinalScore = (BaseScore + Bonus) × Multiplier

1. 用 CreateBlueprint 创建 Actor 蓝图。
2. 用 CreateFunction 创建 CalculateScore，包含三个 double 输入和一个 double 输出。
3. 用 GetGraphDetail 找到新函数的 Entry/Result 节点标识。
4. 在这个函数图中搜索 Add 和 Multiply，使用返回的 Operator:Add 和 Operator:Multiply。
5. 预览一个同时包含两个节点和五条数据连接的 ApplyGraphPatch。
6. 对完全相同的 Patch 执行写入，使用原生 double 类型提升和自动 Balanced 布局。
7. 需要保留这项改动时，调用 SaveAsset。

最终图从左到右呈现 BaseScore + Bonus 后再乘以 Multiplier 的计算流程。

以下示例展示 Blueprint Editor 中常见的计算函数、完整业务图和规则调整前后的可见差异。它们用于帮助你理解节点、连线和默认值变化。

CalculateScore 展示 Add 与 Multiply 节点如何组合为一个清晰的计算函数。

EvaluateOrderBatchV2 展示一个订单结算函数如何在同一张图中处理订单累计、折扣、运费、税费、积分、风险分数和最终结果。

修改前，Region 1 直接执行 ShippingCents = 1000，不区分是否为首单。

修改后，Region 1 增加 FirstOrder 分支：首单运费为 0，其他订单仍为 1000。

修改前：PointsEarned = TotalCents / 100。

修改后：PointsEarned = (TotalCents - ShippingCents) / 100，新增 Subtract 节点以排除运费。

修改前：SubtotalCents × 0 后再加固定值 500，因此输出始终是固定折扣 500。

修改后：固定值路径改为 SubtotalCents / 20，即小计的 5% 折扣。

修改逻辑前，先使用 dry-run（若工具支持）了解影响；涉及引用更新或数据丢失时，按工具要求显式批准。需要保留改动时使用 SaveAsset。

• 用 ListBlueprints 分页查找资产。
• 用 GetBlueprintOverview 查看图、变量、函数、组件、接口和父类。
• 用 ListBlueprintMembers 查看函数、自定义事件、事件分发器和局部变量。
• 用 GetGraphDetail 查看节点、Pin、默认值、连线和布局。
• 用 GetCompileErrors 或 CompileBlueprint 查看编辑器诊断。

使用插件返回的资产路径。大型图请分页查看，避免一次返回过多内容。

1. 用 ListBlueprintMembers 找到局部变量，复制其完整 Target。FunctionGraphGuid 标识函数图，VarGuid 标识声明；可选 Name 若提供，必须与当前名称完全一致。
2. 将资产路径放入 BlueprintPath，把复制的对象放入 Target，再提供至少一个字段：NewName、TypeName、DefaultValue、Category、Tooltip。例如，提供 DefaultValue: "" 预览清空默认值，或同时提供 NewName: "TemporaryScore" 和 Category: "Calculation" 预览改名与分类。
3. bDryRun 默认 true。预览会列出引用及可能断开的连线；MaxResults 为 1–100，默认 50，只限制显示行数。
4. 应用同一请求时显式设置 bDryRun: false、bApproveReferenceUpdates: true。只要提供 TypeName，还要设置 bAllowPotentialDataLoss: true。需要保存时调用 SaveAsset。

省略的字段保持原值。真实改型且未提供 DefaultValue 时会清空默认值；相同类型不会误清。空分类恢复引擎默认分类，空提示移除提示元数据。同名成员、其他函数的同名局部变量不会随目标改名；与直接子蓝图成员冲突的新名称会被拒绝。

非空默认值支持数值、布尔、枚举、Name、字符串、安全数学结构，以及元素同样安全的 Array/Set/Map。顶层硬对象或类引用须已在内存中，并满足路径、类型和真实函数入口的访问权限；跨包私有对象会被拒绝。顶层软引用按其类型规则处理。非空 Text、嵌套对象/软引用、含对象的结构、接口或委托值，以及无法安全处理的原生结构会被拒绝。空默认值用于恢复类型初值；改名、分类和提示不会重新导入未修改的默认值。

使用 Unreal 英文动作名搜索，例如 Branch、For Loop、For Each Loop、Switch on Int、Switch on Name、Switch on String、Add、Subtract、Multiply 或 Divide。

ApplyGraphPatch 支持：

• 带临时 ID 和 Action Registry SpawnerId 的 Nodes。
• Connections 与 Disconnections。
• 通过节点标识定位的 RemoveNodes。
• 通过节点标识和图坐标定位的 MoveNodes。
• 可选的 PinDefaults、PromotedType、布局范围和布局风格。

整个 Patch 只使用自己的事务，失败时会检查 Undo 记录归属并尝试恢复。ApplyGraphPatch、ModifyVariable、ModifyLocalVariable 和 ModifyFunctionSignature 的恢复响应带有 RecoveryContractVersion: 2，仍作为错误返回。查看以下字段后再决定下一步：

若出现内容差异、运行时差异或无法证明恢复，请停止修改并检查当前资产。Dirty 或已有编译错误的图仍可建图；蓝图缺少 Undo 所需的实际生成类/CDO 时会返回 RecoveryUnavailable，不会偷偷先编译。

• 变量工具管理类型、默认值、Category、Tooltip 和安全删除。
• 函数工具创建、重命名、执行受支持的签名修改，或安全删除用户函数。
• 局部变量操作需要函数图和变量声明标识。
• Struct/Enum 修改使用字段或条目标识，并会报告引用影响。
• 可能丢失数据或改变 Enum 序列化值语义的操作需要独立显式批准。

函数重命名和签名修改会先分析影响。遇到无法安全处理的 Override、Delegate 绑定、派生类或引用时，工具会拒绝操作，不会勉强修改。

下面两张图展示函数改名后的定义与调用点。改名前先使用 dry-run；工具要求更新引用时，必须显式批准。需要保留改动时使用 SaveAsset。

以下示例展示带输入输出参数的函数、组件事件辅助函数图，以及 Actor 生命周期、组件绑定事件和可变 Pin 的常见结构。

先用 AddEventDispatcher 声明分发器，例如 OnSignal，输入 Payload:int。随后调用 SearchGraphNodes，传入目标 BlueprintPath、GraphName 和 Query="OnSignal"，获取真实节点和 Pin。

• Bind：添加一个接收事件。
• Call：广播输入参数，调用所有已绑定的接收事件。
• Unbind：移除指定接收事件。
• UnbindAll：移除该分发器的所有接收事件。

用 CreateCustomEvent 创建输入签名相同的接收事件，再用 ApplyGraphPatch 创建搜索返回的节点。把接收事件的 @<NodeGuid>.OutputDelegate 连到 Bind 或 Unbind 的 Delegate Pin；把发起事件的 then 连到 Bind 的 execute，再把 Bind 的 then 连到 Call 的 execute。Call 的 Payload 可以通过 PinDefaults 设置，也可以连接数据来源。完成后用 GetGraphDetail 核对连线和编译结果，使用 SaveAsset 保存。

Assign 会创建分发器节点和一个签名匹配的 Custom Event，并自动连接委托 Pin；它添加接收事件，保留已有绑定。需要在同一次 ApplyGraphPatch 中连接事件体时，在 Assign 的节点对象中指定 EventTempId，例如 {"TempId":"assign","SpawnerId":"<搜索返回的 Assign ID>","EventTempId":"receive"}。随后用 receive.then 连接事件体执行输入，用 receive.Payload 连接数据输入。EventTempId 与所有节点的 TempId 共用唯一名称空间；结果 NodeGuids 返回这两个别名，CreatedNodeCount 包含伴生事件。不指定别名也会创建伴生事件。Assign 需要支持事件的图，不能放入函数图或宏图。

要把已有函数或 Custom Event 作为接收者，可搜索 Query="CreateDelegate"，使用返回的 Native:K2Node_CreateDelegate ID 创建 Create Event 节点。在该节点对象中填写必需的 DelegateTarget：

• 函数：{"Kind":"Function","Name":"ExistingHandler","FunctionGraphGuid":"<ListBlueprintMembers 返回的 FunctionGraphGuid>"}。
• Custom Event：{"Kind":"CustomEvent","NodeGuid":"<已有 Custom Event 的 NodeGuid>"}。

目标必须是当前蓝图自身已有、且签名兼容的处理函数或事件。把 Create Event 的 OutputDelegate 连到 Bind 或 Unbind 的 Delegate；需要对象连接时也在同一 Patch 中提供。工具完成连接后选择目标并检查签名，失败时回滚整个 Patch，包括 Assign 的伴生事件。目标使用稳定 GUID 识别，GUID 失效时不会按同名目标回退。

这五种分发器操作支持目标蓝图自身声明的标量分发器。Delegate:<操作>:self:<声明GUID> 标识在编译和保存后保持稳定；删除后同名重建会产生新 GUID，旧标识会被拒绝，应重新搜索。节点创建仍不支持继承或跨蓝图目标。已有本地声明的签名与改名操作见下节。

先调用 ListBlueprintMembers，用 MemberKind: "CustomEvent" 或 "EventDispatcher" 找到声明，复制返回的 Target。自定义事件使用 {"Kind":"CustomEvent","NodeGuid":"<返回的 NodeGuid>"}；分发器使用 {"Kind":"EventDispatcher","Name":"OnSignal","DeclarationGuid":"<返回的声明 GUID>"}。参数编辑使用 Inputs 中当前的 PinId；修改后重新读取，不用名称代替 GUID。

ModifySignalSignature 每次执行一种操作：

例如预览一个本地事件的默认值修改：

{"BlueprintPath":"/Game/Blueprints/BP_Receiver","Target":{"Kind":"CustomEvent","NodeGuid":"<返回的 NodeGuid>"},"Operation":"SetPinDefault","PinId":"<Inputs 返回的 PinId>","DefaultValue":"23"}

检查返回的 References 和 AffectedBlueprints 后，在同一请求中加入 bDryRun: false、bApproveReferenceUpdates: true 应用。已有调用点的显式覆盖保留；已连接的输入仍从连线取值。删除或改类型前须显式断开声明、调用及伴生事件上的相关连接，包括拆分子 Pin。与已有 CreateDelegate 处理器不兼容的签名变更会被拒绝，工具不会修改处理器签名。

CustomEvent 的硬对象、类和接口输入只接受空声明默认值，因为新建 Call 节点不会继承这些类型的非空值。此限制覆盖 AddInput、ChangePinType（包括省略默认值而沿用旧非空值）和 SetPinDefault；清空时显式传 DefaultValue: ""，具体 Call 节点的对象值用 SetPinDefaults 设置。其他已支持的 CustomEvent 类型仍可使用非空声明默认值。EventDispatcher 的 AddInput、ChangePinType 只接受省略或空默认值，SetPinDefault 必须传 DefaultValue: ""；"0"、"false" 等非空值也会被拒绝。改类型时如果沿用的旧默认值非空，请显式传空字符串。分发器声明中可读到默认值不代表 Call 节点会继承它；其他调用值请用已有 SetPinDefaults 设置在具体 Call 节点上。

RenameSignal 使用同一 Target 和 NewName，默认预览。分发器改名后保留原 DeclarationGuid，下一次请求使用新 Name；CustomEvent 保留 NodeGuid。工具更新精确的已加载调用与绑定引用，保留原有处理器身份。继承、覆盖、接口实现及直接由委托签名驱动的接收事件不能在此修改。

删除 CustomEvent 使用同一 Target 调用 RemoveCustomEvent，同样先预览再批准应用。删除分发器使用 RemoveEventDispatcher 的 DispatcherName，可附 DeclarationGuid 防止同名重建误匹配；此工具直接执行安全删除。两者都会拒绝仍有真实调用或绑定的声明，须先用 ApplyGraphPatch 显式移除这些引用。未知或未加载引用会阻止变更；不级联删除外部节点，也不自动重接执行链。支持普通 Undo/Redo；完成后显式 SaveAsset 保存声明及受影响资产。

ListBlueprintMembers 的函数 Inputs、Outputs 仍按名称字母顺序返回。每个函数参数额外包含 DeclarationIndex（其所属入口或结果 Terminal 声明数组中的零基下标）、bIsReference 和 bIsConst。下标属于各 Terminal，并非整个函数的唯一序号。bIsReference、bIsConst 表示声明的 raw 值。bCompiledFlagsKnown=true 时，还返回当前自有编译函数的 bCompiledReference、bCompiledConst 和 bCompiledOutParm；不可用时仅返回 bCompiledFlagsKnown=false，不把未知标志写成 false。查询不会触发编译，可先正常编译蓝图再读取。引用输入也可能带 OutParm，它仍属于逻辑输入组。原有分页、16 个 Pin 的签名上限及默认值截断规则保持有效；CustomEvent、EventDispatcher 的输入还返回声明 PinId、DeclarationIndex 和稳定身份 Target，用于下方信号生命周期工具。

用 MemberKind: "Function" 调用 ListBlueprintMembers，把函数的 Name 和 FunctionGraphGuid 放入 Kind: "Function" 的 Target。NodeGuid 标识入口节点，不能代替图 GUID。先用相同 Target 调用 GetBlueprintDetails 查看可用属性和编辑限制，再调用 ModifyFunctionDetails：

{"BlueprintPath":"/Game/Blueprints/BP_Player","Target":{"Kind":"Function","Name":"SendSignal","FunctionGraphGuid":"<ListBlueprintMembers 返回的 FunctionGraphGuid>"},"DisplayName":"Send Signal","Tooltip":"Sends the current payload.","Category":"Signals","Keywords":"payload emit","CompactTitle":"SEND","bCallInEditor":true,"bDeprecated":false,"DeprecationMessage":""}

DisplayName 修改调用节点标题；Tooltip 提供函数提示；Category 控制菜单分类；Keywords 便于动作搜索；CompactTitle 设置紧凑调用节点标题。bCallInEditor 仅声明函数可从编辑器调用，不执行函数。bDeprecated 标记函数使用已弃用，启用该标记时 DeprecationMessage 提供替代建议。可用新显示名、分类或关键词调用 SearchGraphNodes 查找调用动作。

遗漏字段保持原值；空文本清除对应内容，空 Category 恢复 Unreal 默认分类。分类、关键词与紧凑标题会去除首尾空白。清除 CompactTitle 会恢复普通调用标题并保留关键词。弃用函数只有在 Blueprint Editor 中启用显示弃用函数的设置（bExposeDeprecatedFunctions）后，才会出现在动作搜索中。仅修改上述显示与编辑器属性时，工具保留原有直接应用行为，无实际变化会被拒绝。重写／接口实现、RepNotify、构造和其他受保护函数只读。

声明字段为 JSON 布尔值 bPure、bConst、bExec，以及 Access: "Public" | "Protected" | "Private"。包含任一声明字段的请求默认只预览，也可与显示属性一起提交。确认影响后，添加 bDryRun: false 和 bApproveReferenceUpdates: true 应用；完全相同的声明请求返回 bNoOp: true，不修改或编译。例如，先预览把函数设为 Pure：

{"BlueprintPath":"/Game/Blueprints/BP_Player","Target":{"Kind":"Function","Name":"CalculateScore","FunctionGraphGuid":"<ListBlueprintMembers 返回的 FunctionGraphGuid>"},"bPure":true}

从非 Pure 改为 Pure 时，受支持的普通调用链由 Unreal 原生逻辑旁路执行引脚，数据连接保持不变。反向修改若仍有已连接的数据输出且没有可证明的执行位置，会在写入前拒绝；先明确连接执行路径。作为 CreateDelegate 目标的函数不能设为 Pure；访问级别也不能使现有调用或目标委托的所属上下文失去访问权限。Const 由原生编译器校验，静态函数不支持修改 Const。Exec 控制原生命令调用资格，工具本身不执行函数。应用成功后用 SaveAsset 保存；参数签名与 RPC 声明仍使用对应专用工具。

从 CreateCustomEvent 或 GetGraphDetail 获取事件的 NodeGuid，用相同 Target 调用 GetBlueprintDetails 和 ModifyCustomEvent。例如，把本地事件声明为可靠的服务端 RPC：

{"BlueprintPath":"/Game/Blueprints/BP_Player","Target":{"Kind":"CustomEvent","NodeGuid":"<事件的 NodeGuid>"},"Replication":"Server","bReliable":true}

Replication 可选 None、Server、Client、Multicast。None 停用 RPC，未传 bReliable 时保留声明中保存的可靠位；它在非 RPC 模式下不生效。显式设置或清除 bReliable 时，最终模式必须是 RPC，可在同一个请求中指定模式。Details 的 Current 显示保存值，Effective 显示当前生效的 RPC 和可靠位。

bCallInEditor 控制编辑器可调用声明，工具不会执行事件；bDeprecated 标记弃用，DeprecationMessage 保存弃用说明，空字符串清除说明。布尔值须使用 JSON true/false。遗漏的字段保持原值，相同状态请求报无变化。只支持本蓝图自身且编译成功的可编辑事件；覆盖、接口实现和已绑定分发器的接收事件会被拒绝。完成后用 SaveAsset 保存。这些设置不改变 Actor 的复制开关，联机运行仍须配置 Actor 复制、所有权和调用端。

添加、重命名、复制、重设父级、设置根组件、修改模板属性或删除组件前，先读取当前组件层级。类默认值工具读取或修改支持的 Blueprint 默认值，不会把实例值冒充为类默认值。

资产工具可以创建、复制、重命名、重设父类、编译、打开、关闭、重载、删除和保存支持的蓝图资产。

• 磁盘重载默认 dry-run，丢弃内存状态前必须显式批准。
• 破坏性删除比普通图修改具有更严格的 Undo/Redo 和 Package 安全要求。

先调用 OpenAsset，再使用 CaptureGraphScreenshot。可以截取完整图表、聚焦某个节点，或复用指定视口。分享图片前，请确认标题、Pin 和连线清晰可读。

截图工具要求已初始化的蓝图图表编辑器控件。未打开图表编辑器或图表控件尺寸为零时，截图请求会被拒绝。

打开 项目设置 → 插件 → MCP Blueprint：

• Port — 默认 8766；被占用时最多尝试后续九个端口。
• Auto Start — 随编辑器启动服务器。
• Auto Compile After Modify — 支持的写操作完成后自动编译。
• Request Timeout Seconds — 普通工具超时。
• Compile Timeout Seconds — 编译类工具独立超时。

• 支持 Windows、macOS 和 Linux Editor；不提供 Runtime/Shipping 模块。
• 暂无“调用任意 Blueprint 函数并返回运行结果”的通用工具。
• 信号生命周期工具只修改普通蓝图自有声明；继承、接口、覆盖或签名驱动的事件须回到来源修改。分发器仅支持原生空默认值，具体调用值用 SetPinDefaults 设置。
• 某些 Blueprint Action 无法安全处理时，工具会直接拒绝操作。
• 截图需要真实初始化的 Blueprint Graph Editor 控件。

• 无法连接： 使用工具栏显示的实际端点，配置端口可能已被占用。
• 找不到工具： 刷新 tools/list，不要依赖旧缓存。
• 写入被拒绝： 阅读所有 blocker 和批准参数要求，重试前重新读取目标。
• 编译失败： 获取编译诊断，根据真实蓝图错误修复后再保存。
• 图表结果异常： 对比前后的 GetGraphDetail，适用时执行 Undo。
• 插件提示重建： 安装与引擎小版本完全匹配的包。
• 项目中找不到插件： 核对插件是否安装在该引擎的 Engine/Plugins/Marketplace；不要用添加项目依赖的方式绕过。
• UE 5.5 提示项目文件过期，原因是已安装的 MCPBlueprint 不在项目描述符中： 选择 Not Now（暂不）。引擎插件仍会自动加载；选择 Update（更新） 会把 MCPBlueprint 写入项目 .uproject，形成当前安装模式明确要避免的项目侧依赖。

如有问题或反馈，请使用统一联系页面。

普通蓝图可用 GetBlueprintDetails 与 Target: {"Kind":"ClassSettings"} 读取资产声明的 DisplayName、Description、Category 原始值，包括空字符串。该 Target 只接受 Kind，不要附加成员名称或 GUID。三个字段返回 Current、Editable: true 与 Reason；CoverageComplete 保持 false，表示当前只开放这三个展示字段。查询不编译或创建 CDO，也不读取实例默认值。

调用 ModifyClassSettings 时直接传入 BlueprintPath 和要修改的字符串，不需要 Target。省略字段保留原值，空字符串清除该字段，空格和换行按原样保存。相同值不会创建事务；未提供任何展示字段会被拒绝。工具编译修改但不保存资产，完成后调用 SaveAsset。

{"BlueprintPath":"/Game/Blueprints/BP_Receiver","DisplayName":"Signal Receiver","Description":"Receives signal payloads.","Category":"Signals|Local"}

要移除当前蓝图直接实现的接口，先从 GetBlueprintOverview 的 Interfaces 复制完整接口类路径，再调用 RemoveInterface：

{"BlueprintPath":"/Game/Blueprints/BP_Receiver","InterfacePath":"/Game/Interfaces/BPI_Signal.BPI_Signal_C"}

工具保留接口函数体，将已实现的接口事件转换为保留连线的本地 Custom Event，并编译修改。接口消息在移除后不再向该蓝图分发；保留的函数和事件可作为本地实现调用。继承接口须到声明它的父蓝图修改，短名称和非接口类路径会被拒绝。目标接口已不在当前蓝图中时返回无变化。此操作只提供保留实现体模式，不保存资产；需要持久化时再调用 SaveAsset。

ModifyMacroDetails 编辑已成功编译的普通蓝图中本地宏的原生输入 Tunnel 元数据。先用 GetGraphDetail 获取宏的 GraphGuid，再用 Target: {"Kind":"Macro","Name":"Relay","GraphGuid":"<返回的 GUID>"} 调用 GetBlueprintDetails，查看各属性的原始 Current、Editable、Reason 和 Impact。

用同一 Target 调用 ModifyMacroDetails，传入需要改变的 Category、Tooltip、Keywords 或 CompactTitle 字符串。省略字段保持原值；分类、关键词和紧凑标题会去除首尾空白。空分类恢复 Unreal 默认分类；空提示、关键词或紧凑标题只清除对应字段，清除紧凑标题仍保留独立关键词。动作搜索读取原生分类、关键词和提示，保持名称式 SpawnerId；原始提示为空时，搜索结果可以显示 Unreal 的宏实例默认提示。分类实质变更遇到同名 skeleton 或继承函数时拒绝。未知字段、null、过期标识和无实质变化的请求均拒绝。普通蓝图修改保全既有图标识、Pin 与连线，并编译修改。工具不改签名或名称；请显式保存资产。

原生宏库使用同一组 Target 和四个字段。GetBlueprintDetails 返回原始值及编辑能力。库须有有效 GeneratedClass，状态为 UpToDate、Warning 或 Dirty；缺少类、Error/Unknown 状态或正在编译时，写入前拒绝。新库尚未生成类时，先显式编译。展示编辑保留库现有状态，并保全已加载资产的权威图（含嵌套子图）中消费者的内容、状态及 dirty。不支持的 Blueprint 子类、自定义宏实例类型和未解析的相关引用会被拒绝；操作不会加载尚未加载的消费者包。

宏库展示编辑不主动请求完整蓝图编译。原生编辑器 Undo/Redo 可能重新生成 skeleton 并使库保持 Dirty；此时仍可继续修改展示字段。bCompilationRequired、AfterStatus 和 bPackageDirty 如实报告资产状态。操作失败时，bContentRestored 和 bRollbackStateRestored 分别表示内容恢复与编辑器状态恢复；内容恢复成功后库仍可能为 Dirty，响应仍为错误。请显式调用 SaveAsset 持久化库，metadata 操作不会修改或保存消费者。

CreateBlueprint 可选 BlueprintKind: "MacroLibrary"；省略时保持普通蓝图行为。宏库当前只支持合法原生父类，如 /Script/Engine.Actor 或 /Script/CoreUObject.Object，拒绝蓝图生成类作为父类。

新建资产先调用 CompileBlueprint，再调用 CreateMacro。创建要求当前蓝图已成功编译，并保全既有图和链接。执行 Pin 必须明确写 TypeName: "exec"；省略 Inputs 或 Outputs 不会自动增加执行 Pin。数据 Pin 沿用现有具体类型语法，不支持 wildcard、by-reference 或 const 签名。

{
  "BlueprintPath": "/Game/Blueprints/BP_MacroLibrary",
  "MacroName": "Relay",
  "Inputs": [{"Name": "Enter", "TypeName": "exec"}, {"Name": "Value", "TypeName": "int"}],
  "Outputs": [{"Name": "Leave", "TypeName": "exec"}, {"Name": "Result", "TypeName": "int"}]
}

返回 GraphGuid、EntryNodeGuid、ExitNodeGuid 和真实 Pin 详情。Inputs 对应入口 Tunnel 的输出 Pin；Outputs 对应出口 Tunnel 的输入 Pin。使用 ApplyGraphPatch 连接宏内部逻辑；GetGraphDetail 也会返回 GraphGuid。

在实际消费图中调用 SearchGraphNodes 获得精确宏 SpawnerId，通过 ApplyGraphPatch 放置并连线，再编译消费蓝图。普通蓝图中的宏仅在本蓝图使用；宏库可用性遵循原生父类和官方 ActionFilter。现有图上下文检查会拒绝自递归及函数中使用 latent 宏。CreateMacro 只负责新建；已有宏的编辑见下方生命周期工具。宏库与消费蓝图都需明确 SaveAsset 保存。

普通蓝图中的自有宏和原生宏库共用以下流程。先编译声明方及已加载的消费者，再以 Target: {"Kind":"Macro","Name":"Relay","GraphGuid":"<返回的 GUID>"} 查询 GetBlueprintDetails。返回的 Inputs、Outputs 包含声明 PinId、实际类型、默认值及从零开始的 Index；输入对应入口 Tunnel，输出对应出口 Tunnel。

ModifyMacroSignature 每次执行一种 Operation：

例如先预览参数改名：

{"BlueprintPath":"/Game/Blueprints/BP_Macros","Target":{"Kind":"Macro","Name":"Relay","GraphGuid":"<返回的 GUID>"},"Operation":"RenamePin","PinId":"<Inputs 中的 PinId>","PinName":"Amount"}

这三个工具都默认 bDryRun: true。检查预览中的 Instances 和 AffectedBlueprints，应用时添加 bDryRun: false、bApproveReferenceUpdates: true。签名修改只接受该操作列出的附加字段；省略 DefaultValue 不能设置默认值。删参或改类型遇到声明内部或实例上的连线会拒绝，先显式断开再提交；类型变化会按原生规则重置默认值，修改后读取真实结果。参数改名和重建会更新已加载实例，未受影响的连线及实例覆盖默认值保留；未知或未加载引用会在修改前阻止操作。

RenameMacro 使用同一 Target 和 NewName。成功后用新 Name 与原 GraphGuid 继续查询或修改；宏库旧名的原生重定向可以保留。RemoveMacro 使用同一 Target；有实例时返回拒绝及实例所在蓝图、图 GUID、节点 GUID。先显式移除所有本地、外部实例并编译，再预览和删除声明。移除实例本身会改变执行语义，工具不会补执行链，也不会级联删除外部节点。修改可正常 Undo/Redo；相关蓝图需要编译时先编译，再进行下一次编辑。完成后显式保存声明方和受影响消费者。