NexusFlow

简体中文

English

简体中文

English

主题

常见问题 ​

连接问题 ​

NexusFlow 启动后一直显示未连接？ ​

NexusFlow 与 UE 之间通过 Named Pipe 通信，支持任意启动顺序——无论先启动 NexusFlow 还是先启动 UE 编辑器，双方都会自动发现并建立连接。

如果仍然无法连接，请检查：

  • 版本是否匹配：NexusFlow 桌面应用和 UE 插件的版本必须兼容，请确保两端都更新到最新版本
  • UE 项目中是否已启用 NexusFlow 插件（编辑 > 插件管理器）
  • 是否有防火墙或安全软件阻止了通信
  • 系统中是否运行了多个 NexusFlow 实例

版本匹配

如果近期更新了 NexusFlow 桌面应用，请同时更新 UE 插件到对应版本，避免因版本不匹配导致连接失败。

UE 重启或切换项目后，需要重启 NexusFlow 吗？ ​

不需要。NexusFlow 内置自动重连机制：

  • UE 关闭或切换项目时，连接会暂时断开
  • NexusFlow 会自动等待 UE 重新连接
  • 通常在 UE 完全启动后的几秒内自动恢复

你只需要重启 UE，NexusFlow 会自动处理重连。

AI 模型 ​

添加模型后验证失败？ ​

模型验证会向 AI 服务商发送一个测试请求。验证失败的常见原因：

原因解决方法
API Key 错误或过期检查 Key 是否正确复制，确认有效期
网络无法连接 API检查网络连接，是否需要代理
模型标识错误确认模型名称拼写正确，如 gpt-5.4 而非 gpt54
Custom Provider 配置错误检查 API 地址和通讯协议是否匹配

AI 回复中断或无响应？ ​

如果 AI 回复到一半中断或完全没有响应，可能的原因：

  • 账户余额不足：检查 AI 服务商的账户余额
  • 服务商限流：短时间内请求过多，稍后重试
  • 网络不稳定：AI 回复使用流式传输，网络波动可能导致中断
  • Max Tokens 设置过低：增大 Max Tokens 值（建议至少 4096）

重试方法

AI 中断后，你可以直接重新发送消息或描述 "继续" 来让 AI 接着回复。

使用 Anthropic (Claude) 模型必须设置 Max Tokens？ ​

是的。Anthropic 的 Messages API 要求必须指定 Max Tokens 参数，这是 Anthropic 的接口规范。

  • 在添加 Anthropic 模型时，请务必设置 Max Tokens
  • 建议值：4096 或更高
  • 未设置会导致 API 调用失败

必填项

使用 Anthropic 协议（包括 Custom Provider 选择 Anthropic Messages API 时），Max Tokens 为必填项。详见 设置说明 - AI 模型。

AI 回复的语言与预期不一致？ ​

AI 回复语言可以独立于界面语言设置：

  • 进入 设置 > Agent 配置 > 回复语言
  • 默认为「跟随界面语言」
  • 如果界面是英文但需要中文回复，在此处手动选择「简体中文」

支持哪些 AI 服务提供商？可以用本地模型吗？ ​

NexusFlow 内置支持以下提供商：

  • OpenAI — GPT 系列
  • Anthropic — Claude 系列
  • Google Gemini — Gemini 系列
  • DeepSeek — DeepSeek 系列
  • 智谱 GLM — GLM 系列
  • MiniMax — MiniMax 系列
  • 通义千问 — Qwen 系列
  • Kimi — Kimi 系列

通过 Custom Provider 可以接入任何兼容 OpenAI / Anthropic / Gemini API 的服务，包括本地部署的模型：

只需在 Custom Provider 中填写 API 地址并选择对应的通讯协议即可。

蓝图操作 ​

AI 正在操作蓝图时能中断吗？ ​

文字生成可以中断，工具操作不能中断。

  • ✅ AI 正在生成文字回复时 → 可以点击停止按钮中断
  • ❌ AI 正在执行工具操作（如修改蓝图）时 → 会提示「工具正在执行中，无法中断」

