> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/tiao-shi/report-bug.md).

# 报告漏洞

如何报告漏洞，以便其得到审查和修复

如果你在 Creator Hub 中使用 Decentraland SDK 和场景编辑器时遇到任何错误或问题，请在我们的 GitHub 仓库中报告 [这里](https://github.com/decentraland/sdk/issues/new/choose).

## 在报告错误之前

在提交错误报告之前，请确保以下几点：

* 确保你使用的是最新版本的 SDK，以防该问题已经在更新的版本中修复。
* 查看你尝试使用的功能文档，以确认它本应按你的预期运行，而且这并不是误解。
* 排除问题可能是由你的场景构建方式导致的。请参见 [在预览中调试](/creator/content-creator-zh/chang-jing-sdk7/tiao-shi/debug-in-preview.md) 和 [在正式环境中调试](/creator/content-creator-zh/chang-jing-sdk7/tiao-shi/debug-in-prod.md) 获取提示。
* 避免重复。查看 [已知错误列表](https://github.com/orgs/decentraland/projects/20/views/13) 以避免重复提交。如果你有更多信息要补充到已有问题中，请在该问题下添加评论，而不是创建新问题。

## 报告错误

要报告 SDK 的错误，你需要一个 GitHub 账户。请按照以下步骤操作：

1. 访问以下链接： [新问题页面](https://github.com/decentraland/sdk/issues/new/choose)
2. 点击 **开始使用** 旁边的 **错误报告**. ![
](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e570baea44fa2ebc22551edee413d515cc2e965d%2Freport-bug.png?alt=media)
3. 请填写模板中的所有字段。模板会为每个部分提供说明。你能提供的细节越多，我们的开发人员就能越快地识别并解决该问题。
4. 点击 **提交新问题**.

![
](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-fa14673bdfa946c4f579a941396e980e23ce3b77%2Fsubmit-issue.png?alt=media)

如果需要澄清或更多信息，开发人员可能会在你的工单上提出后续问题。你会收到关于错误报告更新的电子邮件通知。

{% hint style="warning" %}
**📔 注意**：对于任何与 SDK 无关的问题，请联系支持团队。要联系我们，请访问此页面 [intercom.decentraland.org](https://intercom.decentraland.org/) 或发送电子邮件至 <hello@decentraland.org>。你也可以在 [Discord](https://decentraland.org/discord/)上找到我们。团队的服务时间为周一至周日，UTC 时间下午 12 点到晚上 9 点，并会尽力尽快回复你。你可以期待在上述时间段内于 Discord 上在 60 分钟内收到回复，通过电子邮件则在 24 小时内收到回复。

你也可以在 [DAO Discord](https://discord.gg/bxHtcMxUs4).
{% endhint %}

**错误报告的其他提示：**

* 为每个错误创建单独的问题。如果你遇到多个问题，请确保为每个问题都创建一个新问题。
* 避免冗长的说明。仅在必要时包含相关的命令行或控制台输出，或场景代码。
* 如果可能，请附上图片或视频。你可以轻松地将它们拖放到问题文本区域中，GitHub 会负责上传和链接。

## 使用 Decentraland Playground

提供能展示问题的代码片段非常有帮助。可复现性至关重要。如果一个错误无法复现，就很难诊断和修复。

你可以在问题文本中粘贴代码片段，但提供代码片段的最佳方式是使用 [Decentraland Playground](https://playground.decentraland.org/)。请按照以下步骤：

1. 在左侧编写你的代码片段，并在右侧面板查看你的场景。
2. 点击 **分享** 按钮，然后将链接粘贴到你的问题报告中。

![
](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-27251378c6274dfa5888c63c4aa0e87d83bafd75%2Fplayground.png?alt=media)

使用 Playground 可以简化问题复现，并确保任何打开链接的人都能看到相同的输出，无论其操作系统、SDK 版本、Node 版本等如何。它也便于快速迭代，以识别受影响的条件并准确定位问题原因。

请尽量让你的示例保持简洁，同时仍能复现该问题。更简单的示例有助于消除关于问题来源的歧义。

{% hint style="warning" %}
**📔 注意**：无法在 Playground 中将资源导入到你的场景中。因此，如果复现该问题需要导入 3D 模型或音频文件，那么在那里将无法显示。
{% endhint %}

## 获取日志

在报告错误时，获取 Decentraland 浏览器的日志通常很有用。

要获取日志，只需打开聊天并输入 `/logs`。这将打开一个包含 Decentraland 浏览器日志的新窗口。请将 `Player.log` 文件附加到你的问题报告中。

## 编辑文档

如果你在文档网站的内容中发现问题，可以提交修改请求。只需滚动到页面底部并点击 **编辑此页面** 按钮。GitHub 会引导你使用这些更改创建拉取请求。基金会团队将审查你的更改，如果认为有用，就会发布它们。

## 功能请求和建议

如果你有新增功能或特性的建议，而不是报告问题，请加入 [Decentraland Discord 服务器](https://dcl.gg/discord) 并在 [Creator Hub 频道](https://discord.com/channels/417796904760639509/1288888172318560326) 中发消息，而不是创建 GitHub Issue。


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/tiao-shi/report-bug.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.