> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/editor-window/export-diagnostic-logs.md).

# 导出诊断日志

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

### 先决条件

* Convai Unreal Engine 插件已安装并在 Unreal Engine 5.2 或更高版本中启用。较早版本的 Unreal Engine 5 不提供完整的 Convai 编辑器窗口 UI。
* Convai 编辑器窗口可从 **窗口 > Convai > 打开 Convai 编辑器** 或 **Convai 编辑器** 工具栏按钮打开。
* 要与 Convai 支持团队分享的可复现问题、错误消息或支持问题。

### 检查插件更新

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

{% stepper %}
{% step %}

#### 打开设置菜单

打开 Convai 编辑器窗口，并点击右上角的设置图标。
{% endstep %}

{% step %}

#### 点击“检查更新”

点击 **检查更新**。Unreal Editor 会在插件检查 GitHub 时显示通知。
{% endstep %}

{% step %}

#### 查看结果

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

### 导出日志

{% stepper %}
{% step %}

#### 打开 Convai 编辑器窗口

点击 **Convai 编辑器** 在 Level Editor 工具栏中，或选择 **窗口 > Convai > 打开 Convai 编辑器**.
{% endstep %}

{% step %}

#### 点击设置图标

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

{% step %}

#### 点击“导出日志”

点击 **导出日志** 在下拉菜单中。
{% endstep %}

{% step %}

#### 接受隐私声明

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

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

{% hint style="success" %}
导出完成后，通知会变为 **日志导出成功** 并显示文件数量和归档大小。系统文件资源管理器会打开到生成的包位置。如果没有打开，请检查 `<ProjectRoot>/Saved/ConvaiLogExports/`.
{% endhint %}

### 归档包含的内容

| 项目               | 备注                                                                                       |
| ---------------- | ---------------------------------------------------------------------------------------- |
| 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 和内存使用统计                                                               |

{% hint style="info" %}
导出包是在你的本地机器上创建的，不会自动上传。在附加文件之前，请先审核你的支持帖子。
{% endhint %}

### 在开发者论坛上分享该包

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

* Unreal Engine 版本和 Convai 插件版本。
* 你期望发生什么。
* 实际发生了什么。
* 能重现该问题的最少步骤。
* Unreal Editor 中显示的任何准确的 Output Log 消息。
* 来自 **导出日志**.

### 故障排除

#### 导出失败

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

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

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

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

#### 未找到日志文件

**症状：** 导出失败，错误为 `未找到可导出的日志文件`.

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

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

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

#### 更新检查失败

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

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

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

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

### 下一步

{% content-ref url="/pages/2c318643919de48c794a1f4b6b1eb25b6e0ed166" %}
[故障排查](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting.md)
{% endcontent-ref %}

{% content-ref url="/pages/76a35097e5aafc7db6e701235cba4c330c02ad3a" %}
[诊断和日志导出](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/diagnostics-and-log-export.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/editor-window/export-diagnostic-logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.