> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/zh/bang-zhu/report-a-bug.md).

# 报告错误

采集 GitBook 支持团队调查错误所需的网络和控制台信息

通过应用中的支持小组件报告错误，或发送电子邮件至 <support@gitbook.com>，并尽可能详细地说明您遇到问题的过程。

对于某些问题，支持团队会要求您提供 **HAR 捕获文件** （HTTP Archive）。它会记录浏览器与 GitBook 应用之间的请求和响应，以便团队进一步调查。请同时提供 HAR 文件和控制台日志：

{% tabs %}
{% tab title="Chrome" %}

1. 在 Chrome 中，前往 GitBook 上出现问题的页面。
2. 点击 **⋮** （位于浏览器窗口右上角），然后选择 **更多工具 → 开发者工具**.
3. 点击 **网络** 标签页，并勾选 **保留日志**.
4. 确认“网络”标签页左上角显示红色圆点，表示已开始录制。如果圆点为黑色，请点击它以开始录制。
5. 刷新页面并重现问题。
6. 点击“网络”标签页工具栏中的下载图标（↓），将所有请求保存为 HAR 文件。
7. 点击 **控制台** 标签页，在控制台任意位置点击右键，然后点击 **另存为…**。将文件命名为 `Chrome-console.log`.
8. 回复您的支持请求，并附上这两个文件的共享链接。
   {% endtab %}

{% tab title="Firefox" %}

1. 在 Firefox 中，前往 GitBook 上出现问题的页面。
2. 点击右上角的 Firefox 菜单，然后选择 **Web 开发者 → 网络**.
3. 点击 **网络** 标签页，并勾选 **保留日志**.
4. 刷新页面，并在捕获过程中重现问题。
5. 在活动窗格的任意行上点击右键，然后点击 **将全部内容另存为 HAR**.
6. 点击 **控制台** 标签页，在任意行上点击右键，然后点击 **全选**。将内容粘贴到一个名为 `console-log.txt`.
7. 回复您的支持请求，并附上这两个文件的共享链接。
   {% endtab %}

{% tab title="Safari" %}

1. 在 Safari 中，前往 GitBook 上出现问题的页面。
2. 在菜单栏中，点击 **开发** 并选择 **显示网页检查器**.
3. 点击 **控制台** 标签页并勾选 **保留日志**，然后转到 **网络** 标签页。
4. 刷新页面，并在捕获过程中重现问题。
5. 右键点击活动窗格中的任意一行，然后点击 **导出 HAR**.
6. 在 **控制台** 标签页中，右键点击任意一行，然后点击 **全选**。将内容粘贴到名为 `console-log.txt`.
7. 回复您的支持请求，并附上这两个文件的共享链接。
   {% endtab %}

{% tab title="Edge" %}

1. 在 Edge 中，前往遇到问题的 GitBook 页面。
2. 点击右上角的 Edge 菜单（⋮），然后选择 **开发人员工具**.
3. 点击 **网络** 标签页，并清除 **导航时的条目** 选项（带红色 X 的蓝色箭头）。
4. 确认绿色的播放按钮（**开始性能分析会话**）处于选中状态 — 这表示正在捕获。
5. 刷新页面并重现问题。
6. 点击 **导出为 HAR** 图标（软盘图标）。
7. 在 **控制台** 标签页中，右键点击任意一行，然后点击 **全部复制**。将内容粘贴到名为 `console-log.txt`.
8. 回复您的支持请求，并附上这两个文件的共享链接。
   {% endtab %}
   {% endtabs %}


---

# 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://gitbook.com/docs/documentation/zh/bang-zhu/report-a-bug.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.
