> 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/contributor/contributor-zh/nei-rong/overview.md).

# 概览

你在 Decentraland 虚拟世界中能找到的一切，都托管在一个称为 Catalysts 的分布式服务器网络上，它们（除其他功能外）提供内容 API。客户端通过它们上传和下载内容。

Catalyst 的完整 API 可在 [其自身的参考文档中](https://decentraland.github.io/catalyst-api-specs/)。这里，我们将重点了解内容如何组织，以及如何发现和下载它。

下面提到的所有重要概念都在各自的页面中有进一步说明。

### 文件、实体、指针

Decentraland 的内容系统有三个层级： [文件](https://github.com/decentraland/docs/blob/main/contributor/filesystem.md) 被打包在 [实体](https://github.com/decentraland/docs/blob/main/contributor/entities.md)，并且实体通过 [指针](https://github.com/decentraland/docs/blob/main/contributor/pointers.md).

{% @mermaid/diagram content="flowchart LR
Pointer --> Entity
Entity --> File1\["File 1"]
Entity --> File2\["File 2"]
Entity --> File3\["File 3"]" %}

[文件](https://github.com/decentraland/docs/blob/main/contributor/filesystem.md) 存储在一个类似于 IPFS 的去中心化文件系统中，并在内容服务器之间自动同步。它们由一个根据文件内容计算出的唯一字符串 ID 标识，而且标识符和内容都是 **不可变的**。不存在更新文件这回事。相反，会上传替换文件并删除过期文件。

[实体](https://github.com/decentraland/docs/blob/main/contributor/entities.md) 是文件的原子包，表示世界中的实际内容，例如场景和可穿戴物品。它们至少包含一个文件，称为 *清单*，其中包含总体描述和元数据。与其包含的单个文件一样，它们都是不可变的，并由一个唯一且确定性的字符串标识。所有实体都有一个所有者，所有者持有管理它们所需的私钥。

[指针](https://github.com/decentraland/docs/blob/main/contributor/pointers.md) 是稳定的引用，可解析为某个实体的 ID。当实体被替换时（即所有者上传一个新包，旧包被删除），其中包含的文件和元数据会不同，其标识符也会不同，但指针保持不变，并被重定向到新版本。

### 快照

内容服务器还会托管大型的以换行分隔的 JSON 文件，其中汇总了某一时间点所有活跃实体（即当前由指针引用的实体）的信息。这些文件称为 [快照](https://github.com/decentraland/docs/blob/main/contributor/snapshots.md)，可用于浏览所有可用内容。


---

# 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/contributor/contributor-zh/nei-rong/overview.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.