#常见问题

#启动问题

服务启动失败，无法打开插件页面 关闭插件UI后，在UE5菜单栏：UECopilot->RestartServer 尝试重新启动服务器。再尝试打开插件页面。 如果还是没有反应可以尝试重启UE5编辑器

#聊天中断或者停止

在对话过程中，如果偶遇对话非正常中断或者停止，可以在输入框填入 “继续” 来恢复当前对话（每个会话都有历史记忆，如果有新任务请重新创建对话任务）。

#插件更新

1、在UE启动器删除旧版本插件

2、在插件对话设置中点击“重置配置”按钮(如果遇到插件大版本更新可能会出现之前的聊天记录和配置错误问题请参考下面操作修复)

#操作问题

Q: 操作蓝图后没有生效

1. 检查操作返回的 JSON 中 saved 字段是否为 true
2. 在编辑器中手动保存资产（Ctrl+S）
3. 重新打开蓝图图查看变更

Q: 蓝图编译出现错误 4. 使用 validate_blueprint 工具查看具体错误信息 5. 如果有快照，使用 restore_graph 恢复 6. 或在编辑器中使用 Ctrl+Z 撤销

Q: AI 无法找到指定的蓝图 7. 确保蓝图名称正确（区分大小写） 8. 使用 list_blueprints 工具查看所有可用蓝图 9. Level Blueprint 需要通过地图名引用

#已知限制

#不支持的场景

1. C++ 代码操作：只能操作蓝图和资产，不能创建或修改 C++ 代码文件
2. 运行时调试：不支持断点、单步执行等调试功能
3. 多用户协作：无并发控制机制，不适合多人同时操作同一蓝图
4. 内容迁移：不支持跨项目的内容迁移
5. 源码控制集成：不直接与 Perforce/Git/SVN 交互
6. 打包构建：不支持打包、烘焙等构建流程
7. 关卡编辑：不直接支持关卡中的 Actor 放置和编辑（计划中）
8. 数据表操作：暂时不支持 DataTable/CurveTable 的编辑
9. Niagara 系统：不支持 Niagara 粒子系统的操作
10. UI/UW 编辑：不支持 Widget Blueprint 的编辑

#安全边界

✅ 可以做的：
   · 读取/创建/修改蓝图资产
   · 读取/创建/修改材质资产
   · 读取/创建/修改动画蓝图
   · 创建结构体和枚举
   · 进行安全快照和恢复
   · 在编辑器中使用 Ctrl+Z 撤销
  
❌ 不应做的：
   · 在无版本控制的情况下批量修改
   · 依赖 AI 完全理解复杂图结构的语义
   · 跳过测试在关键节点上直接使用

⚠️ 需要谨慎的：
   · 修改已有蓝图的父类（可能导致大量断连）
   · 批量重命名/删除资产
   · 修改变量类型（可能断开现有连接）
   · 在动画蓝图状态机中大规模修改

#能力统计总表

#概览数据

#类型支持覆盖

#结语

UECopilot 的目标是让 AI 成为 UE5 开发者的得力副驾——不是替代你的判断力，而是帮助你更快地完成重复性工作、减少人为失误、并在大型项目中保持操作的准确性和可追溯性。

给用户的建议：

• 从小处开始：先在简单的蓝图上试用
• 善用快照：任何重大操作前先做快照
• 渐进式使用：从读取 → 简单修改 → 复杂创建，逐步深入
• 保持反馈：遇到问题请提供详细日志，帮助插件持续改进

UECopilot - 让 Unreal Engine 开发插上 AI 的翅膀