For the complete documentation index, see llms.txt. This page is also available as Markdown.

导出诊断日志

从 Unreal Editor 导出 Convai 诊断信息,并将生成的日志包附加到 Convai Developer Forum 支持请求中。

Convai 编辑器窗口包含用于检查插件更新和导出诊断信息的支持工具。请使用 导出日志 ,然后再在 Convai 开发者论坛发帖,以便你的报告包含 Unreal Engine 日志、Convai 插件日志、崩溃报告、配置文件和环境详细信息。

先决条件

  • Convai Unreal Engine 插件已安装并在 Unreal Engine 5.2 或更高版本中启用。较早版本的 Unreal Engine 5 不提供完整的 Convai 编辑器窗口 UI。

  • Convai 编辑器窗口可从 窗口 > Convai > 打开 Convai 编辑器Convai 编辑器 工具栏按钮打开。

  • 要与 Convai 支持团队分享的可复现问题、错误消息或支持问题。

检查插件更新

在导出日志之前,请检查是否有更新版本的插件可用。更新检查会将你已安装的插件版本与最新的 GitHub 发布版本进行比较。

1

打开设置菜单

打开 Convai 编辑器窗口,并点击右上角的设置图标。

2

点击“检查更新”

点击 检查更新。Unreal Editor 会在插件检查 GitHub 时显示通知。

3

查看结果

如果有可用更新,通知会显示你当前的版本、可用版本以及发布页面的链接。如果没有可用更新,通知会确认已安装的是当前稳定版本。

导出日志

1

打开 Convai 编辑器窗口

点击 Convai 编辑器 在 Level Editor 工具栏中,或选择 窗口 > Convai > 打开 Convai 编辑器.

2

点击设置图标

点击 ⚙️ 编辑器窗口右上角的图标。下拉菜单会出现,其中有 导出日志检查更新.

3

点击“导出日志”

点击 导出日志 在下拉菜单中。

4

接受隐私声明

会出现一个标题为 导出日志 - 隐私声明 的隐私声明对话框。查看声明并接受后继续。如果你拒绝,导出将被取消。

导出会在后台运行。会出现一条进度通知,其中包含 正在导出日志... 请稍候,我们正在打包你的日志文件。

归档包含的内容

项目
备注

Convai 插件日志

最近 .log 的文件,来自 <ProjectRoot>/Saved/ConvaiLogs/

Unreal Engine 日志

最近 .log 的文件,来自 <ProjectRoot>/Saved/Logs/

崩溃报告

.log, .txt,和 .xml 位于以下目录下最多五个最近文件夹中的文件: <ProjectRoot>/Saved/Crashes/

配置文件

所选项目和插件配置文件,包括 DefaultEngine.ini, DefaultGame.ini,和 ConvaiEditorSettings.ini (如存在)

项目信息

项目名称、Unreal Engine 版本、插件元数据和项目配置

系统信息

操作系统、CPU、GPU、RAM、屏幕、区域设置和语言信息

网络和性能数据

网络适配器信息、会话运行时间、FPS 和内存使用统计

导出包是在你的本地机器上创建的,不会自动上传。在附加文件之前,请先审核你的支持帖子。

在开发者论坛上分享该包

打开 Convai 编辑器窗口,点击 支持,然后选择 Convai 开发者论坛。创建论坛帖子时,请包含:

  • Unreal Engine 版本和 Convai 插件版本。

  • 你期望发生什么。

  • 实际发生了什么。

  • 能重现该问题的最少步骤。

  • Unreal Editor 中显示的任何准确的 Output Log 消息。

  • 来自 导出日志.

故障排除

导出失败

症状: 进度通知会变为 日志导出失败.

原因: 导出器无法创建包文件夹、复制收集到的文件、写入清单、写入元数据或创建归档。

修复: 请确保项目的 Saved/ 目录可写,然后再次尝试导出。如果问题仍然存在,请手动从 <ProjectRoot>/Saved/Logs/ 收集日志并将其附加到你的支持工单中。

验证: 通知会变为 日志导出成功 ,并且文件资源管理器会打开到包位置。

未找到日志文件

症状: 导出失败,错误为 未找到可导出的日志文件.

原因: 导出器未找到可从最近的 Convai 日志、Unreal Engine 日志、崩溃报告或所选配置文件中打包的文件。

修复: 在编辑器中将该问题重现一次,如有需要请保存项目以便生成配置文件,然后运行 导出日志 再次。

验证: 生成的包包含日志文件和元数据。

更新检查失败

症状: 通知显示 更新检查失败.

原因: Unreal Editor 无法连接到 GitHub Releases,或者更新检查服务无法完成请求。

修复: 确认你的互联网连接,并允许 Unreal Editor 通过 HTTPS 访问 GitHub。重试 检查更新.

验证: 通知要么报告有可用更新,要么确认已安装版本为最新。

下一步

故障排除诊断与日志导出

最后更新于

这有帮助吗?