硬件状态
i9-13900HX | RTX 4060 | 64GB
第一章：怎么配置模型（平行四选一）
在 UMG MCP 中，为了让 AI 完美编织 UI，我们设计了四种平行的模型接入机制。您可以根据开发者的实际部署情况（如本地计算或远程 API），在虚幻编辑器的 Project Settings -> Unreal Motion Graphics MCP 中进行一键配置。
1. 四大平行配置模式详解
01 本地大模型 (LiteRT-LM)
内置免梯
运作原理： 开启此选项（设置 bEnableLiteRtLm = true）后，插件将直接拉起内置的 C++ LiteRT 推理引擎。它直接加载保存在插件 Resources/Models 目录下的本地模型文件（例如 gemma-4-E2B-it.litertlm）。
🛠️ Winyunq 硬件调优建议：
得益于您强大的 i9-13900HX CPU 与 RTX 4060 GPU 硬件：
- 建议将
LocalModelContextLength（上下文长度）设为 65536。 - 将
LocalModelPrefillChunkSize设为 4096，以发挥 RTX 4060 大吞吐并行的优势，保障流畅的生成体验。
02 Google 登录账号 (AuthLogin)
一键云连
运作原理： 选择此供应商后，通过虚幻内置的 UUmgMcpAuthenticationSubsystem 调起 Google OAuth 2.0 登录流程，完成账号安全授权。插件将直接通过网络请求获取临时的 Access Token 进行鉴权，无缝直连 Google Gemini API，免去手动输入 API Key 的琐碎流程。
03 API 密钥配置 (ApiKey)
高阶自定义运作原理： 支持配置多组远程大模型平台。系统自带 Google (Gemini API)、ZhipuAI (智谱 AI) 预设，并支持 Custom 模式（可填入任意符合 OpenAI 协议的自定义 Endpoint，如 DeepSeek、本地 OneAPI/LM-Studio 后端）。支持模型配置的多 Tag 调度路由。
04 本地命令行 (Local CLI)
管道直通
运作原理： 专为极致的脚本极客设计。设置首选供应商为 CLI 模式，并在 LocalCliCommand 中配置可执行文件名。插件在推进会话时，将在后台启动此控制台进程，以标准输入输出 (StdIn/StdOut) 的管道方式接收和回传大模型数据，实现最底层的完全控制。
🔐 API Key 安全防护与非 Git 持久化原理
在团队协作中，最常见的灾难就是**误将包含个人或公司付费 API Key 的配置文件提交到公共 Git 仓库**，导致巨额账单泄露。为此，UMG MCP 插件在底层完美结合了虚幻引擎的安全特性，设计了物理隔离的双重防泄露机制：
属性脱敏：meta=(Password=true)
在 `UmgMcpSettings.h` 源码中，API 密钥定义为 meta=(Password=true)。这使得虚幻编辑器在 Details 面板展示此属性时，会自动对其执行密码圆点脱敏遮罩，防窥防屏录。
非 Git 持久化路径：Saved/Config/WindowsEditor/Editor.ini
该配置类声明为 UCLASS(Config = Editor, DefaultConfig)，但所有的 API Key 数据均存放在由 UPROPERTY(Config) 修饰的运行时字段中。这表明：
- 当您在编辑器中输入并保存配置时，它**绝不**会写入项目的
Config/DefaultEditor.ini（该文件通常需要提交至 Git 跟踪）； - 而是自动持久化在项目根目录下的
Saved/Config/WindowsEditor/Editor.ini本地缓存中。 - 根据虚幻的工业标准，整个
Saved/目录在 Git 的.gitignore中是**默认且强制物理屏蔽**的！
📸 物理截图占位（双击此卡片查看截图详情）
[IMAGE_PLACEHOLDER: Unreal Settings - DeveloperSettings Tab for Unreal Motion Graphics MCP]
请运行虚幻编辑器，打开项目设置，截图“Unreal Motion Graphics MCP”属性窗口并替换此占位。