UAgent

Agent *用于编辑器的 AI 代理。* UAgent 在 UE5 中嵌入Agent Client Protocol](https://agentclientprotocol.com) (ACP) 客户端** 和 **Model Context Protocol (MCP) 服务器** **Claude CLI**任何兼容 ACP 的代理 —、Zed 的代理对，并与一个 AI 聊天，该 AI 可以读取和编辑您在编辑器中的蓝图、关卡。 https://github-attachments/assets/1e08db26-0494-5-b88e-bbbee5bf ## 功能 - **聊天窗口**， UE5 编辑器选项卡停靠（窗口 → UAgent）。 - **流式响应** — 代理消息块实时追加。 -调用卡片** — 内为（待处理中 / 已完成）。 - **自动上下文** — 您在打开的任何资产都会到每个消息中，以便代理正在处理的内容。可以通过包含打开的资产** - **`AGENTS.md` 项目上下文** — 在每个会话的第一个提示中，如果 `<ProjectAGENTS.md` 存在将作为项目上下文块预，以便代理在任何资产看到您的项目约定。UA遵循跨代理的 `AG` 约定（也x / Cursor / Aider编辑会自动拾取。 - **@-提及** — 在输入中键入 `@` 以从实时筛选的列表中选择任何项目资产。添加一个可以删除的芯片。 - **斜杠命令** — 在输入中键入 `/` 以从代理的广告命令中选择（按 ACP `availableCommands` / `available_commands_update`）。弹出窗口与代理当前公开的内容保持同步。 计划条** — 当代理发出结构化计划 Claude 的 `/plan` 样式任务列表）时，它会渲染为输入行上方的粘，并在任务完成时实时更新 **模式选择器** — 当代理宣传会话模式（Cl *default* / *its* / *plan*bypassPermissions*，Codex 的 *read-only* / *default* / *full-access*）时，**模式：** 下拉菜单出现在聊天底部。设置的模式是后台代理通过 `session/new` 广播的内容；切换发送 `session/set_mode`，代理的 `current_mode_update` 通知保持 UI 同步。您的选择按用户保存，并在后续会话中重新应用，当模式仍然可用时。 - **权限卡片** — 对于代理在当前模式下未预先批准的变异工具，将显示带有原始参数的 **接受 / 取消** 卡片，渲染为 Markdown 内聊天中；只自动允许。 - **器** — 当代理宣传模型选项（Claude CLI 支持，**模型：**菜单出现在模式下拉菜单旁边选择按用户保存，并在后续会话中重新应用，当模型仍然可用时。 - **使用情况指示器** — 发送按钮下运行上下文预算百分比和（当代理报告时）来自 `usage_update` 通知的每次调用成本。 - **会话 — 当代理支持时（Claude 支持），标题中的 ** 按钮列出以前的会话，并通过 `session/load`定的会话。 - **导出记录** — 通过标题中的导出聊天保存为 Markdown。 - **工具** — 读取/写入项目文件，检查蓝图，驱动等。有关完整列表，请参见 [TOOLS.md](TOOLS.md)。 ## 安装 ### 先决条件 - 虚幻引擎 5.7 上测试过。 - 后台代理 ACP 的 CLI，例如 Claude推荐），Codex CLI，Gemini CLI 或 Zed 的参见下面的 [代理](#### 安装插件 将库放入项目的 `Plugins` 文件夹布局如下所示``` <YourProject> <YourProject>.uproject └── Plugins/ └── UAgent/ └── UAgent.uplugin ``` 如果 `Plugins`，请在 `.uproject旁边创建。在下一次编辑器启动时，UE 将提示 — 接受，或在手动构建。如果尚未启用，请编辑 → 插件 → UAgent** 下启用插件。 ### 代理 您需要一个兼容 ACP 的后台代理。插件目前已与 Claude CLI 测试过，但任何 ACP 桥接器都可以使用 — Gemini CLI、Zed 的代理或任何语言的自定义代理。 #### Claude CLI（推荐） 按照官方说明安装两个组件： - **Claude Code CLI**设置文档](https://aude.com/docs/en/setup) - **claude-agent-acp将 CLI 连接到此插件的 ACP 适配器）— [存储库](https.com/agentclientprotocol/claude-agent-acp) #### Codex按照官方说明安装两个 - **OpenAI CLI** — [安装指南](https://developers.openai.com/cli) - **codep** （将 CLI 连接到此插件的 ACP 适配器）— [存储库](github.com/zed-industries/codex-acp) ###设置 **项目设置插件 → UAgent：** | 字段 | 值 | | --- | --- | | **代理 | 已安装的 ACP器 shim 的路径 — 例如 `C:\nvm4w\nodejs\claude-agent-acp`（Claude）或 `C:\nvm4w\codex-acp`（Codex）。在 Windows 上，无扩展名的 shim 是可以 它会自动升级到其 `. 对应文件。`. 路径通过 `PATH` 中的 `node` 运行。 | | **额外参数** |，在代理命令后追加。通常为空。 | | **自动包含资产** | ✓（ | | **最大蓝图摘要字符** | `8000`（默认） | | **请求超时秒** | `300`（默认，`0` 禁用） | | **启用 MCP 服务器** | ✓（ | | **MCP 服务器端口** | `47777`（默认） | | **开发者模式 ☐（默认）。向代理公开 `propose_missing_tool` 流。还要求插件的 `Source/UAgent/Tools/` 目录可切换需要重启编辑器。参见 [TOOLS.md →（受限）](.md#developer-gated)。 | | **记录代理 JSON** | 默认）。记录通过传输的每个 ACP JSON-RPC 行（输出日志中的 `LogUAgent`）。对于调试问题很有用。立即生效 — 无需重启。 | 和模型从聊天底部的下拉菜单中选择（不在中），并在 `EditorPerProjectUserSettings.ini` 下按用户保存，以便选择不会到项目的共享配置中。 ### 首次运行 1. 在 UE5 编辑器中项目。 2. → **UAgent**。 3. 状态标签应通过 *starting → initializing → creating session → ready* 移动。 4. 在输入中键入一个问题。按 Enter 发送（Shift+Enter 换行）。 如果启动失败，请检查 **窗口 → 开发者工具 → 输出日志**，并按 `LogUAgent` — 适配器的 stderr输出到那里。