> 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).

# 导出诊断日志

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

Convai 编辑器窗口包含用于检查插件更新和导出诊断信息的支持工具。使用 **导出日志** 在发布到 Convai 开发者论坛之前，这样你的报告会包含 Unreal Engine 日志、Convai 插件日志、崩溃报告、配置文件和环境详细信息。

### 前提条件

* 已在 Unreal Engine 5.2 或更高版本中安装并启用 Convai Unreal Engine 插件。较早版本的 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 发布页，或者更新检查服务无法完成请求。

**修复：** 确认你的互联网连接，并允许 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.