需要等待当前工具操作完成后才能进行下一步。

UE 快速菜单点了没有反应？ ​

快速菜单依赖 NexusFlow 与 UE 的连接。如果菜单无响应：

  1. 检查 NexusFlow 是否已启动
  2. 检查侧边栏底部状态栏是否显示 🟢 绿色连接状态
  3. 如果未连接，参考 无法连接 UE 进行排查

关于关卡编辑器工具栏按钮：当 NexusFlow 未运行时，点击该按钮会显示包含下载链接的通知，而非打开侧边栏。这是设计行为——帮助已安装 UE 插件但尚未安装桌面应用的新用户。

前提条件

快速菜单的所有 AI 操作（右键菜单和蓝图工具栏按钮）都需要 NexusFlow 处于已连接状态。

AI 说找不到蓝图节点？ ​

AI 操作蓝图前需要获取当前蓝图的上下文信息。请确认：

  1. 已打开目标蓝图 — 在 UE 中双击打开蓝图资产
  2. UE 连接正常 — 检查状态栏显示绿色连接

上下文信息会自动同步，不需要手动告诉 AI 你在编辑哪个蓝图。如果 AI 仍然找不到节点，尝试重新打开蓝图或在对话中明确描述目标节点。

设置与配置 ​

API Key 安全吗？存储在哪里？ ​

API Key 使用加密存储，保存在本地文件中：

  • 加密文件位置：%APPDATA%/cn.nexusflow.desktop/secrets.enc
  • 设置文件 settings.json 不包含明文 API Key
  • 所有密钥仅保存在本地，不会上传到任何服务器

配置文件在哪里？如何重置设置？ ​

NexusFlow 的配置文件位于：

%APPDATA%/cn.nexusflow.desktop/
├── settings.json    # 设置（模型配置、外观、快捷键等）
├── secrets.enc      # 加密的 API Key
└── logs/            # 日志文件

重置所有设置：删除 %APPDATA%/cn.nexusflow.desktop/ 整个目录，重启 NexusFlow 后会恢复默认设置并重新弹出首次运行向导。

注意

重置设置会清除所有已添加的 AI 模型配置和 API Key，需要重新配置。

修改全局快捷键后没有生效？ ​

全局快捷键修改后需要注册到操作系统。如果没有生效：

  1. 检查是否与其他应用的快捷键冲突
  2. 尝试更换为其他组合键
  3. 重启 NexusFlow 使新快捷键生效

TIP

如果快捷键完全失效，进入 设置 > 快捷键，点击「恢复默认」重置。

性能与兼容性 ​

操作大型蓝图很慢？ ​

操作大型蓝图（节点数量多的蓝图）时，NexusFlow 需要：

  1. 读取蓝图的完整数据
  2. 将数据转换并发送给 AI
  3. AI 分析和生成操作指令
  4. 在 UE 中执行操作

每个步骤都需要时间，蓝图越大耗时越长。这是 Beta 阶段的正常现象，后续版本会持续优化性能。

支持哪些 UE 版本？ ​

NexusFlow 支持以下 UE 版本：

  • ✅ UE 5.6：完整支持
  • ✅ UE 5.7：完整支持
  • ❌ UE 5.5 及更早版本：不支持（需要 ONNX Runtime 1.20+，UE 5.5 内置版本过低）
  • ❌ UE 4.x：不支持

版本要求

NexusFlow 使用 UE 内置的 ONNX Runtime（NNERuntimeORT）进行 RAG 语义搜索。UE 5.6 起才内置兼容版本的 ONNX Runtime。

支持 macOS 吗？ ​

当前仅支持 Windows 10/11。

macOS 版本在规划中，但由于系统级别的权限限制（App Sandbox 对进程间通信的约束），macOS 支持需要额外的适配工作。

更多帮助 ​

如果以上内容没有解决你的问题：